Page (jvppeteer 3.4.0 API)

java.lang.Object
- com.ruiyun.jvppeteer.api.core.EventEmitter<PageEvents>
- - com.ruiyun.jvppeteer.api.core.Page

直接已知子类:: BidiPage, CdpPage

public abstract class Page
extends EventEmitter<PageEvents>

字段概要

字段
限定符和类型	字段和说明
`TimeoutSettings`	`_timeoutSettings`
`protected List<String>`	`inflight`
`protected boolean`	`isDragging`
`protected static org.slf4j.Logger`	`LOGGER`
`protected Map<Consumer<Request>,Consumer<Request>>`	`requestHandlers`

构造器概要

构造器
构造器和说明

Page()

构造器
构造器和说明
`Page()`

方法概要

所有方法实例方法抽象方法具体方法已过时的方法
限定符和类型	方法和说明
`protected abstract String`	`_screenshot(ScreenshotOptions options)`
`ElementHandle`	`$(String selector)` 此方法在页面内执行 document.querySelector 查找与选择器匹配的第一个元素,如果没有元素匹配指定选择器，返回值是 null。
`List<ElementHandle>`	`$$(String selector)` 此方法在页面内执行 document.querySelectorAll。
`Object`	`$$eval(String selector, String pptrFunction)` 此方法在页面内执行 Array.from(document.querySelectorAll(selector))，然后把匹配到的元素数组作为第一个参数传给 pptrFunction。
`Object`	`$$eval(String selector, String pptrFunction, List<Object> args)` 此方法在页面内执行 Array.from(document.querySelectorAll(selector))，然后把匹配到的元素数组作为第一个参数传给 pptrFunction。
`Object`	`$eval(String selector, String pptrFunction)` 此方法在页面内执行 document.querySelector，然后把匹配到的元素作为第一个参数传给 pptrFunction。
`Object`	`$eval(String selector, String pptrFunction, List<Object> args)` 此方法在页面内执行 document.querySelector，然后把匹配到的元素作为第一个参数传给 pptrFunction。
`abstract Accessibility`	`accessibility()`
`ElementHandle`	`addScriptTag(FrameAddScriptTagOptions options)` 在当前文档的主要框架中添加脚本标签此方法封装了在当前文档的主要框架中添加一个脚本标签的操作它委托 `Frame.addScriptTag(FrameAddScriptTagOptions)` 方法来执行实际的操作
`ElementHandle`	`addStyleTag(FrameAddStyleTagOptions options)` 将 link rel="stylesheet" 标记添加到具有所需 URL 的页面中，或将 style type="text/css" 标记添加到内容中。
`abstract void`	`authenticate(Credentials credentials)` 为HTTP authentication 提供认证凭据。
`abstract void`	`bringToFront()` 相当于多个tab时，切换到某个tab。
`abstract Browser`	`browser()` 返回页面隶属的浏览器
`abstract BrowserContext`	`browserContext()` 获取页面所属的浏览器上下文。
`void`	`click(String selector)` 此方法找到一个匹配 selector 选择器的元素，如果需要会把此元素滚动到可视，然后通过 page.mouse 点击它。
`void`	`click(String selector, ClickOptions options)`
`void`	`close()` page.close() 在 beforeunload 处理之前默认不执行注意如果 runBeforeUnload 设置为true，可能会弹出一个 beforeunload 对话框。
`abstract void`	`close(boolean runBeforeUnload)`
`String`	`content()` 获取当前页面的内容此方法通过调用 mainFrame 的 content 方法来实现它封装了 mainFrame 的内容获取逻辑，以便在需要时统一处理可能的变化
`protected Double`	`convertPrintParameterToInches(String parameter, LengthUnit lengthUnit)`
`List<Cookie>`	`cookies()` 返回当前页面的cookies
`abstract List<Cookie>`	`cookies(String... urls)` 根据提供的URL列表获取Cookies 如果未指定 URL，则此方法返回当前页面 URL 的 cookie。
`abstract Coverage`	`coverage()`
`abstract CDPSession`	`createCDPSession()` 创建附加到页面的 Chrome Devtools 协议会话。
`abstract void`	`deleteCookie(DeleteCookiesRequest... cookies)` 删除指定的cookies
`void`	`deleteCookie(String... names)` 删除指定名称的cookies 本方法接收一个或多个cookie名称，并创建对应的DeleteCookiesRequest对象列表，然后调用deleteCookie方法删除这些cookies
`void`	`emulate(Device device)` 模拟各种设备打开浏览器所有录制内容均为 WebM 格式，使用 VP9 视频编解码器。
`abstract void`	`emulateCPUThrottling(double factor)` 启用 CPU 限制以模拟慢速 CPU。
`abstract void`	`emulateIdleState(IdleOverridesState.Overrides overrides)` 模拟空闲状态。
`abstract void`	`emulateMediaFeatures(List<MediaFeature> features)` 模拟媒体特征
`abstract void`	`emulateMediaType(MediaType type)` 改变页面的css媒体类型。
`abstract void`	`emulateNetworkConditions(NetworkConditions networkConditions)` 模拟网络条件这不会影响 WebSocket 和 WebRTC PeerConnections（请参阅这里）。
`abstract void`	`emulateTimezone(String timezoneId)` 更改页面的时区，传null将禁用将时区仿真	`abstract void`	`emulateVisionDeficiency(VisionDeficiency type)` 模拟页面上给定的视力障碍,不同视力障碍，截图有不同效果
`Object`	`evaluate(String pptrFunction, Object... args)` 执行一段 JavaScript代码
`JSHandle`	`evaluateHandle(String pptrFunction)` page.evaluate 和 page.evaluateHandle 之间的唯一区别是 evaluateHandle 将返回封装在页内对象中的值`JSHandle`。
`JSHandle`	`evaluateHandle(String pptrFunction, List<Object> args)` 此方法和 page.evaluate 的唯一区别是此方法返回的是页内类型(JSHandle)
`abstract NewDocumentScriptEvaluation`	`evaluateOnNewDocument(String pptrFunction, EvaluateType type, Object... args)` 在新dom产生之际执行给定的javascript 当你的js代码为函数时，type=`EvaluateType.FUNCTION` 当你的js代码为字符串时，type=`EvaluateType.STRING`
`NewDocumentScriptEvaluation`	`evaluateOnNewDocument(String pptrFunction, Object... args)` 在新dom产生之际执行给定的javascript 当你的js代码为函数时，type=`EvaluateType.FUNCTION` 当你的js代码为字符串时，type=`EvaluateType.STRING`
`abstract void`	`exposeFunction(String name, BindingFunction pptrFunction)` 该方法在页面的 window 对象上添加一个名为 name 的函数。
`abstract AwaitableResult<FileChooser>`	`fileChooserWaitFor()` 创建并返回一个可等待的文件选择器结果当需要拦截文件选择器对话框时，此方法将非常有用
`void`	`focus(String selector)` 此方法找到一个匹配selector的元素，并且把焦点给它。
`abstract <T extends Frame> List<T>`	`frames()` 附加到页面的所有框架的数组。
`abstract int`	`getDefaultNavigationTimeout()`
`abstract int`	`getDefaultTimeout()`
`Response`	`goBack()` 此方法导航到历史记录中的上一页
`abstract Response`	`goBack(WaitForOptions options)` 导航到页面历史的前一个页面 options 导航配置，可选值： otimeout 跳转等待时间，单位是毫秒, 默认是30秒, 传 0 表示无限等待。
`Response`	`goForward()`
`abstract Response`	`goForward(WaitForOptions options)` 导航到页面历史的后一个页面。
`Response`	`goTo(String url)` 导航到某个网站以下情况此方法将报错：发生了 SSL 错误 (比如有些自签名的https证书).
`Response`	`goTo(String url, GoToOptions options)` 导航到指定的url 以下情况此方法将报错：发生了 SSL 错误 (比如有些自签名的https证书).
`void`	`hover(String selector)` 此方法找到一个匹配的元素，如果需要会把此元素滚动到可视，然后通过 page.mouse 来hover到元素的中间。
`abstract boolean`	`isClosed()` 表示页面是否被关闭。
`boolean`	`isDragging()`
`abstract boolean`	`isDragInterceptionEnabled()` 已过时。
`abstract boolean`	`isJavaScriptEnabled()`
`abstract boolean`	`isServiceWorkerBypassed()`
`abstract Keyboard`	`keyboard()` 虚拟键盘
`abstract Frame`	`mainFrame()` 页面的主框架。
`abstract Metrics`	`metrics()` 获取性能指标本方法通过向目标客户端发送“Performance.getMetrics”请求来获取当前的性能指标接收到的响应将被转换成GetMetricsResponse对象，然后用于构建并返回一个Metrics对象 Metrics对象: Timestamp ：获取指标样本时的时间戳。
`abstract Mouse`	`mouse()`
`protected ScreenshotClip`	`normalizeRectangle(ScreenshotClip clip)`
`void`	`off(PageEvents type, Consumer<?> handler)` 取消监听
`EventEmitter<PageEvents>`	`on(PageEvents type, Consumer<?> handler)` 监听事件，可用于自定义事件监听,用户监听的事件都是在别的线程中异步执行的
`byte[]`	`pdf(PDFOptions options)` 生成当前页面的pdf格式，带着 pring css media。
`abstract byte[]`	`pdf(PDFOptions options, LengthUnit lengthUnit)` 生成当前页面的pdf格式，带着 pring css media。
`void`	`pdf(String path)` 生成当前页面的pdf格式，带着 pring css media。
`abstract JSHandle`	`queryObjects(JSHandle prototypeHandle)` 此方法遍历js堆栈，找到所有带有指定原型的对象
`Response`	`reload()` 重新加载页面
`abstract Response`	`reload(WaitForOptions options)` 重新加载页面
`abstract void`	`removeExposedFunction(String name)` 该方法从页面的 window 对象中删除先前通过 Page.exposeFunction() 添加的名为 name 的函数。
`abstract void`	`removeScriptToEvaluateOnNewDocument(String identifier)` 删除通过 Page.evaluateOnNewDocument 注入页面的脚本。
`protected ScreenshotClip`	`roundRectangle(ScreenshotClip clip)`
`ScreenRecorder`	`screencast(ScreencastOptions options)` 捕获此 page 的截屏视频。
`String`	`screenshot(ScreenshotOptions options)` 截图备注在OS X上截图需要至少1/6秒。
`String`	`screenshot(String path)` 屏幕截图
`List<String>`	`select(String selector, List<String> values)` 当提供的选择器完成选中后，触发change和input事件如果没有元素匹配指定选择器，将报错。
`abstract void`	`setBypassCSP(boolean enabled)` 切换绕过页面的内容安全策略。
`abstract void`	`setBypassServiceWorker(boolean bypass)` 切换忽略每个请求的 Service Worker。
`abstract void`	`setCacheEnabled(boolean enabled)` 根据启用状态切换忽略每个请求的缓存。
`void`	`setContent(String html)` 给页面设置html
`void`	`setContent(String html, WaitForOptions options)` 给页面设置html
`abstract void`	`setCookie(CookieParam... cookies)`
`abstract void`	`setDefaultNavigationTimeout(int timeout)` 此方法会改变下面几个方法的默认30秒等待时间： $`goTo(String)` $`goTo(String, GoToOptions)` $`goBack(WaitForOptions)` $`goForward(WaitForOptions)` $`reload(WaitForOptions)` $`setContent(String)` $`waitForNavigation()`
`abstract void`	`setDefaultTimeout(int timeout)`
`void`	`setDragging(boolean dragging)`
`abstract void`	`setDragInterception(boolean enabled)` 已过时。
`abstract void`	`setExtraHTTPHeaders(Map<String,String> headers)` 当前页面发起的每个请求都会带上这些请求头注意此方法不保证请求头的顺序
`void`	`setGeolocation(GeolocationOptions options)` 设置页面的地理位置考虑使用 `BrowserContext.overridePermissions(String, WebPermission...)`
`abstract void`	`setJavaScriptEnabled(boolean enabled)` 是否在页面上启用 JavaScript。
`abstract void`	`setOfflineMode(boolean enabled)` 将网络连接设置为离线。
`abstract void`	`setRequestInterception(boolean value)` 启用请求拦截器，会激活 request.abort, request.continue 和 request.respond 方法。
`void`	`setUserAgent(String userAgent)` 给页面设置userAgent
`abstract void`	`setUserAgent(String userAgent, UserAgentMetadata userAgentMetadata)` 给页面设置userAgent
`abstract void`	`setViewport(Viewport viewport)` 如果是一个浏览器多个页面的情况，每个页面都可以有单独的viewport 注意在大部分情况下，改变 viewport 会重新加载页面以设置 isMobile 或者 hasTouch
`void`	`stopScreencast()`
`void`	`tap(String selector)` 此方法找到一个匹配的元素，如果需要会把此元素滚动到视图中，然后通过 page.touchscreen 来点击元素的中间位置如果没有匹配的元素，此方法会报错
`abstract Target`	`target()` 创建此页面的目标。
`String`	`title()` 获取当前主框架的标题该方法通过调用主框架的title方法来获取页面标题如果在处理JSON数据时发生错误,该方法将抛出JsonProcessingException异常
`abstract Touchscreen`	`touchscreen()` 触控屏幕
`abstract Tracing`	`tracing()`
`void`	`type(String selector, String text)` 每个字符输入后都会触发 keydown, keypress/input 和 keyup 事件要点击特殊按键，比如 Control 或 ArrowDown，用 keyboard.press
`void`	`type(String selector, String text, long delay)` 每个字符输入后都会触发 keydown, keypress/input 和 keyup 事件要点击特殊按键，比如 Control 或 ArrowDown，用 keyboard.press
`String`	`url()` 返回页面的地址
`abstract Viewport`	`viewport()` 获取Viewport,Viewport各个参数的含义： width 宽度，单位是像素 height 高度，单位是像素 deviceScaleFactor 定义设备缩放， (类似于 dpr)。
`DeviceRequestPrompt`	`waitForDevicePrompt()` 此方法通常与从 API（例如 WebBluetooth）触发设备请求的操作结合使用。
`DeviceRequestPrompt`	`waitForDevicePrompt(int timeout)` 此方法通常与从 API（例如 WebBluetooth）触发设备请求的操作结合使用。
`Frame`	`waitForFrame(Predicate<Frame> framePredicate)` 等待匹配给定条件的帧出现。
`Frame`	`waitForFrame(String url)` 等待匹配给定条件的帧出现。
`Frame`	`waitForFrame(String url, Predicate<Frame> framePredicate, int timeout)` 等待匹配给定条件的帧出现。
`JSHandle`	`waitForFunction(String pptrFunction)` 等待提供的函数 pptrFunction 在页面上下文中计算时返回真值。
`JSHandle`	`waitForFunction(String pptrFunction, Object... args)` 等待提供的函数 pptrFunction 在页面上下文中计算时返回真值。
`JSHandle`	`waitForFunction(String pptrFunction, WaitForSelectorOptions options, EvaluateType type, Object... args)` 等待提供的函数 pptrFunction 在页面上下文中计算时返回真值。
`JSHandle`	`waitForFunction(String pptrFunction, WaitForSelectorOptions options, Object... args)` 等待提供的函数 pptrFunction 在页面上下文中计算时返回真值。
`Response`	`waitForNavigation()` 此方法在页面跳转到一个新地址或重新加载时解析，如果你的代码会间接引起页面跳转，这个方法比较有用比如你在在代码中使用了Page.click()方法，引起了页面跳转注意通过 History API 改变地址会认为是一次跳转。
`Response`	`waitForNavigation(WaitForOptions options)` 此方法在页面跳转到一个新地址或重新加载时解析，如果你的代码会间接引起页面跳转，这个方法比较有用比如你在在代码中使用了Page.click()方法，引起了页面跳转注意通过 History API 改变地址会认为是一次跳转。
`Response`	`waitForNavigation(WaitForOptions options, Runnable navigateRunner)` 此方法在页面跳转到一个新地址或重新加载时解析，如果你的代码会间接引起页面跳转，这个方法比较有用比如你在在代码中使用了Page.click()方法，引起了页面跳转注意通过 History API 改变地址会认为是一次跳转。
`void`	`waitForNetworkIdle(WaitForNetworkIdleOptions options)`
`Request`	`waitForRequest(String url)` 等到某个请求，url或者predicate只有有一个不为空,默认等待时间是30s
`Request`	`waitForRequest(String url, Predicate<Request> predicate, Integer timeout)` 等到某个请求，url或者predicate只有有一个不为空当url不为空时， type = PageEvaluateType.STRING 当predicate不为空时， type = PageEvaluateType.FUNCTION
`Response`	`waitForResponse(Predicate<Response> predicate)` 等到某个请求,默认等待的时间是30s
`Response`	`waitForResponse(String url)` 等到某个请求,默认等待的时间是30s
`Response`	`waitForResponse(String url, Predicate<Response> predicate)` 等到某个请求，url或者predicate只有有一个不为空,默认等待的时间是30s 当url不为空时， type = PageEvaluateType.STRING 当predicate不为空时， type = PageEvaluateType.FUNCTION
`Response`	`waitForResponse(String url, Predicate<Response> predicate, Integer timeout)` 等到某个请求，url或者predicate只有有一个不为空当url不为空时， type = PageEvaluateType.STRING 当predicate不为空时， type = PageEvaluateType.FUNCTION
`ElementHandle`	`waitForSelector(String selector)` 等待指定的选择器匹配的元素出现在页面中，如果调用此方法时已经有匹配的元素，那么此方法立即返回。
`ElementHandle`	`waitForSelector(String selector, WaitForSelectorOptions options)` 等待指定的选择器匹配的元素出现在页面中，如果调用此方法时已经有匹配的元素，那么此方法立即返回。
`abstract List<WebWorker>`	`workers()` 该方法返回所有与页面关联的 WebWorkers

