跳转到主要内容
版本:23.11.1

PageEvent 枚举

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

签名

export declare const enum PageEvent

枚举成员

成员

描述

Close

"close"

当页面关闭时发出。

Console

"console"

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

备注

console 事件提供一个 ConsoleMessage,表示记录的控制台消息。

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

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

备注

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

Response

"response"

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

WorkerCreated

"workercreated"

当页面生成一个专用的 WebWorker 时发出。

WorkerDestroyed

"workerdestroyed"

当页面销毁一个专用的 WebWorker 时发出。