ElementHandle (jvppeteer 3.4.0 API)

java.lang.Object
- com.ruiyun.jvppeteer.api.core.JSHandle
- - com.ruiyun.jvppeteer.api.core.ElementHandle

直接已知子类:: BidiElementHandle, CdpElementHandle

public abstract class ElementHandle
extends JSHandle

字段概要

字段
限定符和类型字段和说明

protected JSHandle handle

protected ElementHandle isolatedHandle

protected static org.slf4j.Logger LOGGER

字段
限定符和类型	字段和说明
`protected JSHandle`	`handle`
`protected ElementHandle`	`isolatedHandle`
`protected static org.slf4j.Logger`	`LOGGER`

构造器概要

构造器
构造器和说明

ElementHandle(JSHandle handle)

构造器
构造器和说明
`ElementHandle(JSHandle handle)`

方法概要

所有方法实例方法抽象方法具体方法
限定符和类型	方法和说明
`ElementHandle`	`$(String selector)` 查询当前元素内与给定选择器匹配的第一个元素。
`List<ElementHandle>`	`$$(String selector)` 查询当前元素内与给定选择器匹配的所有元素。
`Object`	`$$eval(String selector, String pptrFunction)` 对当前元素中找到所有与给定选择器匹配的元素，并运行给定的 JS 函数。
`Object`	`$$eval(String selector, String pptrFunction, List<Object> args)` 对当前元素中找到所有与给定选择器匹配的元素，并运行给定的 JS 函数。
`Object`	`$eval(String selector, String pptrFunction)` 在当前元素中找到指定选择器的第一个元素，并运行给定的 JS 函数。
`Object`	`$eval(String selector, String pptrFunction, List<Object> args)` 在当前元素中找到指定选择器的第一个元素，并运行给定的 JS 函数。
`protected ElementHandle`	`adoptIsolatedHandle()` 获取隔离的ElementHandle,确保返回的ElementHandle对应PUPPETEER_WORLD类型的IsolatedWorld。
`<T> T`	`adoptResult(T isolatedResult)` 转换由隔离的isolatedHandle执行的结果，转为当前elementHandle的结果
`ElementHandle`	`asElement()` 将 JSHandle 转成 ElementHandle 的方法如果对象是 JSHandle 返回 null,如果对象是 ElementHandle，返回当前对象
`protected void`	`assertConnectedElement()`
`abstract void`	`autofill(AutofillData data)` 如果该元素是表单输入，则可以使用 ElementHandle.autofill() 来测试表单是否与浏览器的自动填充实现兼容。
`abstract int`	`backendNodeId()` When connected using Chrome DevTools Protocol, it returns a DOM.BackendNodeId for the element.
`BoundingBox`	`boundingBox()` 此方法返回元素的边界框（相对于主框架），如果元素是不是布局的一部分，则返回 null（例如：display: none).
`BoxModel`	`boxModel()` 此方法返回元素的框，如果元素是不是布局的一部分，则返回 null（例如：display: none）。
`void`	`click()` 如果需要，此方法将元素滚动到视图中，然后使用 Page.mouse 单击元素的中心。
`void`	`click(ClickOptions options)` 如果需要，此方法将元素滚动到视图中，然后使用 Page.mouse 单击元素的中心。
`Point`	`clickablePoint()` 返回元素内的中点，除非提供了特定的偏移量。
`Point`	`clickablePoint(Offset offset)` 返回元素内的中点，除非提供了特定的偏移量。
`abstract Frame`	`contentFrame()` 解析与元素关联的框架（如果有）。
`void`	`dispose()` 释放当前对象当页面被重新导航或者关闭，ElementHandles 会被自动处理。
`boolean`	`disposed()` 当前对象是否已经释放
`DragData`	`drag(ElementHandle target)` 将当前元素拖动到目标元素上
`DragData`	`drag(Point point)` 将当前元素拖动到指定位置
`Object`	`evaluate(String pptrFunction)` 使用当前对象作为第一个参数来执行给定的 JS 函数。
`Object`	`evaluate(String pptrFunction, List<Object> args)` 使用当前对象作为第一个参数来执行给定的 JS 函数。
`JSHandle`	`evaluateHandle(String pptrFunction)` 使用当前对象作为第一个参数来执行给定的 JS 函数。
`JSHandle`	`evaluateHandle(String pptrFunction, List<Object> args)` 使用当前对象作为第一个参数来执行给定的 JS 函数。
`void`	`focus()` 对元素调用 focus。
`abstract Frame`	`frame()` 与当前对象对应的 Frame
`Map<String,JSHandle>`	`getProperties()` 获取表示当前对象属性的句柄映射。
`JSHandle`	`getProperty(String propertyName)` 获取表示当前对象属性的句柄映射。
`void`	`hover()` 如果需要，此方法将元素滚动到视图中，然后使用 Page.mouse 将鼠标悬停在元素的中心上。
`String`	`id()` 返回当前对象的 remoteObject 对象的id
`boolean`	`isHidden()` 当前元素是否隐藏
`boolean`	`isIntersectingViewport()` 如果元素在当前视口中可见，则解析为 true。
`boolean`	`isIntersectingViewport(int threshold)` 如果元素在当前视口中可见，则解析为 true。
`boolean`	`isVisible()` 当前元素是否可见
`Object`	`jsonValue()` 表示引用对象的可序列化部分的普通对象
`void`	`press(String key)` 聚焦元素，然后使用 Keyboard.down() 和 Keyboard.up()。
`void`	`press(String key, KeyPressOptions options)` 聚焦元素，然后使用 Keyboard.down() 和 Keyboard.up()。
`abstract List<ElementHandle>`	`queryAXTree(String name, String role)`
`RemoteObject`	`remoteObject()` 提供对支持当前对象的 Protocol.Runtime.RemoteObject 的访问。
`String`	`screenshot(ElementScreenshotOptions options)` 如果需要，此方法将元素滚动到视图中，然后使用 Page.screenshot() 截取元素的屏幕截图。
`String`	`screenshot(String path)`
`void`	`scrollIntoView()` 将当前元素滚动到视图中。
`protected void`	`scrollIntoViewIfNeeded()`
`List<String>`	`select(List<String> values)` 根据给定的值列表来选择元素，并返回选中的值列表该方法通过在浏览器环境中执行一段JavaScript代码来实现对HTML选择框的操作包括单选和多选情况的处理，并确保触发相应的输入和变化事件
`void`	`tap()` 点击元素，如果元素不可见，则滚动到可见。
`ElementHandle`	`toElement(String tagName)` 将当前句柄转换为给定的元素类型。
`String`	`toString()` 返回 JSHandle 的字符串表示形式。
`void`	`touchEnd()` 结束触摸元素
`void`	`touchMove()` 此方法在需要时将元素滚动到视图中，然后将触摸移动到元素的中心。
`void`	`touchStart()` 此方法在需要时将元素滚动到视图中，然后在元素的中心启动触摸。
`void`	`type(String text)` 聚焦元素，然后为文本中的每个字符发送 keydown、keypress/input 和 keyup 事件。
`void`	`type(String text, long delay)` 聚焦元素，然后为文本中的每个字符发送 keydown、keypress/input 和 keyup 事件。
`abstract void`	`uploadFile(List<String> filePaths)` 上传文件方法该方法负责将提供的文件路径列表上传到特定的输入元素它首先确定输入元素是否支持多文件上传，然后验证文件路径列表的大小是否符合上传条件接着检查每个文件路径是否可读，如果不可读，则抛出异常当文件路径列表为空时，该方法通过评估一段脚本来更新输入元素的files属性以模拟用户操作,当列表不为空时，它会通过DOM API设置文件输入元素的文件列表
`ElementHandle`	`waitForSelector(String selector, WaitForSelectorOptions options)` 等待直到指定的选择器匹配的元素满足某些条件（可见、隐藏或存在）.