从类继承的方法 com.ruiyun.jvppeteer.api.core.EventEmitter
disposeSymbol, emit, listenerCount, once, removeAllListeners, removeListener

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

- 字段详细资料
  - LOGGER
```
protected static final org.slf4j.Logger LOGGER
```
  - _timeoutSettings
```
public final TimeoutSettings _timeoutSettings
```
  - requestHandlers
```
protected final Map<Consumer<Request>,Consumer<Request>> requestHandlers
```
  - isDragging
```
protected boolean isDragging
```
  - inflight
```
protected List<String> inflight
```
- 构造器详细资料
  - Page
```
public Page()
```
- 方法详细资料
  - isServiceWorkerBypassed
```
public abstract boolean isServiceWorkerBypassed()
```
  - isDragInterceptionEnabled
```
@Deprecated
public abstract boolean isDragInterceptionEnabled()
```
    已过时。
    
    我们不再支持拦截拖动有效负载。使用 ElementHandle 上的新拖动 API 进行拖动（或仅使用 Page.mouse）。
    
    返回:
    
    如果拖动事件被拦截，则为 true，否则为 false。
  - isJavaScriptEnabled
```
public abstract boolean isJavaScriptEnabled()
```
  - on
```
public EventEmitter<PageEvents> on(PageEvents type,
                                   Consumer<?> handler)
```
    从类复制的说明: EventEmitter
    
    监听事件，可用于自定义事件监听,用户监听的事件都是在别的线程中异步执行的
    
    覆盖:
    
    on 在类中 EventEmitter<PageEvents>
    
    参数:
    
    type - 事件类型
    
    handler - 事件的处理器
    
    返回:
    
    EventEmitter 本身
  - off
