メインコンテンツにスキップ
バージョン: 22.5.0

APIリファレンス

クラス

クラス説明
AccessibilityAccessibilityクラスは、ブラウザのアクセシビリティツリーを検査するためのメソッドを提供します。アクセシビリティツリーは、スクリーンリーダースイッチなどの支援技術で使用されます。
Browser

Browserは、以下のいずれかによって接続されたブラウザインスタンスを表します。

- Puppeteer.connect()経由で接続された、または- PuppeteerNode.launch()によって起動された。

Browserは、BrowserEvent enumにドキュメント化されている様々なイベントを発行します。

BrowserContext

BrowserContextは、ブラウザ内の個々のユーザーコンテキストを表します。

ブラウザが起動されると、デフォルトで単一のブラウザコンテキストを持ちます。他のコンテキストは、Browser.createBrowserContext()を使用して作成できます。各コンテキストは、隔離されたストレージ(cookie/localStorageなど)を持ちます。

BrowserContextは、BrowserContextEvent enumにドキュメント化されている様々なイベントを発行します。

ページwindow.openを使用して別のページを開くと、ポップアップは親ページのブラウザコンテキストに属します。

CDPSessionCDPSessionインスタンスは、生のChrome Devtools Protocolと通信するために使用されます。
Connection
ConsoleMessageConsoleMessageオブジェクトは、「console」イベントを介してページによってディスパッチされます。
CoverageCoverageクラスは、ページで使用されたJavaScriptおよびCSSの部分に関する情報を収集するためのメソッドを提供します。
CSSCoverage
DeviceRequestPromptデバイスリクエストプロンプトを使用すると、WebBluetoothのようなAPIを介してデバイスを要求するページに応答できます。
DeviceRequestPromptDeviceリクエストプロンプト内のデバイス。
DialogDialogインスタンスは、dialogイベントを介してPageによってディスパッチされます。
ElementHandleElementHandleは、ページ内のDOM要素を表します。
EventEmitter多くのPuppeteerクラスが拡張するEventEmitterクラス。
FileChooserファイル選択ツールを使用すると、ファイルを要求するページに応答できます。
Frame

DOMフレームを表します。

フレームを理解するために、フレームを<iframe>要素として考えることができます。iframeと同様に、フレームはネストすることができ、フレーム内でJavaScriptが実行されると、JavaScriptはJavaScriptが実行される環境フレーム内のフレームには影響しません。

HTTPRequestページによって送信されたHTTPリクエストを表します。
HTTPResponseHTTPResponseクラスは、Pageクラスによって受信される応答を表します。
JSCoverage
JSHandle

JavaScriptオブジェクトへの参照を表します。インスタンスは、Page.evaluateHandle()を使用して作成できます。

ハンドルは、ハンドルが意図的に破棄されない限り、参照されているJavaScriptオブジェクトがガベージコレクションされるのを防ぎます。JSHandleは、関連付けられたフレームがナビゲートされたり、親コンテキストが破棄されたりすると、自動的に破棄されます。

ハンドルは、Page.$eval()Page.evaluate()Page.evaluateHandle()などの評価関数の引数として使用できます。それらは、参照されているオブジェクトに解決されます。

KeyboardKeyboardは、仮想キーボードを管理するためのAPIを提供します。高レベルAPIは、生の文字を受け取り、ページ上で適切なkeydown、keypress/input、およびkeyupイベントを生成するKeyboard.type()です。
LocatorLocatorは、オブジェクトを特定し、オブジェクトに対してアクションを実行する戦略を記述します。アクションの準備ができていないためにアクションが失敗した場合、操作全体が再試行されます。アクションが成功するためのさまざまな前提条件が自動的にチェックされます。
MouseMouseクラスは、ビューポートの左上隅を基準としたメインフレームCSSピクセルで動作します。
Page

Pageは、ブラウザの単一のタブまたは拡張機能のバックグラウンドページと対話するためのメソッドを提供します。

:::note

1つのBrowserインスタンスに複数のPageインスタンスが存在する可能性があります。

:::

ProductLauncherランチャーを記述します。これは、ブラウザインスタンスを作成して起動できるクラスです。
ProtocolErrorProtocolErrorは、プロトコルからのエラーが発生するたびに発行されます。
Puppeteer

メインのPuppeteerクラス。

重要: Node環境でPuppeteerを使用している場合は、puppeteerをインポートまたはrequireすると、PuppeteerNodeのインスタンスを取得します。このクラスはPuppeteerを拡張するため、以下に文書化されているすべてのメソッドと、PuppeteerNodeで定義されているすべてのメソッドを持ちます。

PuppeteerErrorすべてのPuppeteer固有のエラーの基本クラス
PuppeteerNode

ブラウザの取得とダウンロードのためにNode固有の動作でメインのPuppeteerクラスを拡張します。

Node環境でPuppeteerを使用している場合、require('puppeteer')(または同等のESのimport)を実行すると、このクラスを取得します。

ScreenRecorder
SecurityDetailsSecurityDetailsクラスは、セキュア接続を介して受信された応答のセキュリティ詳細を表します。
TargetTargetは、CDPターゲットを表します。CDPでは、ターゲットは、フレーム、ページ、またはワーカーなど、デバッグ可能なものです。
TimeoutErrorTimeoutErrorは、タイムアウトが原因で特定の操作が終了するたびに発行されます。
TouchscreenTouchscreenクラスは、タッチスクリーンイベントを公開します。
TracingTracingクラスは、トレース監査インターフェースを公開します。
UnsupportedOperationPuppeteerは、現在使用されているプロトコルでメソッドがサポートされていない場合、このエラーをスローします
WebWorkerこのクラスは、WebWorkerを表します。