从类继承的方法 com.ruiyun.jvppeteer.api.core.JSHandle
realm

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- 字段详细资料
  - LOGGER
```
protected static final org.slf4j.Logger LOGGER
```
  - isolatedHandle
```
protected volatile ElementHandle isolatedHandle
```
  - handle
```
protected final JSHandle handle
```
- 构造器详细资料
  - ElementHandle
```
public ElementHandle(JSHandle handle)
```
- 方法详细资料
  - adoptIsolatedHandle
```
protected ElementHandle adoptIsolatedHandle()
                                     throws com.fasterxml.jackson.core.JsonProcessingException
```
    获取隔离的ElementHandle,确保返回的ElementHandle对应PUPPETEER_WORLD类型的IsolatedWorld。
    当当前句柄在其frame的隔离realm中时，直接返回自身否则，如果尚未创建隔离句柄，则在同步块中创建隔离句柄这确保了在多线程环境下，isolatedHandle的创建是线程安全的
    
    返回:
    
    当前句柄或其隔离句柄
    
    抛出:
    
    com.fasterxml.jackson.core.JsonProcessingException - 如果转换过程出现错误
  - adoptResult
```
public <T> T adoptResult(T isolatedResult)
                  throws com.fasterxml.jackson.core.JsonProcessingException
```
    转换由隔离的isolatedHandle执行的结果，转为当前elementHandle的结果
    
    参数:
    
    isolatedResult - isolatedHandle执行的结果
    
    返回:
    
    T
    
    抛出:
    
    com.fasterxml.jackson.core.JsonProcessingException - 序列化错误
  - id
