メインコンテンツへスキップ

Browser

Browser は BrowserType.LaunchAsync() を介して作成されます。Page を作成するために Browser を使用する例

using Microsoft.Playwright;

using var playwright = await Playwright.CreateAsync();
var firefox = playwright.Firefox;
var browser = await firefox.LaunchAsync(new() { Headless = false });
var page = await browser.NewPageAsync();
await page.GotoAsync("https://www.bing.com");
await browser.CloseAsync();

メソッド​

BrowserType​

追加: v1.23 browser.BrowserType

ブラウザーが属するブラウザータイプ (chromium、firefox、または webkit) を取得します。

使用法

Browser.BrowserType

戻り値

CloseAsync​

v1.9より前に追加 browser.CloseAsync

このブラウザーが BrowserType.LaunchAsync() を使用して取得された場合、ブラウザーとそのすべてのページ (開いている場合) を閉じます。

このブラウザーが接続されている場合、このブラウザーに属する作成されたすべてのコンテキストをクリアし、ブラウザーサーバーから切断します。

注

これは、ブラウザーを強制終了するのと似ています。ページを正常に閉じ、ページクローズイベントを確実に受信するには、BrowserContext.CloseAsync() を、以前に Browser.NewContextAsync() を使用して明示的に作成した BrowserContext インスタンスで、Browser.CloseAsync() を呼び出す前に呼び出してください。

Browser オブジェクト自体は破棄されたと見なされ、もう使用できません。

使用法

await Browser.CloseAsync(options);

引数

  • options BrowserCloseOptions? (オプション)

    • Reason string? (オプション)追加: v1.40#

      ブラウザーのクローズによって中断された操作に報告される理由。

戻り値

コンテキスト​

v1.9より前に追加 browser.Contexts

開いているすべてのブラウザーコンテキストの配列を返します。新しく作成されたブラウザーでは、ゼロのブラウザーコンテキストが返されます。

使用法

using var playwright = await Playwright.CreateAsync();
var browser = await playwright.Webkit.LaunchAsync();
System.Console.WriteLine(browser.Contexts.Count); // prints "0"
var context = await browser.NewContextAsync();
System.Console.WriteLine(browser.Contexts.Count); // prints "1"

戻り値

IsConnected​

v1.9より前に追加 browser.IsConnected

ブラウザーが接続されていることを示します。

使用法

Browser.IsConnected

戻り値

NewBrowserCDPSessionAsync​

追加: v1.11 browser.NewBrowserCDPSessionAsync
注

CDPセッションは、Chromiumベースのブラウザーでのみサポートされています。

新しく作成されたブラウザーセッションを返します。

使用法

await Browser.NewBrowserCDPSessionAsync();

戻り値

NewContextAsync​

v1.9より前に追加 browser.NewContextAsync

新しいブラウザーコンテキストを作成します。他のブラウザーコンテキストとCookie/キャッシュを共有しません。

注

BrowserContext を作成するためにこのメソッドを直接使用する場合、コードが BrowserContext を使い終わったら、BrowserContext.CloseAsync() を介して返されたコンテキストを明示的に閉じ、Browser.CloseAsync() を呼び出す前に閉じることをお勧めします。これにより、context が正常に閉じられ、HARやビデオなどの成果物が完全にフラッシュおよび保存されることが保証されます。

使用法

using var playwright = await Playwright.CreateAsync();
var browser = await playwright.Firefox.LaunchAsync();
// Create a new incognito browser context.
var context = await browser.NewContextAsync();
// Create a new page in a pristine context.
var page = await context.NewPageAsync(); ;
await page.GotoAsync("https://www.bing.com");

// Gracefully close up everything
await context.CloseAsync();
await browser.CloseAsync();