列挙型

列挙型説明
BrowserContextEvent
BrowserEventブラウザインスタンスが発行する可能性のあるすべてのイベント。
InterceptResolutionAction
LocatorEventロケーターインスタンスが発行する可能性のあるすべてのイベント。
PageEventページインスタンスが発行する可能性のあるすべてのイベント。
TargetType

関数

関数説明
clearCustomQueryHandlers()
connect(options)
customQueryHandlerNames()
defaultArgs(options)
executablePath(channel)
launch(options)
registerCustomQueryHandler(name, handler)
trimCache()
unregisterCustomQueryHandler(name)

インターフェース

インターフェース説明
ActionOptions
AutofillData
BoundingBox
BoxModel
BrowserConnectOptionsブラウザを起動するとき、または既存のブラウザインスタンスに接続するときに渡すことができる一般的なブラウザオプション。
BrowserContextEvents
BrowserContextOptions
BrowserEvents
BrowserLaunchArgumentOptionsChromeにのみ適用されるランチャーオプション。
CDPSessionEvents
ClickOptions
CommandOptions
CommonEventEmitter
Configuration

インストール時および実行時にPuppeteerの動作を構成するためのオプションを定義します。

詳細については、個々のプロパティを参照してください。

ConnectionTransport
ConnectOptions
ConsoleMessageLocation
ContinueRequestOverrides
Cookieクッキーオブジェクトを表します。
CookieParamクッキーパラメーターオブジェクト
CoverageEntryCoverageEntryクラスは、カバレッジレポートの1つのエントリを表します。
Credentials
CSSCoverageOptionsCSSカバレッジ用に構成可能なオプションのセット。
CustomQueryHandler
DebugInfo
DeleteCookiesRequest
Device
ElementScreenshotOptions
FrameAddScriptTagOptions
FrameAddStyleTagOptions
FrameEvents
FrameWaitForFunctionOptions
GeolocationOptions
GoToOptions
InterceptResolutionState
InternalNetworkConditions
JSCoverageEntryJavaScriptのCoverageEntryクラス
JSCoverageOptionsJSカバレッジ用に構成可能なオプションのセット。
KeyboardTypeOptions
KeyDownOptions
LaunchOptions任意のブラウザを起動するときに渡すことができる一般的な起動オプション。
LocatorEvents
LocatorOptions
LocatorScrollOptions
MediaFeature
Metrics
MouseClickOptions
MouseMoveOptions
MouseOptions
MouseWheelOptions
Moveable
NetworkConditions
NewDocumentScriptEvaluation
Offset
PageEvents

ページイベントのコールバック関数で受信されるオブジェクトを示します。

イベントとその発行タイミングの詳細については、PageEventを参照してください。

PDFMargin
PDFOptionsPage.pdf()を介してPDF生成を構成するための有効なオプション。
Point
PuppeteerLaunchOptions
RemoteAddress
ResponseForRequestリクエストを完了するために必要なレスポンスデータ。
ScreencastOptions
ScreenshotClip
ScreenshotOptions
SerializedAXNodeノードと、アクセシビリティに関連するそのプロパティを表します。
SnapshotOptions
TracingOptions
Viewport
WaitForNetworkIdleOptions
WaitForOptions
WaitForSelectorOptions
WaitForTargetOptions
WaitTimeoutOptions

名前空間

名前空間説明
CDPSessionEventCDPSessionクラスが発行するイベント。

変数

変数説明
DEFAULT_INTERCEPT_RESOLUTION_PRIORITYデフォルトの協調リクエストインターセプト解決優先度
KnownDevicesPage.emulate()で使用するデバイスのリスト。
MouseButton有効なマウスボタンのEnum。
PredefinedNetworkConditionsPage.emulateNetworkConditions()で使用するネットワーク条件のリスト。
puppeteer

タイプエイリアス

タイプエイリアス説明
ActionResult
Awaitable
AwaitableIterable
AwaitablePredicate
AwaitedLocator
CDPEvents
ChromeReleaseChannel
ConsoleMessageTypeコンソールメッセージでサポートされているタイプ。
CookiePriorityクッキーの「Priority」ステータスを表します: https://tools.ietf.org/html/draft-west-cookie-priority-00
CookieSameSiteクッキーの「SameSite」ステータスを表します: https://tools.ietf.org/html/draft-west-first-party-cookies
CookieSourceSchemeクッキーを最初に設定したオリジンのソーススキームを表します。「Unset」の値は、プロトコルクライアントがスキームのレガシークッキースコープをエミュレートできるようにします。これは一時的な機能であり、将来削除される予定です。
ElementFor
ErrorCode
EvaluateFunc
EvaluateFuncWith
EventsWithWildcard
EventType
ExperimentsConfiguration

Puppeteerの実験オプションを定義します。

詳細については、個々のプロパティを参照してください。

FlattenHandle
HandleFor
HandleOr
Handler
InnerParams
KeyInputkeyboard.pressなど、ユーザー入力を受け取る関数に渡すことができるすべての有効なキー。
KeyPressOptions
LocatorClickOptions
LowerCasePaperFormat
Mapper
MouseButton
NodeFor
PaperFormatPDFを印刷する際のすべての有効な用紙形式タイプ。
Permission
Predicate
Productサポートされている製品。
ProtocolLifeCycleEvent
ProtocolType
PuppeteerLifeCycleEvent
PuppeteerNodeLaunchOptionsすべての型をリストする必要なく、puppeteer.launchに渡すことができるオプションをユーザーが定義できるように公開されたユーティリティ型。
Quad
ResourceTypeレンダリングエンジンによって認識されるHTTPリクエストのリソースタイプ。
TargetFilterCallback
VisibilityOption