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

Browser

ブラウザはBrowserType.LaunchAsync()を介して作成されます。Browserを使用してPageを作成する例

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()を使用してこのブラウザが取得された場合、ブラウザとそのすべてのページ（開かれている場合）を閉じます。

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

注

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

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

使用法

await Browser.CloseAsync(options);

引数

  • options BrowserCloseOptions? (任意)

    • Reason string? (任意)追加されたバージョン: v1.40#

      ブラウザの閉鎖によって中断された操作に報告される理由。

戻り値

Contexts​

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

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

注

このメソッドを直接使用してBrowserContextを作成する場合、コードがBrowserContextの使用を終了した後、かつBrowser.CloseAsync()を呼び出す前に、返されたコンテキストをBrowserContext.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: https://:3000で/bar.htmlにナビゲートすると、https://:3000/bar.htmlになります。
      • baseURL: https://:3000/foo/で./bar.htmlにナビゲートすると、https://:3000/foo/bar.htmlになります。
      • baseURL: https://:3000/foo（末尾にスラッシュなし）で./bar.htmlにナビゲートすると、https://:3000/bar.htmlになります。

    • BypassCSP bool? (任意)#

      ページのコンテンツセキュリティポリシーをバイパスするかどうかを切り替えます。デフォルトは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プロパティは、証明書が有効なリクエストオリジンと正確に一致するように提供する必要があります。

      クライアント証明書認証は、少なくとも1つのクライアント証明書が提供された場合にのみ有効になります。サーバーから送信されたすべてのクライアント証明書を拒否したい場合は、訪問する予定のドメインのいずれとも一致しない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)でのhttp資格情報の送信を制限します:ポート).

      • Send enum HttpCredentialsSend { Unauthorized, Always }? (任意)

        このオプションは、対応するAPIRequestContextから送信されたリクエストにのみ適用され、ブラウザから送信されたリクエストには影響しません。'always' - 各APIリクエストで基本認証資格情報を持つAuthorizationヘッダーが送信されます。'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ファイルとともにアーカイブされます。HAR仕様に従って、コンテンツをHARファイルにインラインで保存する embed がデフォルトです。

    • RecordHarMode enum HarMode { Full, Minimal }? (任意)#

      minimalに設定すると、HARからのルーティングに必要な情報のみが記録されます。これにより、HARからリプレイするときに使用されないサイズ、タイミング、ページ、クッキー、セキュリティ、その他の種類の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

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

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

    • ServiceWorkers enum ServiceWorkerPolicy { Allow, Block }? (任意)#

      サイトがサービスワーカーを登録することを許可するかどうか。デフォルトは'allow'です。

      • 'allow': サービスワーカーを登録できます。
      • 'block': Playwrightはすべてのサービスワーカーの登録をブロックします。

    • StorageState string? (任意)#

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

    • StorageStatePath string? (任意)追加バージョン: v1.9#

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

    • StrictSelectors bool? (任意)#

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

    • TimezoneId string? (任意)#

      コンテキストのタイムゾーンを変更します。サポートされているタイムゾーンIDのリストについては、ICUの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: https://:3000で/bar.htmlにナビゲートすると、https://:3000/bar.htmlになります。
      • baseURL: https://:3000/foo/で./bar.htmlにナビゲートすると、https://:3000/foo/bar.htmlになります。
      • baseURL: https://:3000/foo（末尾にスラッシュなし）で./bar.htmlにナビゲートすると、https://:3000/bar.htmlになります。

    • BypassCSP bool? (任意)#

      ページのコンテンツセキュリティポリシーをバイパスするかどうかを切り替えます。デフォルトは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プロパティは、証明書が有効なリクエストオリジンと正確に一致するように提供する必要があります。

      クライアント証明書認証は、少なくとも1つのクライアント証明書が提供された場合にのみ有効になります。サーバーから送信されたすべてのクライアント証明書を拒否したい場合は、訪問する予定のドメインのいずれとも一致しない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)でのhttp資格情報の送信を制限します:ポート).

      • Send enum HttpCredentialsSend { Unauthorized, Always }? (任意)

        このオプションは、対応するAPIRequestContextから送信されたリクエストにのみ適用され、ブラウザから送信されたリクエストには影響しません。'always' - 各APIリクエストで基本認証資格情報を持つAuthorizationヘッダーが送信されます。'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ファイルとともにアーカイブされます。HAR仕様に従って、コンテンツをHARファイルにインラインで保存する embed がデフォルトです。

    • RecordHarMode enum HarMode { Full, Minimal }? (任意)#

      minimalに設定すると、HARからのルーティングに必要な情報のみが記録されます。これにより、HARからリプレイするときに使用されないサイズ、タイミング、ページ、クッキー、セキュリティ、その他の種類の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

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

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

    • ServiceWorkers enum ServiceWorkerPolicy { Allow, Block }? (任意)#

      サイトがサービスワーカーを登録することを許可するかどうか。デフォルトは'allow'です。

      • 'allow': サービスワーカーを登録できます。
      • 'block': Playwrightはすべてのサービスワーカーの登録をブロックします。

    • StorageState string? (任意)#

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

    • StorageStatePath string? (任意)追加バージョン: v1.9#

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

    • StrictSelectors bool? (任意)#

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

    • TimezoneId string? (任意)#

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

    • UserAgent string? (任意)#

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

    • ViewportSize ViewportSize? (任意)#

      • Width int

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

      • Height int

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

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

      注

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

戻り値

Version​

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

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

使用法

Browser.Version

戻り値

イベント​

event Disconnected​

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

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

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

使用法

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

イベントデータ