```
public void off(PageEvents type,
                Consumer<?> handler)
```
    从类复制的说明: EventEmitter
    
    取消监听
    
    覆盖:
    
    off 在类中 EventEmitter<PageEvents>
    
    参数:
    
    type - 事件类型
    
    handler - 事件的处理器
  - fileChooserWaitFor
```
public abstract AwaitableResult<FileChooser> fileChooserWaitFor()
```
    创建并返回一个可等待的文件选择器结果当需要拦截文件选择器对话框时，此方法将非常有用
    
    返回:
    
    返回一个可等待的文件选择器结果，调用者可以通过这个对象来获取用户选择的文件
  - setGeolocation
```
public void setGeolocation(GeolocationOptions options)
```
    设置页面的地理位置
    考虑使用 BrowserContext.overridePermissions(String, WebPermission...) 授予页面读取其地理位置的权限。
    
    参数:
    
    options - 地理位置具体信息
  - target
```
public abstract Target target()
```
    创建此页面的目标。
    
    返回:
    
    目标
  - browser
```
public abstract Browser browser()
```
    返回页面隶属的浏览器
    
    返回:
    
    浏览器实例
  - browserContext
```
public abstract BrowserContext browserContext()
```
    获取页面所属的浏览器上下文。
    
    返回:
    
    浏览器上下文
  - mainFrame
```
public abstract Frame mainFrame()
```
    页面的主框架。
    
    返回:
    
    主框架
  - createCDPSession
```
public abstract CDPSession createCDPSession()
```
    创建附加到页面的 Chrome Devtools 协议会话。
    
    返回:
    
    CDPSession
  - keyboard
```
public abstract Keyboard keyboard()
```
    虚拟键盘
    
    返回:
    
    虚拟键盘
  - touchscreen
```
public abstract Touchscreen touchscreen()
```
    触控屏幕
    
    返回:
    
    触控屏幕
  - coverage
```
public abstract Coverage coverage()
```
  - tracing
```
public abstract Tracing tracing()
```
  - accessibility
```
public abstract Accessibility accessibility()
```
  - frames
```
public abstract <T extends Frame> List<T> frames()
```
    附加到页面的所有框架的数组。
    
    返回:
    
    iframe标签
  - workers
```
public abstract List<WebWorker> workers()
```
    该方法返回所有与页面关联的 WebWorkers
    
    返回:
    
    WebWorkers
  - setRequestInterception
```
public abstract void setRequestInterception(boolean value)
```
    启用请求拦截器，会激活 request.abort, request.continue 和 request.respond 方法。这提供了修改页面发出的网络请求的功能。
    一旦启用请求拦截，每个请求都将停止，除非它继续，响应或中止
    
    参数:
    
    value - 是否启用请求拦截器
  - setBypassServiceWorker
```
public abstract void setBypassServiceWorker(boolean bypass)
```
    切换忽略每个请求的 Service Worker。
    
    参数:
    
    bypass - 是否忽略
  - setDragInterception
```
@Deprecated
public abstract void setDragInterception(boolean enabled)
```
    已过时。
    
    我们不再支持拦截拖动有效负载。使用 ElementHandle 上的新拖动 API 进行拖动（或仅使用 Page.mouse）
    
    参数:
    
    enabled - 是否启用
  - setOfflineMode
```
public abstract void setOfflineMode(boolean enabled)
```
    将网络连接设置为离线。
    它不会改变 Page.emulateNetworkConditions() 中使用的参数
    
    参数:
    
    enabled - 设置 true, 启用离线模式。
  - emulateNetworkConditions
```
public abstract void emulateNetworkConditions(NetworkConditions networkConditions)
```
    模拟网络条件
    这不会影响 WebSocket 和 WebRTC PeerConnections（请参阅这里）。
    要将页面设置为离线，你可以使用 Page.setOfflineMode()。
    通过导入 PredefinedNetworkConditions 可以使用预定义网络条件列表。
    
    参数:
    
    networkConditions - 传递 null 将禁用网络条件模拟。
  - setDefaultNavigationTimeout
```
public abstract void setDefaultNavigationTimeout(int timeout)
```
    此方法会改变下面几个方法的默认30秒等待时间： $goTo(String) $goTo(String, GoToOptions) $goBack(WaitForOptions) $goForward(WaitForOptions) $reload(WaitForOptions) $setContent(String) $waitForNavigation()
    
    参数:
    
    timeout - 超时时间
  - setDefaultTimeout
```
public abstract void setDefaultTimeout(int timeout)
```
  - getDefaultTimeout
```
public abstract int getDefaultTimeout()
```
  - getDefaultNavigationTimeout
```
public abstract int getDefaultNavigationTimeout()
```
  - $
```
public ElementHandle $(String selector)
                throws com.fasterxml.jackson.core.JsonProcessingException
```
    此方法在页面内执行 document.querySelector
    查找与选择器匹配的第一个元素,如果没有元素匹配指定选择器，返回值是 null。
    
    参数:
    
    selector - 要查询页面的 selector。CSS 选择器可以按原样传递，Puppeteer 特定的选择器语法允许通过 text、a11y 角色和名称、xpath 和跨影子根组合这些查询进行查询。或者，你可以使用前缀 prefix 指定选择器类型。
    
    返回:
    
    匹配的第一个元素
    
    抛出:
    
    com.fasterxml.jackson.core.JsonProcessingException - JSON异常
  - $$
