Skip to main content
Version: 22.9.0

PageEvent 枚举

¥PageEvent enum

页面实例可能触发的所有事件。

¥All the events that a page instance may emit.

签名:

¥Signature:

export declare const enum PageEvent

枚举成员

¥Enumeration Members

成员

描述

关闭

"close"

页面关闭时触发。

Console

"console"

当页面内的 JavaScript 调用控制台 API 方法之一时触发,例如 console.logconsole.dir。如果页面抛出错误或警告,也会触发。

评论:

console 事件提供代表已记录的控制台消息的 ConsoleMessage

对话

"dialog"

当 JavaScript 对话框出现时触发,例如 alertpromptconfirmbeforeunload。Puppeteer 可以通过 Dialog.accept()Dialog.dismiss() 响应对话。

DOMContentLoaded

"domcontentloaded"

当调度 JavaScript DOMContentLoaded 事件时触发。

错误

"error"

页面崩溃时触发。将包含 Error

附框

"frameattached"

当附加框架时触发。将包含 框架

框架分离

"framedetached"

当框架分离时触发。将包含 框架

框架导航

"framenavigated"

当框架导航到新 URL 时触发。将包含 框架

加载

"load"

当调度 JavaScript load 事件时触发。

指标

"metrics"

当 JavaScript 代码调用 console.timeStamp 时触发。有关指标列表,请参阅 page.metrics

评论:

包含一个具有两个属性的对象:

  • title:标题已传递至 console.timeStamp - metrics:包含指标作为键/值对的对象。这些值将为 number

页面错误

"pageerror"

当页面内发生未捕获的异常时触发。包含 Error

弹出窗口

"popup"

当页面打开新选项卡或窗口时触发。

包含与弹出窗口对应的

要求

"request"

当页面发送请求并包含 HTTPRequest 时触发。

评论:

该对象是只读的。请参阅 Page.setRequestInterception() 了解拦截和修改请求。

请求失败

"requestfailed"

当请求失败时触发,例如超时。

包含 HTTPRequest

评论:

从 HTTP 角度来看,HTTP 错误响应(例如 404 或 503)仍然是成功响应,因此请求将通过 requestfinished 事件完成,而不是通过 requestfailed 事件完成。

请求已完成

"requestfinished"

当请求成功完成时触发。包含 HTTPRequest

从缓存请求服务

"requestservedfromcache"

当请求最终从缓存加载时触发。包含 HTTPRequest

评论:

对于某些请求,可能包含未定义。https://crbug.com/750469

响应

"response"

收到响应时触发。包含 HTTPResponse

WorkerCreated

"workercreated"

当页面生成专用 WebWorker 时触发。

WorkerDestroyed

"workerdestroyed"

当专用 WebWorker 被页面销毁时触发。