```
public String id()
```
    返回当前对象的 remoteObject 对象的id
    
    指定者:
    
    id 在类中 JSHandle
    
    返回:
    
    当前对象的 remoteObject 对象的id
  - disposed
```
public boolean disposed()
```
    当前对象是否已经释放
    
    指定者:
    
    disposed 在类中 JSHandle
    
    返回:
    
    true 代表释放
  - getProperty
```
public JSHandle getProperty(String propertyName)
                     throws com.fasterxml.jackson.core.JsonProcessingException,
                            EvaluateException
```
    获取表示当前对象属性的句柄映射。
    
    覆盖:
    
    getProperty 在类中 JSHandle
    
    返回:
    
    返回 JSHandle 的实例
    
    抛出:
    
    com.fasterxml.jackson.core.JsonProcessingException - 序列化异常
    
    EvaluateException - 给定函数执行的异常
  - getProperties
```
public Map<String,JSHandle> getProperties()
                                   throws com.fasterxml.jackson.core.JsonProcessingException
```
    获取表示当前对象属性的句柄映射。
    
    覆盖:
    
    getProperties 在类中 JSHandle
    
    返回:
    
    返回 JSHandle 的实例的集合
    
    抛出:
    
    com.fasterxml.jackson.core.JsonProcessingException - 序列化异常
    
    EvaluateException - 给定函数执行的异常
  - evaluate
```
public Object evaluate(String pptrFunction)
                throws com.fasterxml.jackson.core.JsonProcessingException,
                       EvaluateException
```
    使用当前对象作为第一个参数来执行给定的 JS 函数。
    
    覆盖:
    
    evaluate 在类中 JSHandle
    
    参数:
    
    pptrFunction - 给定函数
    
    返回:
    
    给定函数执行的结果
    
    抛出:
    
    com.fasterxml.jackson.core.JsonProcessingException - 序列化异常
    
    EvaluateException - 给定函数执行的异常
  - evaluate
```
public Object evaluate(String pptrFunction,
                       List<Object> args)
                throws com.fasterxml.jackson.core.JsonProcessingException,
                       EvaluateException
```
    使用当前对象作为第一个参数来执行给定的 JS 函数。
    
    覆盖:
    
    evaluate 在类中 JSHandle
    
    参数:
    
    pptrFunction - 给定函数
    
    args - 给定函数的参数，第一个参数是当前对象
    
    返回:
    
    给定函数执行的结果
    
    抛出:
    
    com.fasterxml.jackson.core.JsonProcessingException - 序列化异常
    
    EvaluateException - 给定函数执行的异常
  - evaluateHandle
```
public JSHandle evaluateHandle(String pptrFunction)
                        throws com.fasterxml.jackson.core.JsonProcessingException,
                               EvaluateException
```
    使用当前对象作为第一个参数来执行给定的 JS 函数。
    
    覆盖:
    
    evaluateHandle 在类中 JSHandle
    
    参数:
    
    pptrFunction - 给定函数
    
    返回:
    
    返回 JSHandle 的实例
    
    抛出:
    
    com.fasterxml.jackson.core.JsonProcessingException - 序列化异常
    
    EvaluateException - 给定函数执行的异常
  - evaluateHandle
```
public JSHandle evaluateHandle(String pptrFunction,
                               List<Object> args)
                        throws com.fasterxml.jackson.core.JsonProcessingException,
                               EvaluateException
```
    使用当前对象作为第一个参数来执行给定的 JS 函数。
    
    覆盖:
    
    evaluateHandle 在类中 JSHandle
    
    参数:
    
    pptrFunction - 给定函数
    
    args - 给定函数的参数，第一个参数是当前对象
    
    返回:
    
    返回 JSHandle 的实例
    
    抛出:
    
    com.fasterxml.jackson.core.JsonProcessingException - 序列化异常
    
    EvaluateException - 给定函数执行的异常
  - jsonValue