```
public List<ElementHandle> $$(String selector)
                       throws com.fasterxml.jackson.core.JsonProcessingException
```
    此方法在页面内执行 document.querySelectorAll。如果没有元素匹配指定选择器，返回值是 []。
    
    参数:
    
    selector - 选择器
    
    返回:
    
    ElementHandle集合
    
    抛出:
    
    com.fasterxml.jackson.core.JsonProcessingException - JSON异常
  - evaluateHandle
```
public JSHandle evaluateHandle(String pptrFunction,
                               List<Object> args)
                        throws com.fasterxml.jackson.core.JsonProcessingException
```
    此方法和 page.evaluate 的唯一区别是此方法返回的是页内类型(JSHandle)
    
    参数:
    
    pptrFunction - 要在页面实例上下文中执行的方法
    
    args - 要在页面实例上下文中执行的方法的参数
    
    返回:
    
    代表页面元素的实例
    
    抛出:
    
    com.fasterxml.jackson.core.JsonProcessingException - JSON异常
  - evaluateHandle
```
public JSHandle evaluateHandle(String pptrFunction)
                        throws com.fasterxml.jackson.core.JsonProcessingException
```
    page.evaluate 和 page.evaluateHandle 之间的唯一区别是 evaluateHandle 将返回封装在页内对象中的值JSHandle。
    
    参数:
    
    pptrFunction - 要执行的字符串
    
    返回:
    
    JSHandle
    
    抛出:
    
    com.fasterxml.jackson.core.JsonProcessingException - JSON异常
  - queryObjects
```
public abstract JSHandle queryObjects(JSHandle prototypeHandle)
                               throws com.fasterxml.jackson.core.JsonProcessingException
```
    此方法遍历js堆栈，找到所有带有指定原型的对象
    
    参数:
    
    prototypeHandle - 原型处理器
    
    返回:
    
    代表页面元素的一个实例
    
    抛出:
    
    com.fasterxml.jackson.core.JsonProcessingException - Json解析异常
  - $eval
```
public Object $eval(String selector,
                    String pptrFunction,
                    List<Object> args)
             throws com.fasterxml.jackson.core.JsonProcessingException
```
    此方法在页面内执行 document.querySelector，然后把匹配到的元素作为第一个参数传给 pptrFunction。
    
    参数:
    
    selector - 选择器
    
    pptrFunction - 在浏览器实例上下文中要执行的方法
    
    args - 要传给 pptrFunction 的参数。（比如你的代码里生成了一个变量，在页面中执行方法时需要用到，可以通过这个 args 传进去）
    
    返回:
    
    pptrFunction 的返回值
    
    抛出:
    
    com.fasterxml.jackson.core.JsonProcessingException - JSON异常
  - $eval
```
public Object $eval(String selector,
                    String pptrFunction)
             throws com.fasterxml.jackson.core.JsonProcessingException
```
    此方法在页面内执行 document.querySelector，然后把匹配到的元素作为第一个参数传给 pptrFunction。
    
    参数:
    
    selector - 选择器
    
    pptrFunction - 在浏览器实例上下文中要执行的方法
    
    返回:
    
    pptrFunction 的返回值
    
    抛出:
    
    com.fasterxml.jackson.core.JsonProcessingException - JSON异常
  - $$eval
```
public Object $$eval(String selector,
                     String pptrFunction)
              throws com.fasterxml.jackson.core.JsonProcessingException
```
    此方法在页面内执行 Array.from(document.querySelectorAll(selector))，然后把匹配到的元素数组作为第一个参数传给 pptrFunction。
    
    参数:
    
    selector - 一个框架选择器
    
    pptrFunction - 在浏览器实例上下文中要执行的方法
    
    返回:
    
    pptrFunction 的返回值
    
    抛出:
    
    com.fasterxml.jackson.core.JsonProcessingException - JSON异常
  - $$eval
```
public Object $$eval(String selector,
                     String pptrFunction,
                     List<Object> args)
              throws com.fasterxml.jackson.core.JsonProcessingException
```
    此方法在页面内执行 Array.from(document.querySelectorAll(selector))，然后把匹配到的元素数组作为第一个参数传给 pptrFunction。
    
    参数:
    
    selector - 一个框架选择器
    
    pptrFunction - 在浏览器实例上下文中要执行的方法
    
    args - 要传给 pptrFunction 的参数。（比如你的代码里生成了一个变量，在页面中执行方法时需要用到，可以通过这个 args 传进去）
    
    返回:
    
    pptrFunction 的返回值
    
    抛出:
    
    com.fasterxml.jackson.core.JsonProcessingException - JSON异常
  - cookies
```
public List<Cookie> cookies()
                     throws com.fasterxml.jackson.core.JsonProcessingException
```
    返回当前页面的cookies
    
    返回:
    
    cookies
    
    抛出:
    
    com.fasterxml.jackson.core.JsonProcessingException - 如果处理JSON时发生错误
  - cookies
```
public abstract List<Cookie> cookies(String... urls)
```
    根据提供的URL列表获取Cookies
    如果未指定 URL，则此方法返回当前页面 URL 的 cookie。如果指定了 URL，则仅返回这些 URL 的 cookie。
    
    参数:
    
    urls - URL列表，如果没有提供或为null，将使用当前页面的URL
    
    返回:
    
    Cookie对象列表，表示请求的cookies
  - deleteCookie
```
public void deleteCookie(String... names)
```
    删除指定名称的cookies
    本方法接收一个或多个cookie名称，并创建对应的DeleteCookiesRequest对象列表，然后调用deleteCookie方法删除这些cookies
    
    参数:
    
    names - 需要删除的cookie名称列表
  - deleteCookie
```
public abstract void deleteCookie(DeleteCookiesRequest... cookies)
```
    删除指定的cookies
    
    参数:
    
    cookies - 待删除的cookies请求列表，每个元素包含待删除的cookie信息
  - setCookie
```
public abstract void setCookie(CookieParam... cookies)
```
  - addScriptTag
```
public ElementHandle addScriptTag(FrameAddScriptTagOptions options)
                           throws IOException
```
    在当前文档的主要框架中添加脚本标签
    此方法封装了在当前文档的主要框架中添加一个脚本标签的操作它委托 Frame.addScriptTag(FrameAddScriptTagOptions) 方法来执行实际的操作
    
    参数:
    
    options - 脚本标签的配置选项，包含了脚本标签的各类属性如URL、位置等
    
    返回:
    
    返回新添加的脚本标签的元素句柄
    
    抛出:
    
    IOException - 当网络通信失败时抛出此异常
  - addStyleTag
```
public ElementHandle addStyleTag(FrameAddStyleTagOptions options)
                          throws IOException
```
    将 link rel="stylesheet" 标记添加到具有所需 URL 的页面中，或将 style type="text/css" 标记添加到内容中。
    
    参数:
    
    options - link标签
    
    返回:
    
    注入完成的tag标签。当style的onload触发或者代码被注入到frame。
    
    抛出:
    
    IOException - 异常
  - exposeFunction
```
public abstract void exposeFunction(String name,
                                    BindingFunction pptrFunction)
                             throws com.fasterxml.jackson.core.JsonProcessingException
```
    该方法在页面的 window 对象上添加一个名为 name 的函数。
    调用时，该函数会执行 pptrFunction，结果是 pptrFunction 的返回值。
    
    参数:
    
    name - 窗口对象上的函数名称
    
    pptrFunction - 将在 Puppeteer 上下文中调用的回调函数。
    
    抛出:
    
    com.fasterxml.jackson.core.JsonProcessingException - 如果处理JSON时发生错误
  - removeExposedFunction
```
public abstract void removeExposedFunction(String name)
                                    throws com.fasterxml.jackson.core.JsonProcessingException
```
    该方法从页面的 window 对象中删除先前通过 Page.exposeFunction() 添加的名为 name 的函数。
    
    参数:
    
    name - 要删除的函数名称
    
    抛出:
    
    com.fasterxml.jackson.core.JsonProcessingException - 如果处理JSON时发生错误
  - authenticate
