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

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()` を呼び出す**前**に、`Browser.NewContextAsync()` を使用して明示的に作成した 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` プロパティは、証明書が有効なリクエストのオリジンと完全に一致するように指定する必要があります。

      注

      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) でHTTP資格情報を送信しないように制限する:port).

      • 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ファイルとともにアーカイブされます。デフォルトは `embed` で、HAR仕様に従ってコンテンツをHARファイル内にインラインで保存します。

    • 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

        ビデオフレームの高さ。

      記録されたビデオの寸法。指定されていない場合、サイズは `viewport` を800x800に収まるように縮小したものと等しくなります。`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の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` プロパティは、証明書が有効なリクエストのオリジンと完全に一致するように指定する必要があります。

      注

      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) でHTTP資格情報を送信しないように制限する:port).

      • 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ファイルとともにアーカイブされます。デフォルトは `embed` で、HAR仕様に従ってコンテンツをHARファイル内にインラインで保存します。

    • 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

        ビデオフレームの高さ。

      記録されたビデオの寸法。指定されていない場合、サイズは `viewport` を800x800に収まるように縮小したものと等しくなります。`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のmetaZones.txtを参照してください。デフォルトはシステムのタイムゾーンです。

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

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

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

      • Width int

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

      • Height int

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

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

      注

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

戻り値

バージョン​

追加バージョン: v1.9以前 browser.Version

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

使用方法

Browser.Version

戻り値

イベント​

イベント Disconnected​

追加バージョン: v1.9以前 browser.event Disconnected

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

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

使用方法

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

イベントデータ