```
public Object jsonValue()
                 throws com.fasterxml.jackson.core.JsonProcessingException,
                        EvaluateException
```
    表示引用对象的可序列化部分的普通对象
    
    指定者:
    
    jsonValue 在类中 JSHandle
    
    返回:
    
    给定函数执行的结果
    
    抛出:
    
    com.fasterxml.jackson.core.JsonProcessingException - 如果对象由于循环而无法序列化，则抛出该异常。
    
    EvaluateException - 给定函数执行的异常
  - toString
```
public String toString()
```
    返回 JSHandle 的字符串表示形式。
    
    指定者:
    
    toString 在类中 JSHandle
    
    返回:
    
    JSHandle 的字符串表示形式。
  - remoteObject
```
public RemoteObject remoteObject()
```
    提供对支持当前对象的 Protocol.Runtime.RemoteObject 的访问。
    
    指定者:
    
    remoteObject 在类中 JSHandle
    
    返回:
    
    当前对象的 Protocol.Runtime.RemoteObject
  - dispose
```
public void dispose()
```
    释放当前对象
    当页面被重新导航或者关闭，ElementHandles 会被自动处理。
    
    指定者:
    
    dispose 在类中 JSHandle
  - asElement
```
public ElementHandle asElement()
```
    将 JSHandle 转成 ElementHandle 的方法
    如果对象是 JSHandle 返回 null,如果对象是 ElementHandle，返回当前对象
    
    指定者:
    
    asElement 在类中 JSHandle
    
    返回:
    
    当前实例
  - frame
```
public abstract Frame frame()
```
    与当前对象对应的 Frame
    
    返回:
    
    Frame实例
  - $
```
public ElementHandle $(String selector)
                throws com.fasterxml.jackson.core.JsonProcessingException,
                       EvaluateException
```
    查询当前元素内与给定选择器匹配的第一个元素。
    
    参数:
    
    selector - 选择器
    
    返回:
    
    与给定选择器匹配的第一个元素
    
    抛出:
    
    com.fasterxml.jackson.core.JsonProcessingException - 序列化异常
    
    EvaluateException - JS函数执行异常
  - $$
```
public List<ElementHandle> $$(String selector)
                       throws com.fasterxml.jackson.core.JsonProcessingException,
                              EvaluateException
```
    查询当前元素内与给定选择器匹配的所有元素。
    
    参数:
    
    selector - 选择器
    
    返回:
    
    与给定选择器匹配的所有元素
    
    抛出:
    
    com.fasterxml.jackson.core.JsonProcessingException - 序列化异常
    
    EvaluateException - JS函数执行异常
  - $eval
```
public Object $eval(String selector,
                    String pptrFunction)
             throws com.fasterxml.jackson.core.JsonProcessingException,
                    EvaluateException
```
    在当前元素中找到指定选择器的第一个元素，并运行给定的 JS 函数。当前对象是给定 JS 函数的第一个参数
    可以用来获取元素内的属性，修改元素属性等
    
    参数:
    
    selector - 在当前元素内查找元素的选择器
    
    pptrFunction - 给定的函数
    
    返回:
    
    找到的第一个元素的ElementHandle
    
    抛出:
    
    com.fasterxml.jackson.core.JsonProcessingException - 当处理JSON时发生错误
    
    EvaluateException - 当页面函数执行失败时抛出异常
  - $eval
```
public Object $eval(String selector,
                    String pptrFunction,
                    List<Object> args)
             throws com.fasterxml.jackson.core.JsonProcessingException,
                    EvaluateException
```
    在当前元素中找到指定选择器的第一个元素，并运行给定的 JS 函数。当前对象是给定 JS 函数的第一个参数
    可以用来获取元素内的属性，修改元素属性等
    
    参数:
    
    selector - 在当前元素内查找元素的选择器
    
    pptrFunction - 给定的 JS 函数
    
    args - pptrFunction 的参数，如果有的话
    
    返回:
    
    找到的第一个元素的ElementHandle
    
    抛出:
    
    com.fasterxml.jackson.core.JsonProcessingException - 当处理JSON时发生错误
    
    EvaluateException - 当页面函数执行失败时抛出异常
  - $$eval
```
public Object $$eval(String selector,
                     String pptrFunction)
              throws com.fasterxml.jackson.core.JsonProcessingException,
                     EvaluateException
```
    对当前元素中找到所有与给定选择器匹配的元素，并运行给定的 JS 函数。当前对象是给定 JS 函数的第一个参数
    
    参数:
    
    selector - 在当前元素内查找元素的选择器
    
    pptrFunction - 给定的 JS 函数
    
    返回:
    
    找到的所有元素的 ElementHandle 列表
    
    抛出:
    
    com.fasterxml.jackson.core.JsonProcessingException - 当处理JSON时发生错误
    
    EvaluateException - 当页面函数执行失败时抛出异常
  - $$eval
