Browser クラス
Browser は、以下のいずれかのブラウザインスタンスを表します。
- Puppeteer.connect() 経由で接続されている - PuppeteerNode.launch() によって起動された。
Browser は、BrowserEvent 列挙型でドキュメント化されているさまざまなイベントを 発行 します。
シグネチャ:
export declare abstract class Browser extends EventEmitter<BrowserEvents>
拡張: EventEmitter<BrowserEvents>
備考
このクラスのコンストラクタは内部用としてマークされています。サードパーティのコードは、コンストラクタを直接呼び出したり、`Browser` クラスを拡張するサブクラスを作成したりしないでください。
例 1
import puppeteer from 'puppeteer';
const browser = await puppeteer.launch();
const page = await browser.newPage();
await page.goto('https://example.com');
await browser.close();
例 2
Browser からの切断と再接続
import puppeteer from 'puppeteer';
const browser = await puppeteer.launch();
// Store the endpoint to be able to reconnect to the browser.
const browserWSEndpoint = browser.wsEndpoint();
// Disconnect puppeteer from the browser.
await browser.disconnect();
// Use the endpoint to reestablish a connection
const browser2 = await puppeteer.connect({browserWSEndpoint});
// Close the browser.
await browser2.close();
プロパティ
| プロパティ | 修飾子 | 型 | 説明 |
|---|---|---|---|
| connected | 読み取り専用 | boolean | Puppeteer がこの ブラウザ に接続されているかどうか。 |
| debugInfo | 読み取り専用 | DebugInfo | Puppeteer からデバッグ情報を取得します。 |
メソッド
| メソッド | 修飾子 | 説明 |
|---|---|---|
| browserContexts() | 開いている ブラウザコンテキスト のリストを取得します。 新しく作成された ブラウザ では、BrowserContext の単一インスタンスが返されます。 | |
| close() | この ブラウザ とすべての関連付けられた ページ を閉じます。 | |
| createBrowserContext(options) | 新しい ブラウザコンテキスト を作成します。 これは、他の ブラウザコンテキスト と Cookie/キャッシュを共有しません。 | |
| defaultBrowserContext() | デフォルトの ブラウザコンテキスト を取得します。 | |
| disconnect() | Puppeteer をこの ブラウザ から切断しますが、プロセスは実行中のままにします。 | |
| isConnected() | Puppeteer がこの ブラウザ に接続されているかどうか。 | |
| newPage() | デフォルトのブラウザコンテキスト に新しい ページ を作成します。 | |
| pages() | この Browser 内の開いているすべての ページ のリストを取得します。 複数の ブラウザコンテキスト がある場合、すべての ブラウザコンテキスト 内のすべての ページ が返されます。 | |
| process() | 関連付けられた ChildProcess を取得します。 | |
| target() | デフォルトのブラウザコンテキスト に関連付けられた ターゲット を取得します。 | |
| targets() | すべてのアクティブな ターゲット を取得します。 複数の ブラウザコンテキスト がある場合、すべての ブラウザコンテキスト 内のすべての ターゲット が返されます。 | |
| userAgent() | この ブラウザ の元のユーザーエージェントを取得します。 ページ は Page.setUserAgent() でユーザーエージェントをオーバーライドできます。 | |
| version() | この ブラウザ の名前とバージョンを表す文字列を取得します。 ヘッドレスブラウザの場合、これは `「HeadlessChrome/61.0.3153.0」` のようになります。ヘッドレスではない場合、または新しいヘッドレスの場合、これは `「Chrome/61.0.3153.0」` のようになります。 Firefox の場合、`「Firefox/116.0a1」` のようになります。 Browser.version() の形式は、ブラウザの今後のリリースで変更される可能性があります。 | |
| waitForTarget(predicate, options) | 指定された `predicate` に一致する ターゲット が表示されるまで待機し、それを返します。 これは、開いているすべての ブラウザコンテキスト を検索します。 | |
| wsEndpoint() | この ブラウザ に接続するための WebSocket URL を取得します。 これは通常、Puppeteer.connect() で使用されます。 デバッガ URL ( `webSocketDebuggerUrl` ) は、` http://HOST:PORT/json/version ` から見つけることができます。 詳細については、ブラウザエンドポイント を参照してください。 |