public abstract class Frame extends EventEmitter<FrameEvents>
| 限定符和类型 | 字段和说明 |
|---|---|
protected Accessibility |
accessibility |
protected ElementHandle |
document |
boolean |
hasStartedLoading |
protected String |
id |
protected String |
name |
protected String |
parentId |
LOGGER| 构造器和说明 |
|---|
Frame() |
| 限定符和类型 | 方法和说明 |
|---|---|
ElementHandle |
$(String selector)
查询框架中与给定选择器匹配的第一个元素。
|
List<ElementHandle> |
$$(String selector)
查询框架中与给定选择器匹配的所有元素。
|
Object |
$$eval(String selector,
String pptrFunction,
List<Object> args)
对与框架中给定选择器匹配的元素数组运行给定 JS 函数。
|
Object |
$eval(String selector,
String pptrFunction,
List<Object> args)
对与框架中给定选择器匹配的第一个元素运行给定 JS 函数。
|
abstract Accessibility |
accessibility() |
ElementHandle |
addScriptTag(FrameAddScriptTagOptions options)
在当前文档中添加一个脚本标签。
|
ElementHandle |
addStyleTag(FrameAddStyleTagOptions options)
向文档头部添加样式标签
该方法用于在HTML文档的头部内插入一个新的样式标签。
|
abstract <FrameType extends Frame> |
childFrames()
子框架数组。
|
void |
clearDocumentHandle()
用来清理已经被释放的 Document 句柄
|
void |
click(String selector,
ClickOptions options)
单击找到的第一个与 selector 匹配的元素。
|
abstract CDPSession |
client()
当前框架的客户端
|
String |
content()
框架的完整 HTML 内容,包括 DOCTYPE。
|
abstract boolean |
detached()
Is`true` if the frame has been detached.
|
boolean |
disposed() |
ElementHandle |
document()
返回当前框架的 Document 对象
|
Object |
evaluate(String pptrFunction)
行为与 Page.evaluate() 相同,只是它在此框架的上下文中运行。
|
Object |
evaluate(String pptrFunction,
EvaluateType type,
List<Object> args)
行为与 Page.evaluate() 相同,只是它在此框架的上下文中运行。
|
Object |
evaluate(String pptrFunction,
List<Object> args)
行为与 Page.evaluate() 相同,只是它在此框架的上下文中运行。
|
JSHandle |
evaluateHandle(String pptrFunction,
List<Object> args)
行为与 Page.evaluateHandle() 相同,只是它在此框架的上下文中运行。
|
static List<JSHandle> |
fastTransposeIteratorHandle(JSHandle iterator,
int size) |
void |
focus(String selector)
聚焦与 selector 匹配的第一个元素。
|
ElementHandle |
frameElement()
返回与此框架相关联的元素
|
abstract Response |
goTo(String url,
GoToOptions options)
将框架或页面导航到给定的 url。
|
void |
hover(String selector)
将指针悬停在与 selector 匹配的第一个元素的中心上
|
String |
id() |
abstract Realm |
isolatedRealm() |
abstract Realm |
mainRealm() |
String |
name()
框架的名字
|
abstract Page |
page()
与框架关联的页面。
|
abstract Frame |
parentFrame()
父框架(如果有)。
|
String |
parentId() |
List<String> |
select(String selector,
List<String> values)
在第一个 select 元素上选择与 selector 匹配的一组值。
|
abstract void |
setContent(String html,
WaitForOptions options)
设置框架的内容
|
void |
setFrameContent(String content)
设置框架的内容
|
void |
tap(String selector)
点击与 selector 匹配的第一个元素。
|
String |
title()
框架的标题。
|
static List<JSHandle> |
transposeIterableHandle(JSHandle list) |
static List<JSHandle> |
transposeIteratorHandle(JSHandle iterator) |
void |
type(String selector,
String text,
long delay)
为文本中的每个字符发送 keydown、keypress/input 和 keyup 事件。
|
abstract String |
url()
框架的 url
|
abstract DeviceRequestPrompt |
waitForDevicePrompt(int timeout)
此方法通常与从 api(如 WebBluetooth)触发 devicerequest 的操作结合使用。
|
JSHandle |
waitForFunction(String pptrFunction,
WaitForSelectorOptions options,
EvaluateType type,
Object... args)
等待 pptrFunction 执行完成
|
abstract Response |
waitForNavigation(WaitForOptions options,
Runnable navigateRunner)
等到导航完成
|
ElementHandle |
waitForSelector(String selector,
WaitForSelectorOptions options)
等待直到指定的选择器匹配的元素满足某些条件(可见、隐藏或存在).
|
disposeSymbol, emit, listenerCount, off, on, once, removeAllListeners, removeListenerprotected volatile String id
protected volatile String parentId
protected Accessibility accessibility
public volatile boolean hasStartedLoading
protected volatile String name
protected ElementHandle document
public abstract Page page()
public abstract Response goTo(String url, GoToOptions options)
url - 将框架导航到的 URL。URL 应包含方案,例如 https://options - 可选的配置等待行为的选项。public abstract Response waitForNavigation(WaitForOptions options, Runnable navigateRunner)
options - 可选的等待导航选项navigateRunner - 一个需要的执行的步骤public abstract CDPSession client()
public abstract Accessibility accessibility()
public abstract Realm mainRealm()
public abstract Realm isolatedRealm()
public ElementHandle document() throws com.fasterxml.jackson.core.JsonProcessingException
com.fasterxml.jackson.core.JsonProcessingException - 序列化异常EvaluateException - 执行 JS 函数异常public void clearDocumentHandle()
public ElementHandle frameElement() throws com.fasterxml.jackson.core.JsonProcessingException
com.fasterxml.jackson.core.JsonProcessingException - 序列化异常EvaluateException - JS 函数执行异常public JSHandle evaluateHandle(String pptrFunction, List<Object> args) throws com.fasterxml.jackson.core.JsonProcessingException
详情请参阅 Page.evaluateHandle()。
pptrFunction - 给定的 JS 函数args - JS 函数的参数com.fasterxml.jackson.core.JsonProcessingException - 序列化异常EvaluateException - JS 函数执行异常public Object evaluate(String pptrFunction, EvaluateType type, List<Object> args) throws com.fasterxml.jackson.core.JsonProcessingException
详情请参阅 Page.evaluate()。
pptrFunction - 给定的 JS 函数type - 指定了 pptrFunction 的类型args - pptrFunction 的参数com.fasterxml.jackson.core.JsonProcessingException - 序列化异常EvaluateException - JS 函数执行异常public Object evaluate(String pptrFunction) throws com.fasterxml.jackson.core.JsonProcessingException
详情请参阅 Page.evaluate()。
pptrFunction - 给定的 JS 函数com.fasterxml.jackson.core.JsonProcessingException - 序列化异常EvaluateException - JS 函数执行异常public Object evaluate(String pptrFunction, List<Object> args) throws com.fasterxml.jackson.core.JsonProcessingException
详情请参阅 Page.evaluate()。
pptrFunction - 给定的 JS 函数args - pptrFunction 的参数com.fasterxml.jackson.core.JsonProcessingException - 序列化异常EvaluateException - JS 函数执行异常public ElementHandle $(String selector) throws com.fasterxml.jackson.core.JsonProcessingException
selector - 选择器com.fasterxml.jackson.core.JsonProcessingException - 序列化异常EvaluateException - JS 函数执行异常public List<ElementHandle> $$(String selector) throws com.fasterxml.jackson.core.JsonProcessingException
selector - 选择器com.fasterxml.jackson.core.JsonProcessingException - 序列化异常EvaluateException - JS 函数执行异常public Object $eval(String selector, String pptrFunction, List<Object> args) throws com.fasterxml.jackson.core.JsonProcessingException
如果给定的函数返回一个 Promise,那么此方法将等待直到 Promise 解析。
selector - 选择器pptrFunction - 给定 JS 函数args - pptrFunction 的参数com.fasterxml.jackson.core.JsonProcessingException - 序列化异常EvaluateException - JS 函数执行异常public Object $$eval(String selector, String pptrFunction, List<Object> args) throws com.fasterxml.jackson.core.JsonProcessingException
如果给定的函数返回一个 Promise,那么此方法将等待直到 Promise 解析。
selector - 选择器pptrFunction - 给定 JS 函数args - pptrFunction 的参数com.fasterxml.jackson.core.JsonProcessingException - 序列化异常EvaluateException - JS 函数执行异常public ElementHandle waitForSelector(String selector, WaitForSelectorOptions options) throws com.fasterxml.jackson.core.JsonProcessingException
selector - 选择器字符串,用于选择目标元素.options - 包含等待条件的选项,如元素可见或隐藏.com.fasterxml.jackson.core.JsonProcessingExceptionpublic JSHandle waitForFunction(String pptrFunction, WaitForSelectorOptions options, EvaluateType type, Object... args) throws ExecutionException, InterruptedException, TimeoutException
pptrFunction - 等待的函数options - 可选配置args - pptrFunction 的参数ExecutionExceptionInterruptedExceptionTimeoutExceptionpublic String content() throws com.fasterxml.jackson.core.JsonProcessingException, EvaluateException
com.fasterxml.jackson.core.JsonProcessingException - 序列化异常EvaluateException - JS 函数执行异常public abstract void setContent(String html, WaitForOptions options) throws com.fasterxml.jackson.core.JsonProcessingException, InterruptedException, ExecutionException
html - 要分配给页面的 HTML 标记。options - (可选的)用于配置超时前多长时间以及何时认为内容设置成功的选项。com.fasterxml.jackson.core.JsonProcessingException - 序列化异常EvaluateException - JS 函数执行异常InterruptedExceptionExecutionExceptionpublic void setFrameContent(String content) throws com.fasterxml.jackson.core.JsonProcessingException
content - 要分配给页面的 HTML 标记。com.fasterxml.jackson.core.JsonProcessingException - 序列化异常EvaluateException - JS 函数执行异常public String name()
public abstract String url()
public abstract Frame parentFrame()
public abstract <FrameType extends Frame> List<FrameType> childFrames()
public abstract boolean detached()
public boolean disposed()
public ElementHandle addScriptTag(FrameAddScriptTagOptions options) throws IOException, EvaluateException
此方法使用提供的选项创建一个脚本标签,可以是通过URL、文件路径或直接通过内容来加载脚本。 它支持异步执行,并处理脚本加载的生命周期事件,如'load'和'error'。
options - 脚本标签的选项,包括URL、路径或内容等。IOException - 当读取脚本文件时发生IO错误。EvaluateException - 当脚本执行失败时抛出。public ElementHandle addStyleTag(FrameAddStyleTagOptions options) throws IOException, EvaluateException
该方法用于在HTML文档的头部内插入一个新的样式标签。它支持通过URL链接到外部样式表, 或者直接包含样式内容。当提供样式文件的路径时,将读取该文件的内容并作为内联样式添加。
options - 样式标签的配置选项,包括url、path或content属性IOException - 当读取样式文件时可能抛出的IO异常EvaluateException - 当在页面上执行JavaScript时发生错误时抛出的异常public void click(String selector, ClickOptions options) throws com.fasterxml.jackson.core.JsonProcessingException, EvaluateException
selector - 选择器options - (可选的)配置com.fasterxml.jackson.core.JsonProcessingException - 序列化异常EvaluateException - JS 函数执行异常public void focus(String selector) throws com.fasterxml.jackson.core.JsonProcessingException, EvaluateException
selector - 选择器com.fasterxml.jackson.core.JsonProcessingException - 序列化异常EvaluateException - JS 函数执行异常public void hover(String selector) throws com.fasterxml.jackson.core.JsonProcessingException, EvaluateException
selector - 选择器com.fasterxml.jackson.core.JsonProcessingException - 序列化异常EvaluateException - JS 函数执行异常public List<String> select(String selector, List<String> values) throws com.fasterxml.jackson.core.JsonProcessingException, EvaluateException
selector - 选择器values - 要选择的值的数组。如果 com.fasterxml.jackson.core.JsonProcessingException - 序列化异常EvaluateException - JS 函数执行异常public void tap(String selector) throws com.fasterxml.jackson.core.JsonProcessingException, EvaluateException
selector - 选择器com.fasterxml.jackson.core.JsonProcessingException - 序列化异常EvaluateException - JS 函数执行异常public void type(String selector, String text, long delay) throws com.fasterxml.jackson.core.JsonProcessingException, EvaluateException
selector - 选择器text - 要输入到元素中的文本delay - 它设置按键之间等待的时间(以毫秒为单位)。默认为 0。com.fasterxml.jackson.core.JsonProcessingException - 序列化异常EvaluateException - JS 函数执行异常public String title() throws com.fasterxml.jackson.core.JsonProcessingException, EvaluateException
com.fasterxml.jackson.core.JsonProcessingException - 序列化异常EvaluateException - JS 函数执行异常public abstract DeviceRequestPrompt waitForDevicePrompt(int timeout)
timeout - 超时时间public static List<JSHandle> transposeIterableHandle(JSHandle list) throws com.fasterxml.jackson.core.JsonProcessingException
com.fasterxml.jackson.core.JsonProcessingExceptionpublic static List<JSHandle> transposeIteratorHandle(JSHandle iterator) throws com.fasterxml.jackson.core.JsonProcessingException, EvaluateException
com.fasterxml.jackson.core.JsonProcessingExceptionEvaluateExceptionpublic static List<JSHandle> fastTransposeIteratorHandle(JSHandle iterator, int size) throws com.fasterxml.jackson.core.JsonProcessingException, EvaluateException
com.fasterxml.jackson.core.JsonProcessingExceptionEvaluateExceptionpublic String id()
public String parentId()
Copyright © 2020–2025. All rights reserved.