```
public Object $$eval(String selector,
                     String pptrFunction,
                     List<Object> args)
              throws com.fasterxml.jackson.core.JsonProcessingException,
                     EvaluateException
```
    对当前元素中找到所有与给定选择器匹配的元素，并运行给定的 JS 函数。当前对象是给定 JS 函数的第一个参数
    与 $eval 函数的区别：可以同时对匹配的所有元素进行操作
    
    参数:
    
    selector - 在当前元素内查找元素的选择器
    
    pptrFunction - 给定的 JS 函数
    
    args - pptrFunction 的参数，如果有的话
    
    返回:
    
    找到的所有元素的ElementHandle列表
    
    抛出:
    
    com.fasterxml.jackson.core.JsonProcessingException - 当处理JSON时发生错误
    
    EvaluateException - 当页面函数执行失败时抛出异常
  - isVisible
```
public boolean isVisible()
                  throws com.fasterxml.jackson.core.JsonProcessingException,
                         EvaluateException
```
    当前元素是否可见
    
    返回:
    
    true 代表可见
    
    抛出:
    
    com.fasterxml.jackson.core.JsonProcessingException - 当处理JSON时发生错误
    
    EvaluateException - 当页面函数执行失败时抛出异常
  - isHidden
```
public boolean isHidden()
                 throws com.fasterxml.jackson.core.JsonProcessingException,
                        EvaluateException
```
    当前元素是否隐藏
    
    返回:
    
    true 代表隐藏
    
    抛出:
    
    com.fasterxml.jackson.core.JsonProcessingException - 当处理JSON时发生错误
    
    EvaluateException - 当页面函数执行失败时抛出异常
  - toElement
```
public ElementHandle toElement(String tagName)
                        throws com.fasterxml.jackson.core.JsonProcessingException,
                               EvaluateException
```
    将当前句柄转换为给定的元素类型。
    如果句柄不匹配，则会出现错误。句柄不会被自动处置。
    
    参数:
    
    tagName - 给定的元素类型
    
    返回:
    
    转换后的元素
    
    抛出:
    
    com.fasterxml.jackson.core.JsonProcessingException - 当处理JSON时发生错误
    
    EvaluateException - 当页面函数执行失败时抛出异常
  - contentFrame
```
public abstract Frame contentFrame()
                            throws com.fasterxml.jackson.core.JsonProcessingException
```
    解析与元素关联的框架（如果有）。HTMLIFrameElements 始终存在。
    
    返回:
    
    Frame
    
    抛出:
    
    com.fasterxml.jackson.core.JsonProcessingException
  - clickablePoint
```
public Point clickablePoint()
                     throws com.fasterxml.jackson.core.JsonProcessingException,
                            EvaluateException
```
    返回元素内的中点，除非提供了特定的偏移量。
    
    返回:
    
    元素内的中点
    
    抛出:
    
    com.fasterxml.jackson.core.JsonProcessingException - 当处理JSON时发生错误
    
    EvaluateException - 当页面函数执行失败时抛出异常
  - clickablePoint
```
public Point clickablePoint(Offset offset)
                     throws com.fasterxml.jackson.core.JsonProcessingException,
                            EvaluateException
```
    返回元素内的中点，除非提供了特定的偏移量。
    
    参数:
    
    offset - 特定的偏移量。
    
    返回:
    
    元素内的中点
    
    抛出:
    
    com.fasterxml.jackson.core.JsonProcessingException - 当处理JSON时发生错误
    
    EvaluateException - 当页面函数执行失败时抛出异常
  - hover
```
public void hover()
           throws com.fasterxml.jackson.core.JsonProcessingException,
                  EvaluateException
```
    如果需要，此方法将元素滚动到视图中，然后使用 Page.mouse 将鼠标悬停在元素的中心上。如果元素与 DOM 分离，该方法会抛出错误。
    
    抛出:
    
    com.fasterxml.jackson.core.JsonProcessingException - 当处理JSON时发生错误
    
    EvaluateException - 当页面函数执行失败时抛出异常
  - click
```
public void click()
           throws com.fasterxml.jackson.core.JsonProcessingException,
                  EvaluateException
```
    如果需要，此方法将元素滚动到视图中，然后使用 Page.mouse 单击元素的中心。如果元素与 DOM 分离，该方法会抛出错误
    
    抛出:
    
    com.fasterxml.jackson.core.JsonProcessingException - 当处理JSON时发生错误
    
    EvaluateException - 当页面函数执行失败时抛出异常
  - click