```
public abstract void authenticate(Credentials credentials)
```
    为HTTP authentication 提供认证凭据。
    传 null 禁用认证。
    将在后台打开请求拦截以实现身份验证。这可能会影响性能。
    
    参数:
    
    credentials - 验证信息
  - setExtraHTTPHeaders
```
public abstract void setExtraHTTPHeaders(Map<String,String> headers)
```
    当前页面发起的每个请求都会带上这些请求头注意此方法不保证请求头的顺序
    
    参数:
    
    headers - 每个 HTTP 请求都会带上这些请求头。值必须是字符串
  - setUserAgent
```
public void setUserAgent(String userAgent)
```
    给页面设置userAgent
    
    参数:
    
    userAgent - 此页面中使用的特定用户代理
  - setUserAgent
```
public abstract void setUserAgent(String userAgent,
                                  UserAgentMetadata userAgentMetadata)
```
    给页面设置userAgent
    
    参数:
    
    userAgent - 此页面中使用的特定用户代理
  - metrics
```
public abstract Metrics metrics()
                         throws com.fasterxml.jackson.core.JsonProcessingException
```
    获取性能指标
    本方法通过向目标客户端发送“Performance.getMetrics”请求来获取当前的性能指标
    接收到的响应将被转换成GetMetricsResponse对象，然后用于构建并返回一个Metrics对象
    Metrics对象:
    Timestamp ：获取指标样本时的时间戳。 Documents：页面中的文档数。 ¥Documents : Number of documents in the page. Frames：页面中的帧数。 JSEventListeners：页面中的事件数。 Nodes ：页面中 DOM 节点的数量。 LayoutCount：完整或部分页面布局的总数。 RecalcStyleCount：页面样式重新计算的总数。 LayoutDuration：所有页面布局的总持续时间。 RecalcStyleDuration：所有页面样式重新计算的总持续时间。 ScriptDuration ：JavaScript 执行的总持续时间。 TaskDuration ：浏览器执行的所有任务的总持续时间。 JSHeapUsedSize：使用的 JavaScript 堆大小。 JSHeapTotalSize：JavaScript 堆总大小。
    所有时间戳都是单调时间：自过去任意点以来单调增加的时间（以秒为单位）。
    返回:
    
    Metrics对象，包含当前获取到的性能指标
    
    抛出:
    
    com.fasterxml.jackson.core.JsonProcessingException - 处理JSON时抛出异常
  - url
```
public String url()
```
    返回页面的地址
    
    返回:
    
    页面地址
  - content
```
public String content()
               throws com.fasterxml.jackson.core.JsonProcessingException
```
    获取当前页面的内容
    此方法通过调用 mainFrame 的 content 方法来实现它封装了 mainFrame 的内容获取逻辑，以便在需要时统一处理可能的变化
    
    返回:
    
    当前页面的内容
    
    抛出:
    
    com.fasterxml.jackson.core.JsonProcessingException - 如果在处理 JSON 时发生错误
  - setContent
```
public void setContent(String html)
                throws com.fasterxml.jackson.core.JsonProcessingException,
                       InterruptedException,
                       ExecutionException
```
    给页面设置html
    
    参数:
    
    html - 分派给页面的HTML。
    
    抛出:
    
    com.fasterxml.jackson.core.JsonProcessingException - 如果在处理 JSON 时发生错误
    
    InterruptedException
    
    ExecutionException
  - setContent
```
public void setContent(String html,
                       WaitForOptions options)
                throws com.fasterxml.jackson.core.JsonProcessingException,
                       InterruptedException,
                       ExecutionException
```
    给页面设置html
    
    参数:
    
    html - 分派给页面的HTML。
    
    options - timeout 加载资源的超时时间，默认值为30秒，传入0禁用超时. 可以使用 page.setDefaultNavigationTimeout(timeout) 或者 page.setDefaultTimeout(timeout) 方法修改默认值 waitUntil HTML设置成功的标志事件, 默认为 load。如果给定的是一个事件数组，那么当所有事件之后，给定的内容才被认为设置成功。事件可以是： load - load事件触发后，设置HTML内容完成。
    domcontentloaded - DOMContentLoaded 事件触发后，设置HTML内容完成。
    
    networkidle0 - 不再有网络连接时（至少500毫秒之后），设置HTML内容完成。
    
    networkidle2 - 只剩2个网络连接时（至少500毫秒之后），设置HTML内容完成。
    
    抛出:
    
    com.fasterxml.jackson.core.JsonProcessingException - JSON异常
    
    InterruptedException
    
    ExecutionException
  - goTo
```
public Response goTo(String url)
              throws ExecutionException,
                     InterruptedException
```
    导航到某个网站
    以下情况此方法将报错：
    
    发生了 SSL 错误 (比如有些自签名的https证书).
    
    目标地址无效
    
    超时
    
    主页面不能加载
    
    参数:
    
    url - 导航到的地址. 地址应该带有http协议, 比如 https://.
    
    返回:
    
    响应
    
    抛出:
    
    ExecutionException
    
    InterruptedException
  - goTo
```
public Response goTo(String url,
                     GoToOptions options)
              throws ExecutionException,
                     InterruptedException
```
    导航到指定的url
    以下情况此方法将报错：
    发生了 SSL 错误 (比如有些自签名的https证书).
    目标地址无效
    超时
    主页面不能加载
    
    参数:
    
    url - url
    
    options -
    timeout 跳转等待时间，单位是毫秒, 默认是30秒, 传 0 表示无限等待。可以通过page.setDefaultNavigationTimeout(timeout)方法修改默认值
    waitUntil 满足什么条件认为页面跳转完成，默认是 load 事件触发时。指定事件数组，那么所有事件触发后才认为是跳转完成。事件包括：
    load - 页面的load事件触发时
    domcontentloaded - 页面的 DOMContentLoaded 事件触发时
    networkidle0 - 不再有网络连接时触发（至少500毫秒后）
    networkidle2 - 只有2个网络连接时触发（至少500毫秒后）
    referer Referer header value. If provided it will take preference over the referer header value set by page.setExtraHTTPHeaders().
    
    返回:
    
    Response
    
    抛出:
    
    ExecutionException
    
    InterruptedException
  - reload
```
public Response reload()
```
    重新加载页面
  - reload
```
public abstract Response reload(WaitForOptions options)
```
    重新加载页面
    
    参数:
    
    options - 与$goTo(String, GoToOptions)中的options是一样的配置
    
    返回:
    
    响应
  - waitForNavigation
```
public Response waitForNavigation()
```
    此方法在页面跳转到一个新地址或重新加载时解析，如果你的代码会间接引起页面跳转，这个方法比较有用
    比如你在在代码中使用了Page.click()方法，引起了页面跳转注意通过 History API 改变地址会认为是一次跳转。
    
    返回:
    
    响应
  - waitForNavigation
```
public Response waitForNavigation(WaitForOptions options,
                                  Runnable navigateRunner)
```
    此方法在页面跳转到一个新地址或重新加载时解析，如果你的代码会间接引起页面跳转，这个方法比较有用
    比如你在在代码中使用了Page.click()方法，引起了页面跳转注意通过 History API 改变地址会认为是一次跳转。
    
    参数:
    
    options - 可选的等待选项
    
    返回:
    
    响应
  - waitForNavigation
```
public Response waitForNavigation(WaitForOptions options)
```
    此方法在页面跳转到一个新地址或重新加载时解析，如果你的代码会间接引起页面跳转，这个方法比较有用
    比如你在在代码中使用了Page.click()方法，引起了页面跳转注意通过 History API 改变地址会认为是一次跳转。
    
    参数:
    
    options - 可选的等待选项
    
    返回:
    
    响应
  - waitForRequest
```
public Request waitForRequest(String url)
```
    等到某个请求，url或者predicate只有有一个不为空,默认等待时间是30s
    
    参数:
    
    url - 等待的请求
    
    返回:
    
    要等到的请求
  - waitForRequest
```
public Request waitForRequest(String url,
                              Predicate<Request> predicate,
                              Integer timeout)
```
    等到某个请求，url或者predicate只有有一个不为空
    当url不为空时， type = PageEvaluateType.STRING
    
    当predicate不为空时， type = PageEvaluateType.FUNCTION
    
    参数:
    
    url - 等待的请求
    
    predicate - 方法
    
    timeout - 超时时间
    
    返回:
    
    要等到的请求
  - waitForResponse
