Puppeteer 中文文档v25.8.0

PageEvent 枚举

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

签名

export declare const enum PageEvent

枚举成员

成员

说明

Close

"close"

当页面关闭时触发。

Console

"console"

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

备注:

console 事件会提供一个 ConsoleMessage,表示已记录的 console 消息。

Dialog

"dialog"

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

DOMContentLoaded

"domcontentloaded"

当派发 JavaScript DOMContentLoaded 事件时触发。

Error

"error"

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

FrameAttached

"frameattached"

当某个框架被附加时触发。将包含一个 Frame

FrameDetached

"framedetached"

当某个框架被分离时触发。将包含一个 Frame

FrameNavigated

"framenavigated"

当某个框架导航到新 URL 时触发。将包含一个 Frame

Issue

"issue"

(实验性) 当报告 DevTools 问题时触发。

Load

"load"

当派发 JavaScript load 事件时触发。

Metrics

"metrics"

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

备注:

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

  • title:传递给 console.timeStamp 的标题 - metrics:以键/值对形式包含指标的对象。这些值将是 number

PageError

"pageerror"

当页面内发生未捕获的异常时触发。包含一个 Error 或类型未知的数据。

Popup

"popup"

当页面打开新标签页或窗口时触发。

包含一个与弹出窗口对应的 Page

Request

"request"

当页面发出请求时触发,并包含一个 HTTPRequest

备注:

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

RequestFailed

"requestfailed"

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

包含一个 HTTPRequest

备注:

从 HTTP 的角度来看,404 或 503 之类的 HTTP 错误响应仍然是成功响应,因此请求将以 requestfinished 事件完成,而不是 requestfailed

RequestFinished

"requestfinished"

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

RequestServedFromCache

"requestservedfromcache"

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

备注:

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

Response

"response"

当收到响应时触发。包含一个 HTTPResponse

WorkerCreated

"workercreated"

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

WorkerDestroyed

"workerdestroyed"

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