```
public void click(ClickOptions options)
           throws com.fasterxml.jackson.core.JsonProcessingException,
                  EvaluateException
```
    如果需要，此方法将元素滚动到视图中，然后使用 Page.mouse 单击元素的中心。如果元素与 DOM 分离，该方法会抛出错误
    
    参数:
    
    options - 可选的点击参数
    
    抛出:
    
    com.fasterxml.jackson.core.JsonProcessingException - 当处理JSON时发生错误
    
    EvaluateException - 当页面函数执行失败时抛出异常
  - drag
```
public DragData drag(ElementHandle target)
              throws com.fasterxml.jackson.core.JsonProcessingException
```
    将当前元素拖动到目标元素上
    
    参数:
    
    target - 目标元素
    
    返回:
    
    当启用拖动拦截时，将返回拖动负载。
    
    抛出:
    
    com.fasterxml.jackson.core.JsonProcessingException - 抛出异常
  - drag
```
public DragData drag(Point point)
              throws com.fasterxml.jackson.core.JsonProcessingException
```
    将当前元素拖动到指定位置
    
    参数:
    
    point - 指定位置
    
    返回:
    
    当启用拖动拦截时，将返回拖动负载。
    
    抛出:
    
    com.fasterxml.jackson.core.JsonProcessingException - 抛出异常
  - select
```
public List<String> select(List<String> values)
                    throws com.fasterxml.jackson.core.JsonProcessingException,
                           EvaluateException
```
    根据给定的值列表来选择元素，并返回选中的值列表该方法通过在浏览器环境中执行一段JavaScript代码来实现对HTML选择框的操作包括单选和多选情况的处理，并确保触发相应的输入和变化事件
    
    参数:
    
    values - 要选中的值的列表
    
    返回:
    
    选中的值的列表
    
    抛出:
    
    com.fasterxml.jackson.core.JsonProcessingException - 如果JavaScript代码序列化失败
    
    EvaluateException - 如果在浏览器环境中执行JavaScript代码失败
  - uploadFile
```
public abstract void uploadFile(List<String> filePaths)
                         throws com.fasterxml.jackson.core.JsonProcessingException,
                                EvaluateException
```
    上传文件方法
    该方法负责将提供的文件路径列表上传到特定的输入元素它首先确定输入元素是否支持多文件上传，然后验证文件路径列表的大小是否符合上传条件接着检查每个文件路径是否可读，如果不可读，则抛出异常
    当文件路径列表为空时，该方法通过评估一段脚本来更新输入元素的files属性以模拟用户操作,当列表不为空时，它会通过DOM API设置文件输入元素的文件列表
    
    参数:
    
    filePaths - 文件路径列表
    
    抛出:
    
    com.fasterxml.jackson.core.JsonProcessingException - 当JSON处理失败时抛出
    
    EvaluateException - 当JavaScript评估失败时抛出
  - queryAXTree
```
public abstract List<ElementHandle> queryAXTree(String name,
                                                String role)
                                         throws com.fasterxml.jackson.core.JsonProcessingException
```
    抛出:
    
    com.fasterxml.jackson.core.JsonProcessingException
  - scrollIntoViewIfNeeded
```
protected void scrollIntoViewIfNeeded()
                               throws com.fasterxml.jackson.core.JsonProcessingException,
                                      EvaluateException
```
    抛出:
    
    com.fasterxml.jackson.core.JsonProcessingException
    
    EvaluateException
  - tap
```
public void tap()
         throws com.fasterxml.jackson.core.JsonProcessingException,
                EvaluateException
```
    点击元素，如果元素不可见，则滚动到可见。
    
    抛出:
    
    com.fasterxml.jackson.core.JsonProcessingException - 如果序列化失败
    
    EvaluateException - 如果执行失败
  - touchStart
```
public void touchStart()
                throws com.fasterxml.jackson.core.JsonProcessingException,
                       EvaluateException
```
    此方法在需要时将元素滚动到视图中，然后在元素的中心启动触摸。
    
    抛出:
    
    com.fasterxml.jackson.core.JsonProcessingException - 如果序列化失败
    
    EvaluateException - 如果执行失败
  - touchMove
```
public void touchMove()
               throws com.fasterxml.jackson.core.JsonProcessingException,
                      EvaluateException
```
    此方法在需要时将元素滚动到视图中，然后将触摸移动到元素的中心。
    
    抛出:
    
    com.fasterxml.jackson.core.JsonProcessingException - 如果序列化失败
    
    EvaluateException - 如果执行失败
  - touchEnd