```
public Response waitForResponse(Predicate<Response> predicate)
```
    等到某个请求,默认等待的时间是30s
    
    参数:
    
    predicate - 判断具体某个请求
    
    返回:
    
    要等到的请求
  - waitForResponse
```
public Response waitForResponse(String url)
```
    等到某个请求,默认等待的时间是30s
    
    参数:
    
    url - 等待的请求
    
    返回:
    
    要等到的请求
  - waitForResponse
```
public Response waitForResponse(String url,
                                Predicate<Response> predicate)
```
    等到某个请求，url或者predicate只有有一个不为空,默认等待的时间是30s
    当url不为空时， type = PageEvaluateType.STRING
    
    当predicate不为空时， type = PageEvaluateType.FUNCTION
    
    参数:
    
    url - 等待的请求
    
    predicate - 方法
    
    返回:
    
    要等到的请求
  - waitForResponse
```
public Response waitForResponse(String url,
                                Predicate<Response> predicate,
                                Integer timeout)
```
    等到某个请求，url或者predicate只有有一个不为空
    当url不为空时， type = PageEvaluateType.STRING
    
    当predicate不为空时， type = PageEvaluateType.FUNCTION
    
    参数:
    
    url - 等待的请求
    
    predicate - 方法
    
    timeout - 超时时间,0 代表无限等待
    
    返回:
    
    要等到的请求
  - waitForNetworkIdle
```
public void waitForNetworkIdle(WaitForNetworkIdleOptions options)
```
  - waitForFrame
```
public Frame waitForFrame(String url)
```
    等待匹配给定条件的帧出现。
    默认超时时间是30s
    
    参数:
    
    url - 匹配帧的url
    
    返回:
    
    匹配的帧
  - waitForFrame
```
public Frame waitForFrame(Predicate<Frame> framePredicate)
```
    等待匹配给定条件的帧出现。
    默认超时时间是30s
    
    参数:
    
    framePredicate - 匹配的表达式
    
    返回:
    
    匹配的帧
  - waitForFrame
```
public Frame waitForFrame(String url,
                          Predicate<Frame> framePredicate,
                          int timeout)
```
    等待匹配给定条件的帧出现。
    
    参数:
    
    url - 等待的url
    
    framePredicate - 匹配的规则
    
    timeout - 超时时间
    
    返回:
    
    匹配的帧
  - goBack
```
public Response goBack()
                throws com.fasterxml.jackson.core.JsonProcessingException
```
    此方法导航到历史记录中的上一页
    
    返回:
    
    如果存在多个重定向，导航将使用最后一个重定向的响应进行解析。如果无法返回，则解析为 null。
    
    抛出:
    
    com.fasterxml.jackson.core.JsonProcessingException
  - goBack
```
public abstract Response goBack(WaitForOptions options)
                         throws com.fasterxml.jackson.core.JsonProcessingException
```
    导航到页面历史的前一个页面
    options 导航配置，可选值：
    otimeout 跳转等待时间，单位是毫秒, 默认是30秒, 传 0 表示无限等待。可以通过page.setDefaultNavigationTimeout(timeout)方法修改默认值
    owaitUntil 满足什么条件认为页面跳转完成，默认是load事件触发时。指定事件数组，那么所有事件触发后才认为是跳转完成。事件包括：
    oload - 页面的load事件触发时 odomcontentloaded - 页面的DOMContentLoaded事件触发时 onetworkidle0 - 不再有网络连接时触发（至少500毫秒后） onetworkidle2 - 只有2个网络连接时触发（至少500毫秒后）
    参数:
    
    options - 见上面注释
    
    返回:
    
    响应
    
    抛出:
    
    com.fasterxml.jackson.core.JsonProcessingException - 如果JSON解析失败
  - goForward
```
public Response goForward()
                   throws com.fasterxml.jackson.core.JsonProcessingException
```
    抛出:
    
    com.fasterxml.jackson.core.JsonProcessingException
  - goForward
```
public abstract Response goForward(WaitForOptions options)
                            throws com.fasterxml.jackson.core.JsonProcessingException
```
    导航到页面历史的后一个页面。 options 导航配置，可选值：
    otimeout 跳转等待时间，单位是毫秒, 默认是30秒, 传 0 表示无限等待。可以通过page.setDefaultNavigationTimeout(timeout)方法修改默认值
    owaitUntil 满足什么条件认为页面跳转完成，默认是load事件触发时。指定事件数组，那么所有事件触发后才认为是跳转完成。事件包括：
    oload - 页面的load事件触发时 odomcontentloaded - 页面的DOMContentLoaded事件触发时 onetworkidle0 - 不再有网络连接时触发（至少500毫秒后） onetworkidle2 - 只有2个网络连接时触发（至少500毫秒后）
    参数:
    
    options - 等待选项
    
    抛出:
    
    com.fasterxml.jackson.core.JsonProcessingException
  - bringToFront
```
public abstract void bringToFront()
```
    相当于多个tab时，切换到某个tab。
  - emulate
```
public void emulate(Device device)
             throws ExecutionException,
                    InterruptedException
```
    模拟各种设备打开浏览器
    所有录制内容均为 WebM 格式，使用 VP9 视频编解码器。FPS 为 30。
    你的系统上必须安装有 ffmpeg。
    
    参数:
    
    device - 设备类型
    
    抛出:
    
    ExecutionException
    
    InterruptedException
  - setJavaScriptEnabled
```
public abstract void setJavaScriptEnabled(boolean enabled)
```
    是否在页面上启用 JavaScript。
    
    参数:
    
    enabled - 是否启用
  - setBypassCSP
```
public abstract void setBypassCSP(boolean enabled)
```
    切换绕过页面的内容安全策略。
    注意：CSP 绕过发生在 CSP 初始化时而不是评估时。通常，这意味着应在导航到域之前调用 page.setBypassCSP。
    
    参数:
    
    enabled - 是否绕过
  - emulateMediaType
```
public abstract void emulateMediaType(MediaType type)
```
    改变页面的css媒体类型。支持的值仅包括 'screen', 'print' 和 null。传 null 禁用媒体模拟
    
    参数:
    
    type - css媒体类型
  - emulateCPUThrottling
```
public abstract void emulateCPUThrottling(double factor)
```
    启用 CPU 限制以模拟慢速 CPU。
    
    参数:
    
    factor - 减速系数（1 表示无油门，2 表示 2 倍减速，等等）。
  - emulateMediaFeatures
```
public abstract void emulateMediaFeatures(List<MediaFeature> features)
```
    模拟媒体特征
    
    参数:
    
    features - 给定一组媒体特性对象，在页面上模拟 CSS 媒体特性,每个媒体特性对象的name必须符合正则表达式： ^(?:prefers-(?:color-scheme|reduced-motion)|color-gamut)$"
  - emulateTimezone
```
public abstract void emulateTimezone(String timezoneId)
```
    更改页面的时区，传null将禁用将时区仿真时区id列表
    
    参数:
    
    timezoneId - 时区id
  - emulateIdleState
```
public abstract void emulateIdleState(IdleOverridesState.Overrides overrides)
```
    模拟空闲状态。如果未设置参数，则清除空闲状态模拟
    
    参数:
    
    overrides - 模拟空闲状态。如果未设置，则清除空闲覆盖
  - emulateVisionDeficiency
```
public abstract void emulateVisionDeficiency(VisionDeficiency type)
```
    模拟页面上给定的视力障碍,不同视力障碍，截图有不同效果
    
    参数:
    
    type - 视力障碍类型
  - setViewport
```
public abstract void setViewport(Viewport viewport)
                          throws ExecutionException,
                                 InterruptedException
```
    如果是一个浏览器多个页面的情况，每个页面都可以有单独的viewport
    注意在大部分情况下，改变 viewport 会重新加载页面以设置 isMobile 或者 hasTouch
    
    参数:
    
    viewport - 设置的视图
    
    抛出:
    
    ExecutionException
    
    InterruptedException
  - viewport
```
public abstract Viewport viewport()
```
    获取Viewport,Viewport各个参数的含义： width 宽度，单位是像素 height 高度，单位是像素 deviceScaleFactor 定义设备缩放， (类似于 dpr)。默认 1。 isMobile 要不要包含meta viewport 标签。默认 false。 hasTouch 指定终端是否支持触摸。默认 false isLandscape 指定终端是不是 landscape 模式。默认 false。
    
    返回:
    
    Viewport
  - evaluate