引数

  • options BrowserNewContextOptions? (オプション)

    • AcceptDownloads bool? (オプション)#

      すべての添付ファイルを自動的にダウンロードするかどうか。デフォルトは `true` で、すべてのダウンロードが受け入れられます。

    • BaseURL string? (オプション)#

      Page.GotoAsync()、Page.RouteAsync()、Page.WaitForURLAsync()、Page.RunAndWaitForRequestAsync()、または Page.RunAndWaitForResponseAsync() を使用する場合、対応するURLを構築するために URL() コンストラクターを使用することにより、ベースURLを考慮します。デフォルトでは設定されていません。例

      • baseURL: http://localhost:3000 で /bar.html に移動すると、http://localhost:3000/bar.html になります。
      • baseURL: http://localhost:3000/foo/ で ./bar.html に移動すると、http://localhost:3000/foo/bar.html になります。
      • baseURL: http://localhost:3000/foo (末尾のスラッシュなし) で ./bar.html に移動すると、http://localhost:3000/bar.html になります。

    • BypassCSP bool? (オプション)#

      ページの Content-Security-Policy のバイパスを切り替えます。デフォルトは false です。

    • ClientCertificates IEnumerable?<ClientCertificates> (オプション)追加: 1.46#

      • Origin string

        証明書が有効な正確なオリジン。オリジンには、`https` プロトコル、ホスト名、およびオプションでポートが含まれます。

      • CertPath string? (オプション)

        PEM形式の証明書を含むファイルへのパス。

      • Cert byte[]? (オプション)

        PEM形式の証明書の直接値。

      • KeyPath string? (オプション)

        PEM形式の秘密鍵を含むファイルへのパス。

      • Key byte[]? (オプション)

        PEM形式の秘密鍵の直接値。

      • PfxPath string? (オプション)

        PFXまたはPKCS12エンコードされた秘密鍵と証明書チェーンへのパス。

      • Pfx byte[]? (オプション)

        PFXまたはPKCS12エンコードされた秘密鍵と証明書チェーンの直接値。

      • Passphrase string? (オプション)

        秘密鍵 (PEMまたはPFX) のパスフレーズ。

      TLSクライアント認証により、サーバーはクライアント証明書を要求して検証できます。

      詳細

      使用するクライアント証明書の配列。各証明書オブジェクトは、certPath と keyPath の両方、単一の pfxPath、またはそれらに対応する直接値の同等物 (cert と key、または pfx) を持つ必要があります。オプションで、証明書が暗号化されている場合は、passphrase プロパティを指定する必要があります。origin プロパティには、証明書が有効なリクエストオリジンと完全に一致するものを指定する必要があります。

      注

      macOSでWebKitを使用する場合、`localhost` にアクセスしてもクライアント証明書は取得されません。`localhost` を `local.playwright` に置き換えることで動作させることができます。

    • ColorScheme enum ColorScheme { Light, Dark, NoPreference, Null }? (オプション)#

      prefers-colors-scheme メディア機能をエミュレートします。サポートされている値は、'light' および 'dark' です。詳細については、Page.EmulateMediaAsync() を参照してください。'null' を渡すと、エミュレーションがシステムデフォルトにリセットされます。デフォルトは 'light' です。

    • Contrast enum Contrast { NoPreference, More, Null }? (オプション)#

      'prefers-contrast' メディア機能をエミュレートします。サポートされている値は、'no-preference'、'more' です。詳細については、Page.EmulateMediaAsync() を参照してください。'null' を渡すと、エミュレーションがシステムデフォルトにリセットされます。デフォルトは 'no-preference' です。

    • DeviceScaleFactor [float]? (オプション)#

      デバイススケールファクター (dprと考えることができます) を指定します。デフォルトは 1 です。デバイススケールファクターを使用した デバイスのエミュレーション の詳細をご覧ください。

    • ExtraHTTPHeaders IDictionary?<string, string> (オプション)#

      すべてのリクエストとともに送信される追加のHTTPヘッダーを含むオブジェクト。デフォルトはなし。

    • ForcedColors enum ForcedColors { Active, None, Null }? (オプション)#

      'forced-colors' メディア機能をエミュレートします。サポートされている値は、'active'、'none' です。詳細については、Page.EmulateMediaAsync() を参照してください。'null' を渡すと、エミュレーションがシステムデフォルトにリセットされます。デフォルトは 'none' です。

    • Geolocation Geolocation? (オプション)#

      • Latitude [float]

        -90から90の間の緯度。

      • Longitude [float]

        -180から180の間の経度。

      • Accuracy [float]? (オプション)

        負でない精度値。デフォルトは 0 です。

    • HasTouch bool? (オプション)#

      ビューポートがタッチイベントをサポートするかどうかを指定します。デフォルトは false です。モバイルエミュレーション の詳細をご覧ください。

    • HttpCredentials HttpCredentials? (オプション)#

      • Username string

      • Password string

      • Origin string? (オプション)

        特定のオリジン (scheme://host:port).

      • Send enum HttpCredentialsSend { Unauthorized, Always }? (オプション)

        このオプションは、対応する APIRequestContext から送信されたリクエストにのみ適用され、ブラウザーから送信されたリクエストには影響しません。'always' - 基本認証資格情報を含む Authorization ヘッダーが、各APIリクエストとともに送信されます。'unauthorized - 資格情報は、WWW-Authenticate ヘッダーを含む 401 (Unauthorized) レスポンスを受信した場合にのみ送信されます。デフォルトは 'unauthorized' です。

      HTTP認証 の資格情報。オリジンが指定されていない場合、ユーザー名とパスワードは、許可されていない応答時にすべてのサーバーに送信されます。

    • IgnoreHTTPSErrors bool? (オプション)#

      ネットワークリクエストを送信するときにHTTPSエラーを無視するかどうか。デフォルトは false です。

    • IsMobile bool? (オプション)#

      meta viewport タグが考慮され、タッチイベントが有効になっているかどうか。isMobile はデバイスの一部であるため、手動で設定する必要はありません。デフォルトは false であり、Firefoxではサポートされていません。モバイルエミュレーション の詳細をご覧ください。

    • JavaScriptEnabled bool? (オプション)#

      コンテキストで JavaScript を有効にするかどうか。デフォルトは true です。JavaScriptの無効化 の詳細をご覧ください。

    • Locale string? (オプション)#

      ユーザーロケール (例: en-GB、de-DE など) を指定します。ロケールは、navigator.language 値、Accept-Language リクエストヘッダー値、および数値と日付の書式設定ルールに影響します。デフォルトはシステムのデフォルトロケールです。エミュレーションガイド のエミュレーションの詳細をご覧ください。

    • Offline bool? (オプション)#

      ネットワークがオフラインになっていることをエミュレートするかどうか。デフォルトは false です。ネットワークエミュレーション の詳細をご覧ください。

    • Permissions IEnumerable?<string> (オプション)#

      このコンテキストのすべてのページに付与する権限のリスト。詳細については、BrowserContext.GrantPermissionsAsync() を参照してください。デフォルトはなし。

    • Proxy Proxy? (オプション)#

      • Server string

        すべてのリクエストに使用されるプロキシ。HTTPおよびSOCKSプロキシがサポートされています。例：http://myproxy.com:3128 または socks5://myproxy.com:3128。短縮形 `myproxy.com:3128` はHTTPプロキシと見なされます。

      • Bypass string? (オプション)

        プロキシをバイパスするためのオプションのコンマ区切りドメイン。例：`.com, chromium.org, .domain.com`。

      • Username string? (オプション)

        HTTPプロキシが認証を必要とする場合に使用するオプションのユーザー名。

      • Password string? (オプション)

        HTTPプロキシが認証を必要とする場合に使用するオプションのパスワード。

      このコンテキストで使用するネットワークプロキシ設定。デフォルトはなし。

    • RecordHarContent enum HarContentPolicy { Omit, Embed, Attach }? (オプション)#

      リソースコンテンツ管理を制御するためのオプション設定。omit が指定されている場合、コンテンツは永続化されません。attach が指定されている場合、リソースは個別のファイルとして永続化され、これらのファイルはすべてHARファイルとともにアーカイブされます。デフォルトは embed で、HAR仕様に従ってコンテンツをHARファイルにインラインで保存します。

    • RecordHarMode enum HarMode { Full, Minimal }? (オプション)#

      minimal に設定すると、HARからのルーティングに必要な情報のみを記録します。これにより、HARからの再生時に使用されないサイズ、タイミング、ページ、Cookie、セキュリティ、およびその他のタイプのHAR情報が省略されます。デフォルトは full です。

    • RecordHarOmitContent bool? (オプション)#

      HARからリクエストコンテンツを省略するかどうかを制御するためのオプション設定。デフォルトは false です。

    • RecordHarPath string? (オプション)#

      HAR の記録を、ファイルシステム上の指定されたHARファイルにすべてのページに対して有効にします。指定しない場合、HARは記録されません。HARを保存するには、BrowserContext.CloseAsync() を呼び出すようにしてください。

    • RecordHarUrlFilter|RecordHarUrlFilterRegex string? | Regex? (オプション)#

    • RecordVideoDir string? (オプション)#

      指定されたディレクトリにすべてのページのビデオ録画を有効にします。指定しない場合、ビデオは記録されません。ビデオを保存するには、BrowserContext.CloseAsync() を呼び出すようにしてください。

    • RecordVideoSize RecordVideoSize? (オプション)#

      • Width int

        ビデオフレームの幅。

      • Height int

        ビデオフレームの高さ。

      記録されたビデオの寸法。指定しない場合、サイズは 800x800 に収まるように縮小された viewport と同じになります。viewport が明示的に構成されていない場合、ビデオサイズはデフォルトで 800x450 になります。各ページの実際の画像は、指定されたサイズに収まるように必要に応じて縮小されます。

    • ReducedMotion enum ReducedMotion { Reduce, NoPreference, Null }? (オプション)#

      'prefers-reduced-motion' メディア機能をエミュレートします。サポートされている値は、'reduce'、'no-preference' です。詳細については、Page.EmulateMediaAsync() を参照してください。'null' を渡すと、エミュレーションがシステムデフォルトにリセットされます。デフォルトは 'no-preference' です。

    • ScreenSize ScreenSize? (オプション)#

      • Width int

        ページ幅（ピクセル単位）。

      • Height int

        ページ高さ（ピクセル単位）。

      window.screen を介してWebページ内で利用可能な一貫したウィンドウ画面サイズをエミュレートします。ViewportSize が設定されている場合にのみ使用されます。

    • ServiceWorkers enum ServiceWorkerPolicy { Allow, Block }? (オプション)#

      サイトがService Workerを登録できるようにするかどうか。デフォルトは 'allow' です。

      • 'allow': Service Worker を登録できます。
      • 'block': Playwright は Service Worker のすべての登録をブロックします。

    • StorageState string? (オプション)#

      指定されたストレージ状態でコンテキストを設定します。このオプションは、BrowserContext.StorageStateAsync() を介して取得したログイン情報でコンテキストを初期化するために使用できます。

    • StorageStatePath string? (オプション)追加: v1.9#

      指定されたストレージ状態でコンテキストを設定します。このオプションは、BrowserContext.StorageStateAsync() を介して取得したログイン情報でコンテキストを初期化するために使用できます。保存されたストレージ状態を含むファイルへのパス。

    • StrictSelectors bool? (オプション)#

      trueに設定すると、このコンテキストの厳密なセレクターモードを有効にします。厳密なセレクターモードでは、単一のターゲットDOM要素を意味するセレクターに対するすべての操作は、複数の要素がセレクターに一致する場合に例外をスローします。このオプションは、Locator APIには影響しません (Locatorは常に厳密です)。デフォルトは false です。厳密モードの詳細については、Locator を参照してください。

    • TimezoneId string? (オプション)#

      コンテキストのタイムゾーンを変更します。サポートされているタイムゾーンIDのリストについては、ICU's metaZones.txt を参照してください。デフォルトはシステムのタイムゾーンです。

    • UserAgent string? (オプション)#

      このコンテキストで使用する特定のユーザーエージェント。

    • ViewportSize ViewportSize? (オプション)#

      • Width int

        ページ幅（ピクセル単位）。

      • Height int

        ページ高さ（ピクセル単位）。

      各ページの一貫したビューポートをエミュレートします。デフォルトは 1280x720 ビューポートです。一貫したビューポートエミュレーションを無効にするには、ViewportSize.NoViewport を使用します。ビューポートエミュレーション の詳細をご覧ください。

      注

      ViewportSize.NoViewport 値は、デフォルトのプリセットからオプトアウトし、ビューポートをオペレーティングシステムによって定義されたホストウィンドウサイズに依存させます。これにより、テストの実行が非決定的になります。

戻り値

NewPageAsync​

v1.9より前に追加 browser.NewPageAsync

新しいブラウザーコンテキストに新しいページを作成します。このページを閉じると、コンテキストも閉じます。

これは、シングルページシナリオと短いスニペットのみに使用する必要がある便利なAPIです。製品コードとテストフレームワークは、正確なライフタイムを制御するために、Browser.NewContextAsync() に続いて BrowserContext.NewPageAsync() を明示的に作成する必要があります。

使用法

await Browser.NewPageAsync(options);

引数

  • options BrowserNewPageOptions? (オプション)

    • AcceptDownloads bool? (オプション)#

      すべての添付ファイルを自動的にダウンロードするかどうか。デフォルトは `true` で、すべてのダウンロードが受け入れられます。

    • BaseURL string? (オプション)#

      Page.GotoAsync()、Page.RouteAsync()、Page.WaitForURLAsync()、Page.RunAndWaitForRequestAsync()、または Page.RunAndWaitForResponseAsync() を使用する場合、対応するURLを構築するために URL() コンストラクターを使用することにより、ベースURLを考慮します。デフォルトでは設定されていません。例

      • baseURL: http://localhost:3000 で /bar.html に移動すると、http://localhost:3000/bar.html になります。
      • baseURL: http://localhost:3000/foo/ で ./bar.html に移動すると、http://localhost:3000/foo/bar.html になります。
      • baseURL: http://localhost:3000/foo (末尾のスラッシュなし) で ./bar.html に移動すると、http://localhost:3000/bar.html になります。

    • BypassCSP bool? (オプション)#

      ページの Content-Security-Policy のバイパスを切り替えます。デフォルトは false です。

    • ClientCertificates IEnumerable?<ClientCertificates> (オプション)追加: 1.46#

      • Origin string

        証明書が有効な正確なオリジン。オリジンには、`https` プロトコル、ホスト名、およびオプションでポートが含まれます。

      • CertPath string? (オプション)

        PEM形式の証明書を含むファイルへのパス。

      • Cert byte[]? (オプション)

        PEM形式の証明書の直接値。

      • KeyPath string? (オプション)

        PEM形式の秘密鍵を含むファイルへのパス。

      • Key byte[]? (オプション)

        PEM形式の秘密鍵の直接値。

      • PfxPath string? (オプション)

        PFXまたはPKCS12エンコードされた秘密鍵と証明書チェーンへのパス。

      • Pfx byte[]? (オプション)

        PFXまたはPKCS12エンコードされた秘密鍵と証明書チェーンの直接値。

      • Passphrase string? (オプション)

        秘密鍵 (PEMまたはPFX) のパスフレーズ。

      TLSクライアント認証により、サーバーはクライアント証明書を要求して検証できます。

      詳細

      使用するクライアント証明書の配列。各証明書オブジェクトは、certPath と keyPath の両方、単一の pfxPath、またはそれらに対応する直接値の同等物 (cert と key、または pfx) を持つ必要があります。オプションで、証明書が暗号化されている場合は、passphrase プロパティを指定する必要があります。origin プロパティには、証明書が有効なリクエストオリジンと完全に一致するものを指定する必要があります。

      注

      macOSでWebKitを使用する場合、`localhost` にアクセスしてもクライアント証明書は取得されません。`localhost` を `local.playwright` に置き換えることで動作させることができます。

    • ColorScheme enum ColorScheme { Light, Dark, NoPreference, Null }? (オプション)#

      prefers-colors-scheme メディア機能をエミュレートします。サポートされている値は、'light' および 'dark' です。詳細については、Page.EmulateMediaAsync() を参照してください。'null' を渡すと、エミュレーションがシステムデフォルトにリセットされます。デフォルトは 'light' です。

    • Contrast enum Contrast { NoPreference, More, Null }? (オプション)#

      'prefers-contrast' メディア機能をエミュレートします。サポートされている値は、'no-preference'、'more' です。詳細については、Page.EmulateMediaAsync() を参照してください。'null' を渡すと、エミュレーションがシステムデフォルトにリセットされます。デフォルトは 'no-preference' です。

    • DeviceScaleFactor [float]? (オプション)#

      デバイススケールファクター (dprと考えることができます) を指定します。デフォルトは 1 です。デバイススケールファクターを使用した デバイスのエミュレーション の詳細をご覧ください。

    • ExtraHTTPHeaders IDictionary?<string, string> (オプション)#

      すべてのリクエストとともに送信される追加のHTTPヘッダーを含むオブジェクト。デフォルトはなし。

    • ForcedColors enum ForcedColors { Active, None, Null }? (オプション)#

      'forced-colors' メディア機能をエミュレートします。サポートされている値は、'active'、'none' です。詳細については、Page.EmulateMediaAsync() を参照してください。'null' を渡すと、エミュレーションがシステムデフォルトにリセットされます。デフォルトは 'none' です。

    • Geolocation Geolocation? (オプション)#

      • Latitude [float]

        -90から90の間の緯度。

      • Longitude [float]

        -180から180の間の経度。

      • Accuracy [float]? (オプション)

        負でない精度値。デフォルトは 0 です。

    • HasTouch bool? (オプション)#

      ビューポートがタッチイベントをサポートするかどうかを指定します。デフォルトは false です。モバイルエミュレーション の詳細をご覧ください。

    • HttpCredentials HttpCredentials? (オプション)#

      • Username string

      • Password string

      • Origin string? (オプション)

        特定のオリジン (scheme://host:port).

      • Send enum HttpCredentialsSend { Unauthorized, Always }? (オプション)

        このオプションは、対応する APIRequestContext から送信されたリクエストにのみ適用され、ブラウザーから送信されたリクエストには影響しません。'always' - 基本認証資格情報を含む Authorization ヘッダーが、各APIリクエストとともに送信されます。'unauthorized - 資格情報は、WWW-Authenticate ヘッダーを含む 401 (Unauthorized) レスポンスを受信した場合にのみ送信されます。デフォルトは 'unauthorized' です。

      HTTP認証 の資格情報。オリジンが指定されていない場合、ユーザー名とパスワードは、許可されていない応答時にすべてのサーバーに送信されます。

    • IgnoreHTTPSErrors bool? (オプション)#

      ネットワークリクエストを送信するときにHTTPSエラーを無視するかどうか。デフォルトは false です。

    • IsMobile bool? (オプション)#

      meta viewport タグが考慮され、タッチイベントが有効になっているかどうか。isMobile はデバイスの一部であるため、手動で設定する必要はありません。デフォルトは false であり、Firefoxではサポートされていません。モバイルエミュレーション の詳細をご覧ください。

    • JavaScriptEnabled bool? (オプション)#

      コンテキストで JavaScript を有効にするかどうか。デフォルトは true です。JavaScriptの無効化 の詳細をご覧ください。

    • Locale string? (オプション)#

      ユーザーロケール (例: en-GB、de-DE など) を指定します。ロケールは、navigator.language 値、Accept-Language リクエストヘッダー値、および数値と日付の書式設定ルールに影響します。デフォルトはシステムのデフォルトロケールです。エミュレーションガイド のエミュレーションの詳細をご覧ください。

    • Offline bool? (オプション)#

      ネットワークがオフラインになっていることをエミュレートするかどうか。デフォルトは false です。ネットワークエミュレーション の詳細をご覧ください。

    • Permissions IEnumerable?<string> (オプション)#

      このコンテキストのすべてのページに付与する権限のリスト。詳細については、BrowserContext.GrantPermissionsAsync() を参照してください。デフォルトはなし。

    • Proxy Proxy? (オプション)#

      • Server string

        すべてのリクエストに使用されるプロキシ。HTTPおよびSOCKSプロキシがサポートされています。例：http://myproxy.com:3128 または socks5://myproxy.com:3128。短縮形 `myproxy.com:3128` はHTTPプロキシと見なされます。

      • Bypass string? (オプション)

        プロキシをバイパスするためのオプションのコンマ区切りドメイン。例：`.com, chromium.org, .domain.com`。

      • Username string? (オプション)

        HTTPプロキシが認証を必要とする場合に使用するオプションのユーザー名。

      • Password string? (オプション)

        HTTPプロキシが認証を必要とする場合に使用するオプションのパスワード。

      このコンテキストで使用するネットワークプロキシ設定。デフォルトはなし。

    • RecordHarContent enum HarContentPolicy { Omit, Embed, Attach }? (オプション)#

      リソースコンテンツ管理を制御するためのオプション設定。omit が指定されている場合、コンテンツは永続化されません。attach が指定されている場合、リソースは個別のファイルとして永続化され、これらのファイルはすべてHARファイルとともにアーカイブされます。デフォルトは embed で、HAR仕様に従ってコンテンツをHARファイルにインラインで保存します。

    • RecordHarMode enum HarMode { Full, Minimal }? (オプション)#

      minimal に設定すると、HARからのルーティングに必要な情報のみを記録します。これにより、HARからの再生時に使用されないサイズ、タイミング、ページ、Cookie、セキュリティ、およびその他のタイプのHAR情報が省略されます。デフォルトは full です。

    • RecordHarOmitContent bool? (オプション)#

      HARからリクエストコンテンツを省略するかどうかを制御するためのオプション設定。デフォルトは false です。

    • RecordHarPath string? (オプション)#

      HAR の記録を、ファイルシステム上の指定されたHARファイルにすべてのページに対して有効にします。指定しない場合、HARは記録されません。HARを保存するには、BrowserContext.CloseAsync() を呼び出すようにしてください。

    • RecordHarUrlFilter|RecordHarUrlFilterRegex string? | Regex? (オプション)#

    • RecordVideoDir string? (オプション)#

      指定されたディレクトリにすべてのページのビデオ録画を有効にします。指定しない場合、ビデオは記録されません。ビデオを保存するには、BrowserContext.CloseAsync() を呼び出すようにしてください。

    • RecordVideoSize RecordVideoSize? (オプション)#

      • Width int

        ビデオフレームの幅。

      • Height int

        ビデオフレームの高さ。

      記録されたビデオの寸法。指定しない場合、サイズは 800x800 に収まるように縮小された viewport と同じになります。viewport が明示的に構成されていない場合、ビデオサイズはデフォルトで 800x450 になります。各ページの実際の画像は、指定されたサイズに収まるように必要に応じて縮小されます。

    • ReducedMotion enum ReducedMotion { Reduce, NoPreference, Null }? (オプション)#

      'prefers-reduced-motion' メディア機能をエミュレートします。サポートされている値は、'reduce'、'no-preference' です。詳細については、Page.EmulateMediaAsync() を参照してください。'null' を渡すと、エミュレーションがシステムデフォルトにリセットされます。デフォルトは 'no-preference' です。

    • ScreenSize ScreenSize? (オプション)#

      • Width int

        ページ幅（ピクセル単位）。

      • Height int

        ページ高さ（ピクセル単位）。

      ウェブページ内で window.screen を介して利用可能な一貫したウィンドウの画面サイズをエミュレートします。ViewportSize が設定されている場合にのみ使用されます。

    • ServiceWorkers enum ServiceWorkerPolicy { Allow, Block }? (オプション)#

      サイトがService Workerを登録できるようにするかどうか。デフォルトは 'allow' です。

      • 'allow': Service Worker を登録できます。
      • 'block': Playwright は Service Worker のすべての登録をブロックします。

    • StorageState string? (オプション)#

      指定されたストレージ状態でコンテキストを設定します。このオプションは、BrowserContext.StorageStateAsync() を介して取得したログイン情報でコンテキストを初期化するために使用できます。

    • StorageStatePath string? (オプション)追加: v1.9#

      指定されたストレージ状態でコンテキストを設定します。このオプションは、BrowserContext.StorageStateAsync() を介して取得したログイン情報でコンテキストを初期化するために使用できます。保存されたストレージ状態を含むファイルへのパス。

    • StrictSelectors bool? (オプション)#

      trueに設定すると、このコンテキストの厳密なセレクターモードを有効にします。厳密なセレクターモードでは、単一のターゲットDOM要素を意味するセレクターに対するすべての操作は、複数の要素がセレクターに一致する場合に例外をスローします。このオプションは、Locator APIには影響しません (Locatorは常に厳密です)。デフォルトは false です。厳密モードの詳細については、Locator を参照してください。

    • TimezoneId string? (オプション)#

      コンテキストのタイムゾーンを変更します。サポートされているタイムゾーンIDのリストについては、ICU's metaZones.txt を参照してください。デフォルトはシステムのタイムゾーンです。

    • UserAgent string? (オプション)#

      このコンテキストで使用する特定のユーザーエージェント。

    • ViewportSize ViewportSize? (オプション)#

      • Width int

        ページ幅（ピクセル単位）。

      • Height int

        ページ高さ（ピクセル単位）。

      各ページの一貫したビューポートをエミュレートします。デフォルトは 1280x720 ビューポートです。一貫したビューポートエミュレーションを無効にするには、ViewportSize.NoViewport を使用します。ビューポートエミュレーション の詳細をご覧ください。

      注

      ViewportSize.NoViewport 値は、デフォルトのプリセットからオプトアウトし、ビューポートをオペレーティングシステムによって定義されたホストウィンドウサイズに依存させます。これにより、テストの実行が非決定的になります。

戻り値

Version​

v1.9より前に追加 browser.Version

ブラウザのバージョンを返します。

使用法

Browser.Version

戻り値

Events​

event Disconnected​

v1.9より前に追加 browser.event Disconnected

ブラウザアプリケーションからブラウザが切断されたときに発生します。これは、次のいずれかの理由で発生する可能性があります。

  • ブラウザアプリケーションが閉じられたか、クラッシュした場合。
  • Browser.CloseAsync() メソッドが呼び出された場合。

使用法

Browser.Disconnected += async (_, browser) => {};

イベントデータ