```
public void touchEnd()
              throws com.fasterxml.jackson.core.JsonProcessingException,
                     EvaluateException
```
    结束触摸元素
    
    抛出:
    
    com.fasterxml.jackson.core.JsonProcessingException - 如果序列化失败
    
    EvaluateException - 如果 JS 函数执行失败
  - focus
```
public void focus()
           throws com.fasterxml.jackson.core.JsonProcessingException,
                  EvaluateException
```
    对元素调用 focus。
    
    抛出:
    
    com.fasterxml.jackson.core.JsonProcessingException - Json解析异常
    
    EvaluateException - 如果 JS 函数执行失败
  - type
```
public void type(String text)
          throws com.fasterxml.jackson.core.JsonProcessingException,
                 EvaluateException
```
    聚焦元素，然后为文本中的每个字符发送 keydown、keypress/input 和 keyup 事件。
    要按特殊键，例如 Control 或 ArrowDown，请使用 ElementHandle.press()。
    
    参数:
    
    text - 发送的文本
    
    抛出:
    
    com.fasterxml.jackson.core.JsonProcessingException - Json解析异常
    
    EvaluateException - 如果 JS 函数执行失败
  - type
```
public void type(String text,
                 long delay)
          throws com.fasterxml.jackson.core.JsonProcessingException,
                 EvaluateException
```
    聚焦元素，然后为文本中的每个字符发送 keydown、keypress/input 和 keyup 事件。
    要按特殊键，例如 Control 或 ArrowDown，请使用 ElementHandle.press()。
    
    参数:
    
    text - 发送的文本
    
    delay - 间隔 delay 毫秒数发送文本的字符数
    
    抛出:
    
    com.fasterxml.jackson.core.JsonProcessingException - Json解析异常
    
    EvaluateException - 如果 JS 函数执行失败
  - press
```
public void press(String key)
           throws com.fasterxml.jackson.core.JsonProcessingException,
                  EvaluateException
```
    聚焦元素，然后使用 Keyboard.down() 和 Keyboard.up()。
    如果 key 是单个字符，并且除了 Shift 之外没有按下修饰键，则还将生成 keypress/input 事件。可以指定 text 选项来强制生成输入事件。
    注意修饰键确实会影响 elementHandle.press。按住 Shift 将以大写形式键入文本。
    
    参数:
    
    key - 要按下的键
    
    抛出:
    
    com.fasterxml.jackson.core.JsonProcessingException
    
    EvaluateException
  - press
```
public void press(String key,
                  KeyPressOptions options)
           throws com.fasterxml.jackson.core.JsonProcessingException,
                  EvaluateException
```
    聚焦元素，然后使用 Keyboard.down() 和 Keyboard.up()。
    
    参数:
    
    key - 要按下的键
    
    options - 选项
    
    抛出:
    
    com.fasterxml.jackson.core.JsonProcessingException
    
    EvaluateException
  - scrollIntoView
```
public void scrollIntoView()
                    throws com.fasterxml.jackson.core.JsonProcessingException,
                           EvaluateException
```
    将当前元素滚动到视图中。此方法通过自动化协议客户端或调用 element.scrollIntoView 方法来实现。它确保元素的中心位置在浏览器视图的中心。
    
    抛出:
    
    com.fasterxml.jackson.core.JsonProcessingException - 当处理JSON数据时发生错误。
    
    EvaluateException - 当执行脚本评估时发生错误。
  - assertConnectedElement
```
protected void assertConnectedElement()
                               throws com.fasterxml.jackson.core.JsonProcessingException,
                                      EvaluateException
```
    抛出:
    
    com.fasterxml.jackson.core.JsonProcessingException
    
    EvaluateException
  - isIntersectingViewport
```
public boolean isIntersectingViewport(int threshold)
                               throws com.fasterxml.jackson.core.JsonProcessingException,
                                      EvaluateException
```
    如果元素在当前视口中可见，则解析为 true。如果一个元素是 SVG，我们会检查 svg 所有者元素是否在视口中。参见说明。
    
    参数:
    
    threshold - 0（无交叉）和 1（完全交叉）之间交叉的阈值。默认为 1。
    
    返回:
    
    返回元素在当前视口中是否可见
    
    抛出:
    
    com.fasterxml.jackson.core.JsonProcessingException - Json解析异常
    
    EvaluateException - 评估异常
  - isIntersectingViewport