```
public Object evaluate(String pptrFunction,
                       Object... args)
                throws com.fasterxml.jackson.core.JsonProcessingException
```
    执行一段 JavaScript代码
    
    参数:
    
    pptrFunction - 要执行的字符串
    
    args - 如果pageFunction 是 Javascript 函数的话，args就是函数上的参数
    
    返回:
    
    pageFunction执行结果
    
    抛出:
    
    com.fasterxml.jackson.core.JsonProcessingException - json序列化异常
  - evaluateOnNewDocument
```
public NewDocumentScriptEvaluation evaluateOnNewDocument(String pptrFunction,
                                                         Object... args)
                                                  throws com.fasterxml.jackson.core.JsonProcessingException
```
    在新dom产生之际执行给定的javascript
    当你的js代码为函数时，type=EvaluateType.FUNCTION
    
    当你的js代码为字符串时，type=EvaluateType.STRING
    
    参数:
    
    pptrFunction - js代码
    
    args - 当你js代码是函数时，js函数的参数
    
    抛出:
    
    com.fasterxml.jackson.core.JsonProcessingException
  - evaluateOnNewDocument
```
public abstract NewDocumentScriptEvaluation evaluateOnNewDocument(String pptrFunction,
                                                                  EvaluateType type,
                                                                  Object... args)
                                                           throws com.fasterxml.jackson.core.JsonProcessingException
```
    在新dom产生之际执行给定的javascript
    当你的js代码为函数时，type=EvaluateType.FUNCTION
    
    当你的js代码为字符串时，type=EvaluateType.STRING
    
    参数:
    
    pptrFunction - js代码
    
    type - 一般为PageEvaluateType#FUNCTION
    
    args - 当你js代码是函数时，js函数的参数
    
    返回:
    
    NewDocumentScriptEvaluation 执行脚本的标志符
    
    抛出:
    
    com.fasterxml.jackson.core.JsonProcessingException - json异常
  - removeScriptToEvaluateOnNewDocument
```
public abstract void removeScriptToEvaluateOnNewDocument(String identifier)
```
    删除通过 Page.evaluateOnNewDocument 注入页面的脚本。
    
    参数:
    
    identifier - 脚本标识符
  - setCacheEnabled
```
public abstract void setCacheEnabled(boolean enabled)
```
    根据启用状态切换忽略每个请求的缓存。默认情况下，缓存已启用。
    
    参数:
    
    enabled - 设置缓存的 enabled 状态
  - screencast
```
public ScreenRecorder screencast(ScreencastOptions options)
                          throws IOException,
                                 ExecutionException,
                                 InterruptedException
```
    捕获此 page 的截屏视频。可录制为webm和gif，录制帧率默认是30
    
    参数:
    
    options - 配置截屏行为
    
    返回:
    
    ScreenRecorder 屏幕录制实例，用于停止录制
    
    抛出:
    
    IOException - IO异常
    
    ExecutionException
    
    InterruptedException
  - stopScreencast
```
public void stopScreencast()
```
  - roundRectangle
```
protected ScreenshotClip roundRectangle(ScreenshotClip clip)
```
  - normalizeRectangle
```
protected ScreenshotClip normalizeRectangle(ScreenshotClip clip)
```
    另请参阅:
    
    href="https://w3c.github.io/webdriver-bidi/#normalize-rect
  - screenshot
```
public String screenshot(ScreenshotOptions options)
                  throws ExecutionException,
                         InterruptedException
```
    截图
    备注在OS X上截图需要至少1/6秒。：查看讨论。
    
    参数:
    
    options - 截图选项
    
    返回:
    
    图片base64的字节
    
    抛出:
    
    ExecutionException
    
    InterruptedException
  - screenshot
```
public String screenshot(String path)
                  throws ExecutionException,
                         InterruptedException
```
    屏幕截图
    
    参数:
    
    path - 截图文件全路径
    
    返回:
    
    base64编码后的图片数据
    
    抛出:
    
    ExecutionException
    
    InterruptedException
  - _screenshot
```
protected abstract String _screenshot(ScreenshotOptions options)
                               throws IOException
```
    抛出:
    
    IOException
  - pdf
```
public byte[] pdf(PDFOptions options)
           throws IOException
```
    生成当前页面的pdf格式，带着 pring css media。如果要生成带着 screen media的pdf，在page.pdf() 前面先调用 page.emulateMedia('screen')
    注意目前仅支持无头模式的 Chrome
    
    参数:
    
    options - 选项
    
    返回:
    
    pdf文件的字节数组数据
    
    抛出:
    
    IOException - IO异常
  - pdf
```
public void pdf(String path)
         throws IOException
```
    生成当前页面的pdf格式，带着 pring css media。如果要生成带着 screen media的pdf，在page.pdf() 前面先调用 page.emulateMedia('screen')
    注意目前仅支持无头模式的 Chrome
    
    参数:
    
    path - pdf存放的路径
    
    抛出:
    
    IOException - IO异常
  - pdf
```
public abstract byte[] pdf(PDFOptions options,
                           LengthUnit lengthUnit)
                    throws IOException
```
    生成当前页面的pdf格式，带着 pring css media。如果要生成带着 screen media的pdf，在page.pdf() 前面先调用 page.emulateMedia('screen')
    注意目前仅支持无头模式的 Chrome
    
    参数:
    
    options - 选项
    
    lengthUnit - 单位
    
    返回:
    
    pdf文件的字节数组数据
    
    抛出:
    
    IOException - IO异常
  - title
```
public String title()
             throws com.fasterxml.jackson.core.JsonProcessingException
```
    获取当前主框架的标题
    该方法通过调用主框架的title方法来获取页面标题如果在处理JSON数据时发生错误,该方法将抛出JsonProcessingException异常
    
    返回:
    
    当前主框架的标题
    
    抛出:
    
    com.fasterxml.jackson.core.JsonProcessingException - 如果在处理JSON数据时发生错误
  - isClosed
```
public abstract boolean isClosed()
```
    表示页面是否被关闭。
    
    返回:
    
    页面是否被关闭。
  - mouse
```
public abstract Mouse mouse()
```
  - click
```
public void click(String selector)
           throws com.fasterxml.jackson.core.JsonProcessingException
```
    此方法找到一个匹配 selector 选择器的元素，如果需要会把此元素滚动到可视，然后通过 page.mouse 点击它。如果选择器没有匹配任何元素，此方法将会报错。默认是阻塞的，会等待点击完成指令返回
    
    参数:
    
    selector - 选择器
    
    抛出:
    
    com.fasterxml.jackson.core.JsonProcessingException - JSON异常
  - click
```
public void click(String selector,
                  ClickOptions options)
           throws com.fasterxml.jackson.core.JsonProcessingException
```
    抛出:
    
    com.fasterxml.jackson.core.JsonProcessingException
  - focus
```
public void focus(String selector)
           throws com.fasterxml.jackson.core.JsonProcessingException
```
    此方法找到一个匹配selector的元素，并且把焦点给它。如果没有匹配的元素，此方法将报错。
    
    参数:
    
    selector - 要给焦点的元素的选择器selector。如果有多个匹配的元素，焦点给第一个元素。
    
    抛出:
    
    com.fasterxml.jackson.core.JsonProcessingException - JSON异常
  - hover
```
public void hover(String selector)
           throws com.fasterxml.jackson.core.JsonProcessingException
```
    此方法找到一个匹配的元素，如果需要会把此元素滚动到可视，然后通过 page.mouse 来hover到元素的中间。如果没有匹配的元素，此方法将会报错。
    
    参数:
    
    selector - 要hover的元素的选择器。如果有多个匹配的元素，hover第一个。
    
    抛出:
    
    com.fasterxml.jackson.core.JsonProcessingException - JSON异常
  - select
```
public List<String> select(String selector,
                           List<String> values)
                    throws com.fasterxml.jackson.core.JsonProcessingException
```
    当提供的选择器完成选中后，触发change和input事件如果没有元素匹配指定选择器，将报错。
    
    参数:
    
    selector - 要查找的选择器
    
    values - 要选择的选项的值。如果 select 具有 multiple 属性，则考虑所有值，否则仅考虑第一个值。
    
    返回:
    
    选择器集合
    
    抛出:
    
    com.fasterxml.jackson.core.JsonProcessingException - JSON异常
  - tap
