跳至主要內容
版本:23.11.1

PageEvent 列舉

頁面實例可能發出的所有事件。

簽名

export declare const enum PageEvent

列舉成員

成員

描述

關閉

"close"

當頁面關閉時發出。

主控台

"console"

當頁面中的 JavaScript 呼叫其中一個主控台 API 方法時發出,例如 console.logconsole.dir。如果頁面擲出錯誤或警告也會發出。

備註

console 事件提供一個 ConsoleMessage,表示記錄的主控台訊息。

Dialog

"dialog"

當 JavaScript 對話方塊出現時發出,例如 alertpromptconfirmbeforeunload。Puppeteer 可以透過 Dialog.accept()Dialog.dismiss() 回應對話方塊。

DOMContentLoaded

"domcontentloaded"

當 JavaScript DOMContentLoaded 事件分派時發出。

錯誤

"error"

當頁面崩潰時發出。將包含一個 Error

FrameAttached

"frameattached"

當框架附加時發出。將包含一個 Frame

FrameDetached

"framedetached"

當框架分離時發出。將包含一個 Frame

FrameNavigated

"framenavigated"

當框架導航至新 URL 時發出。將包含一個 Frame

載入

"load"

當 JavaScript load 事件分派時發出。

Metrics

"metrics"

當 JavaScript 程式碼呼叫 console.timeStamp 時發出。如需指標的清單,請參閱 page.metrics

備註

包含具有兩個屬性的物件

  • title:傳遞給 console.timeStamp 的標題 - metrics:包含指標作為鍵/值配對的物件。值將為 number

PageError

"pageerror"

當頁面中發生未捕獲的例外時發出。包含一個 Error

Popup

"popup"

當頁面開啟新的分頁或視窗時發出。

包含與彈出視窗對應的 Page

請求

"request"

當頁面發出請求時發出,並包含一個 HTTPRequest

備註

此物件為唯讀。如需攔截和變更請求,請參閱 Page.setRequestInterception()

RequestFailed

"requestfailed"

當請求失敗時發出,例如逾時。

包含一個 HTTPRequest

備註

HTTP 錯誤回應,例如 404 或 503,從 HTTP 的角度來看仍然是成功的回應,因此請求將以 requestfinished 事件完成,而不是 requestfailed

RequestFinished

"requestfinished"

當請求成功完成時發出。包含一個 HTTPRequest

RequestServedFromCache

"requestservedfromcache"

當請求最終從快取載入時發出。包含一個 HTTPRequest

備註

對於某些請求,可能包含未定義。https://crbug.com/750469

回應

"response"

當收到回應時發出。包含一個 HTTPResponse

WorkerCreated

"workercreated"

當頁面產生專用 WebWorker 時發出。

WorkerDestroyed

"workerdestroyed"

當頁面銷毀專用 WebWorker 時發出。