```
public boolean isIntersectingViewport()
                               throws com.fasterxml.jackson.core.JsonProcessingException,
                                      EvaluateException
```
    如果元素在当前视口中可见，则解析为 true。如果一个元素是 SVG，我们会检查 svg 所有者元素是否在视口中。参见说明。
    
    返回:
    
    返回元素在当前视口中是否可见
    
    抛出:
    
    com.fasterxml.jackson.core.JsonProcessingException - Json解析异常
    
    EvaluateException - 评估异常
  - autofill
```
public abstract void autofill(AutofillData data)
```
    如果该元素是表单输入，则可以使用 ElementHandle.autofill() 来测试表单是否与浏览器的自动填充实现兼容。如果无法自动填写表单，则会引发错误。
    目前，仅支持自动填充信用卡信息，并且在 Chrome 中仅支持新的 headless 和 headful 模式。
    
    参数:
    
    data - 自动填写表单数据
  - boundingBox
```
public BoundingBox boundingBox()
                        throws com.fasterxml.jackson.core.JsonProcessingException,
                               EvaluateException
```
    此方法返回元素的边界框（相对于主框架），如果元素是不是布局的一部分，则返回 null（例如：display: none).
    
    返回:
    
    元素的边界框
    
    抛出:
    
    com.fasterxml.jackson.core.JsonProcessingException - 当处理JSON时发生错误
    
    EvaluateException - 当页面函数执行失败时抛出异常
  - boxModel
```
public BoxModel boxModel()
                  throws com.fasterxml.jackson.core.JsonProcessingException,
                         EvaluateException
```
    此方法返回元素的框，如果元素是不是布局的一部分，则返回 null（例如：display: none）。
    盒子被表示为点数组；每个点都是一个对象 {x, y}。箱点按顺时针顺序排序。
    
    返回:
    
    BoxModel
    
    抛出:
    
    com.fasterxml.jackson.core.JsonProcessingException - 当处理JSON时发生错误
    
    EvaluateException - 当页面函数执行失败时抛出异常
  - screenshot
```
public String screenshot(String path)
                  throws IOException,
                         EvaluateException,
                         ExecutionException,
                         InterruptedException
```
    抛出:
    
    IOException
    
    EvaluateException
    
    ExecutionException
    
    InterruptedException
  - screenshot
```
public String screenshot(ElementScreenshotOptions options)
                  throws IOException,
                         EvaluateException,
                         ExecutionException,
                         InterruptedException
```
    如果需要，此方法将元素滚动到视图中，然后使用 Page.screenshot() 截取元素的屏幕截图。如果元素与 DOM 分离，该方法会抛出错误。
    
    参数:
    
    options - 截图配置
    
    返回:
    
    返回图片路径
    
    抛出:
    
    IOException - IO异常
    
    EvaluateException - 截图异常
    
    ExecutionException
    
    InterruptedException
  - waitForSelector
```
public ElementHandle waitForSelector(String selector,
                                     WaitForSelectorOptions options)
                              throws com.fasterxml.jackson.core.JsonProcessingException
```
    等待直到指定的选择器匹配的元素满足某些条件（可见、隐藏或存在）.
    
    参数:
    
    selector - 选择器字符串，用于选择目标元素.
    
    options - 包含等待条件的选项，如元素可见或隐藏.
    
    返回:
    
    返回匹配选择器的目标元素的句柄.
    
    抛出:
    
    com.fasterxml.jackson.core.JsonProcessingException
  - backendNodeId
```
public abstract int backendNodeId()
```
    When connected using Chrome DevTools Protocol, it returns a DOM.BackendNodeId for the element.

类 ElementHandle

字段概要

构造器概要

方法概要

从类继承的方法 com.ruiyun.jvppeteer.api.core.JSHandle

从类继承的方法 java.lang.Object

字段详细资料

LOGGER

isolatedHandle

handle

构造器详细资料

ElementHandle

方法详细资料

adoptIsolatedHandle

adoptResult

id

disposed

getProperty

getProperties

evaluate

evaluate

evaluateHandle

evaluateHandle

jsonValue

toString

remoteObject

dispose

asElement

frame

$

$$

$eval

$eval

$$eval

$$eval

isVisible

isHidden

toElement

contentFrame

clickablePoint

clickablePoint

hover

click

click

drag

drag

select

uploadFile

queryAXTree

scrollIntoViewIfNeeded

tap

touchStart

touchMove

touchEnd

focus

type

type

press

press

scrollIntoView

assertConnectedElement

isIntersectingViewport

isIntersectingViewport

autofill

boundingBox

boxModel

screenshot

screenshot

waitForSelector

backendNodeId