```
public void tap(String selector)
         throws com.fasterxml.jackson.core.JsonProcessingException
```
    此方法找到一个匹配的元素，如果需要会把此元素滚动到视图中，然后通过 page.touchscreen 来点击元素的中间位置如果没有匹配的元素，此方法会报错
    
    参数:
    
    selector - 要点击的元素的选择器。如果有多个匹配的元素，点击第一个
    
    抛出:
    
    com.fasterxml.jackson.core.JsonProcessingException - JSON异常
  - type
```
public void type(String selector,
                 String text)
          throws com.fasterxml.jackson.core.JsonProcessingException
```
    每个字符输入后都会触发 keydown, keypress/input 和 keyup 事件
    要点击特殊按键，比如 Control 或 ArrowDown，用 keyboard.press
    
    参数:
    
    selector - 要输入内容的元素选择器。如果有多个匹配的元素，输入到第一个匹配的元素。
    
    text - 要输入的内容
    
    抛出:
    
    com.fasterxml.jackson.core.JsonProcessingException - JSON异常
  - type
```
public void type(String selector,
                 String text,
                 long delay)
          throws com.fasterxml.jackson.core.JsonProcessingException
```
    每个字符输入后都会触发 keydown, keypress/input 和 keyup 事件
    要点击特殊按键，比如 Control 或 ArrowDown，用 keyboard.press
    
    参数:
    
    selector - 要输入内容的元素选择器。如果有多个匹配的元素，输入到第一个匹配的元素。
    
    text - 要输入的内容
    
    delay - 每个字符输入的延迟，单位是毫秒。默认是 0。
    
    抛出:
    
    com.fasterxml.jackson.core.JsonProcessingException - JSON异常
  - waitForSelector
```
public ElementHandle waitForSelector(String selector)
                              throws com.fasterxml.jackson.core.JsonProcessingException
```
    等待指定的选择器匹配的元素出现在页面中，如果调用此方法时已经有匹配的元素，那么此方法立即返回。如果指定的选择器在超时时间后扔不出现，此方法会报错。
    
    参数:
    
    selector - 要等待的元素选择器
    
    返回:
    
    ElementHandle
    
    抛出:
    
    com.fasterxml.jackson.core.JsonProcessingException
  - waitForSelector
```
public ElementHandle waitForSelector(String selector,
                                     WaitForSelectorOptions options)
                              throws com.fasterxml.jackson.core.JsonProcessingException
```
    等待指定的选择器匹配的元素出现在页面中，如果调用此方法时已经有匹配的元素，那么此方法立即返回。如果指定的选择器在超时时间后扔不出现，此方法会报错。
    
    参数:
    
    selector - 要等待的元素选择器
    
    options - 可选参数
    
    返回:
    
    ElementHandle 返回的handle
    
    抛出:
    
    com.fasterxml.jackson.core.JsonProcessingException
  - waitForFunction
```
public JSHandle waitForFunction(String pptrFunction)
                         throws ExecutionException,
                                InterruptedException,
                                TimeoutException
```
    等待提供的函数 pptrFunction 在页面上下文中计算时返回真值。
    
    参数:
    
    pptrFunction - 将在浏览器上下文中评估函数，直到返回真值。
    
    返回:
    
    JSHandle 指定的页面元素对象
    
    抛出:
    
    ExecutionException
    
    InterruptedException
    
    TimeoutException
  - waitForFunction
```
public JSHandle waitForFunction(String pptrFunction,
                                Object... args)
                         throws ExecutionException,
                                InterruptedException,
                                TimeoutException
```
    等待提供的函数 pptrFunction 在页面上下文中计算时返回真值。
    
    参数:
    
    pptrFunction - 将在浏览器上下文中评估函数，直到返回真值。
    
    args - 传递给函数的参数，可以是任意类型
    
    返回:
    
    JSHandle 返回函数执行结果的JSHandle对象
    
    抛出:
    
    ExecutionException
    
    InterruptedException
    
    TimeoutException
  - waitForFunction
```
public JSHandle waitForFunction(String pptrFunction,
                                WaitForSelectorOptions options,
                                Object... args)
                         throws ExecutionException,
                                InterruptedException,
                                TimeoutException
```
    等待提供的函数 pptrFunction 在页面上下文中计算时返回真值。
    
    参数:
    
    pptrFunction - 将在浏览器上下文中评估函数，直到返回真值。
    
    options - 等待函数的选项，包括超时设置等
    
    args - 传递给函数的参数，可以是任意类型
    
    返回:
    
    JSHandle 返回函数执行结果的JSHandle对象
    
    抛出:
    
    ExecutionException
    
    InterruptedException
    
    TimeoutException
  - waitForFunction
```
public JSHandle waitForFunction(String pptrFunction,
                                WaitForSelectorOptions options,
                                EvaluateType type,
                                Object... args)
                         throws ExecutionException,
                                InterruptedException,
                                TimeoutException
```
    等待提供的函数 pptrFunction 在页面上下文中计算时返回真值。
    
    参数:
    
    pptrFunction - 将在浏览器上下文中评估函数，直到返回真值。
    
    options - 等待函数的选项，包括超时设置等
    
    args - 传递给函数的参数，可以是任意类型
    
    type - 有时候需要指定 pptrFunction 为 EvaluateType#String 才能正确执行，大多数情况不需要指定
    
    返回:
    
    JSHandle 返回函数执行结果的JSHandle对象
    
    抛出:
    
    ExecutionException
    
    InterruptedException
    
    TimeoutException
  - waitForDevicePrompt
```
public DeviceRequestPrompt waitForDevicePrompt()
```
    此方法通常与从 API（例如 WebBluetooth）触发设备请求的操作结合使用。
    提醒
    必须在发送设备请求之前调用此函数。它不会返回当前活动的设备提示。
    默认等待事件是30s
    
    返回:
    
    DeviceRequestPrompt 设备请求
  - waitForDevicePrompt
```
public DeviceRequestPrompt waitForDevicePrompt(int timeout)
```
    此方法通常与从 API（例如 WebBluetooth）触发设备请求的操作结合使用。
    提醒
    必须在发送设备请求之前调用此函数。它不会返回当前活动的设备提示。
    
    参数:
    
    timeout - 超时时间,默认是30s
    
    返回:
    
    DeviceRequestPrompt
  - close
```
public void close()
```
    page.close() 在 beforeunload 处理之前默认不执行
    注意如果 runBeforeUnload 设置为true，可能会弹出一个 beforeunload 对话框。这个对话框需要通过页面的 'dialog' 事件手动处理
  - close
```
public abstract void close(boolean runBeforeUnload)
```
  - setDragging
```
public void setDragging(boolean dragging)
```
  - isDragging
```
public boolean isDragging()
```
  - convertPrintParameterToInches
```
protected Double convertPrintParameterToInches(String parameter,
                                               LengthUnit lengthUnit)
```

类 Page

字段概要

构造器概要

方法概要

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

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

字段详细资料

LOGGER

_timeoutSettings

requestHandlers

isDragging

inflight

构造器详细资料

Page

方法详细资料

isServiceWorkerBypassed

isDragInterceptionEnabled

isJavaScriptEnabled

on

off

fileChooserWaitFor

setGeolocation

target

browser

browserContext

mainFrame

createCDPSession

keyboard

touchscreen

coverage

tracing

accessibility

frames

workers

setRequestInterception

setBypassServiceWorker

setDragInterception

setOfflineMode

emulateNetworkConditions

setDefaultNavigationTimeout

setDefaultTimeout

getDefaultTimeout

getDefaultNavigationTimeout

$

$$

evaluateHandle

evaluateHandle

queryObjects

$eval

$eval

$$eval

$$eval

cookies

cookies

deleteCookie

deleteCookie

setCookie

addScriptTag

addStyleTag

exposeFunction

removeExposedFunction

authenticate

setExtraHTTPHeaders

setUserAgent

setUserAgent

metrics

url

content

setContent

setContent

goTo

goTo

reload

reload

waitForNavigation

waitForNavigation

waitForNavigation

waitForRequest

waitForRequest

waitForResponse