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

BrowserType

BrowserTypeは、特定のブラウザインスタンスを起動したり、既存のインスタンスに接続したりするためのメソッドを提供します。Playwrightを使用して自動化を推進する典型的な例を以下に示します。

using Microsoft.Playwright;
using System.Threading.Tasks;

class BrowserTypeExamples
{
    public static async Task Run()
    {
        using var playwright = await Playwright.CreateAsync();
        var chromium = playwright.Chromium;
        var browser = await chromium.LaunchAsync();
        var page = await browser.NewPageAsync();
        await page.GotoAsync("https://www.bing.com");
        // other actions
        await browser.CloseAsync();
    }
}

メソッド​

ConnectAsync​

v1.9より前に追加 browserType.ConnectAsync

このメソッドは、Node.jsのBrowserType.launchServerによって作成された既存のブラウザインスタンスにPlaywrightを接続します。

注

接続するPlaywrightインスタンスのメジャーバージョンとマイナーバージョンは、ブラウザを起動するPlaywrightのバージョンと一致する必要があります (1.2.3 → 1.2.xと互換性があります)。

使用法

await BrowserType.ConnectAsync(wsEndpoint, options);

引数

  • wsEndpoint string追加バージョン: v1.10#

    接続するPlaywrightブラウザのwebsocketエンドポイント。このエンドポイントはBrowserServer.wsEndpoint経由で取得します。

  • options BrowserTypeConnectOptions? (任意)

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

      このオプションは、接続クライアントで利用可能なネットワークを接続先のブラウザに公開します。カンマで区切られたルールリストで構成されます。

      利用可能なルール

      1. ホスト名パターン。例: example.com, *.org:99, x.*.y.com, *foo.org。
      2. IPリテラル。例: 127.0.0.1, 0.0.0.0:99, [::1], [0:0::1]:99。
      3. ローカルループバックインターフェースに一致する<loopback>: localhost, *.localhost, 127.0.0.1, [::1]。

      いくつかの一般的な例

      1. すべてのネットワークを公開する"*"。
      2. localhostネットワークを公開する"<loopback>"。
      3. テスト/ステージングデプロイメントとlocalhostを公開する"*.test.internal-domain,*.staging.internal-domain,<loopback>"。

    • Headers IDictionary?<string, string> (任意)追加されたバージョン: v1.11#

      Webソケット接続リクエストと共に送信される追加のHTTPヘッダー。オプション。

    • SlowMo [float]? (任意)追加バージョン: v1.10#

      指定されたミリ秒数だけPlaywrightの操作を遅くします。何が起こっているかを確認するのに便利です。デフォルトは0です。

    • Timeout [float]? (任意)追加バージョン: v1.10#

      接続が確立されるまで待機する最大時間（ミリ秒単位）。デフォルトは0（タイムアウトなし）です。

戻り値

ConnectOverCDPAsync​

追加バージョン: v1.9 browserType.ConnectOverCDPAsync

このメソッドは、Chrome DevTools Protocolを使用して既存のブラウザインスタンスにPlaywrightを接続します。

デフォルトのブラウザコンテキストは Browser.Contexts を介してアクセスできます。

注

Chrome DevTools Protocol経由の接続は、Chromiumベースのブラウザでのみサポートされています。

注

この接続は、BrowserType.ConnectAsync() を介した Playwright プロトコル接続よりも忠実度が著しく低いです。問題が発生している場合や高度な機能を使用しようとしている場合は、おそらく BrowserType.ConnectAsync() を使用することをお勧めします。

使用法

var browser = await playwright.Chromium.ConnectOverCDPAsync("https://:9222");
var defaultContext = browser.Contexts[0];
var page = defaultContext.Pages[0];

引数

  • endpointURL string追加されたバージョン: v1.11#

    接続するCDP websocketエンドポイントまたはhttp url。例: https://:9222/ または ws://127.0.0.1:9222/devtools/browser/387adf4c-243f-4051-a181-46798f4a46f4。

  • options BrowserTypeConnectOverCDPOptions? (任意)

    • Headers IDictionary?<string, string> (任意)追加されたバージョン: v1.11#

      接続要求とともに送信される追加のHTTPヘッダー。オプション。

    • SlowMo [float]? (任意)追加されたバージョン: v1.11#

      指定されたミリ秒数だけPlaywrightの操作を遅くします。何が起こっているかを確認するのに便利です。デフォルトは0です。

    • Timeout [float]? (任意)追加されたバージョン: v1.11#

      接続が確立されるまで待機する最大時間（ミリ秒単位）。デフォルトは30000（30秒）です。タイムアウトを無効にするには0を渡します。

戻り値

ExecutablePath​

v1.9より前に追加 browserType.ExecutablePath

Playwrightがバンドルされたブラウザ実行ファイルを見つけると予想されるパス。

使用法

BrowserType.ExecutablePath

戻り値

LaunchAsync​

v1.9より前に追加 browserType.LaunchAsync

ブラウザインスタンスを返します。

使用法

IgnoreDefaultArgs を使用して、デフォルトの引数から --mute-audio を除外できます。

var browser = await playwright.Chromium.LaunchAsync(new() {
    IgnoreDefaultArgs = new[] { "--mute-audio" }
});

Chromium-only Playwright は Google Chrome または Microsoft Edge ブラウザの制御にも使用できますが、バンドルされている Chromium のバージョンで最適に動作します。他のバージョンで動作することは保証されません。ExecutablePath オプションは細心の注意を払って使用してください。

Google Chrome（Chromiumではない）を好む場合は、Chrome CanaryまたはDev Channelビルドが推奨されます。

Google ChromeやMicrosoft Edgeのような純正ブラウザは、ビデオ再生に独自のメディアコーデックを必要とするテストに適しています。ChromiumとChromeのその他の違いについては、こちらの記事を参照してください。こちらの記事では、Linuxユーザー向けのいくつかの違いを説明しています。

引数

  • options BrowserTypeLaunchOptions? (任意)

    • Args IEnumerable?<string> (任意)#

      警告

      一部のカスタムブラウザ引数はPlaywrightの機能を破壊する可能性があるため、自己責任で使用してください。

      ブラウザインスタンスに渡す追加の引数。Chromiumフラグのリストはこちらで見つけることができます。

    • Channel string? (任意)#

      ブラウザ配布チャネル。

      新しいヘッドレスモードをオプトインするには、「chromium」を使用します。

      ブランド化された Google Chrome および Microsoft Edge を使用するには、「chrome」、「chrome-beta」、「chrome-dev」、「chrome-canary」、「msedge」、「msedge-beta」、「msedge-dev」、または「msedge-canary」を使用します。

    • ChromiumSandbox bool? (任意)#

      Chromiumサンドボックスを有効にします。デフォルトはfalseです。

    • Devtools bool? (任意)#

      非推奨

      代わりに デバッグツール を使用してください。

      Chromium-only 各タブで開発者ツールパネルを自動的に開くかどうか。このオプションが true の場合、Headless オプションは false に設定されます。

    • DownloadsPath string? (任意)#

      指定されている場合、受け入れられたダウンロードはこのディレクトリにダウンロードされます。そうでない場合、一時ディレクトリが作成され、ブラウザが閉じられると削除されます。いずれの場合も、ダウンロードは作成されたブラウザコンテキストが閉じられると削除されます。

    • Env IDictionary?<string, string> (任意)#

      ブラウザに表示される環境変数を指定します。デフォルトはprocess.envです。

    • ExecutablePath string? (任意)#

      バンドルされているブラウザの代わりに実行するブラウザ実行可能ファイルへのパス。ExecutablePath が相対パスの場合、現在の作業ディレクトリからの相対パスとして解決されます。Playwright はバンドルされている Chromium、Firefox、または WebKit でのみ動作することに注意してください。自己責任でご使用ください。

    • FirefoxUserPrefs IDictionary?<string, [object]> (任意)#

      Firefoxのユーザー設定。Firefoxのユーザー設定の詳細については、about:configを参照してください。

      カスタムのpolicies.jsonファイルへのパスをPLAYWRIGHT_FIREFOX_POLICIES_JSON環境変数経由で提供することもできます。

    • HandleSIGHUP bool? (任意)#

      SIGHUPでブラウザプロセスを閉じます。デフォルトはtrueです。

    • HandleSIGINT bool? (任意)#

      Ctrl-Cでブラウザプロセスを閉じます。デフォルトはtrueです。

    • HandleSIGTERM bool? (任意)#

      SIGTERMでブラウザプロセスを閉じます。デフォルトはtrueです。

    • Headless bool? (任意)#

      ブラウザをヘッドレスモードで実行するかどうか。Chromium および Firefox の詳細。デフォルトは true です。ただし、Devtools オプションが true の場合は除きます。

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

      true の場合、Playwright は独自の構成引数を渡さず、Args の引数のみを使用します。危険なオプションですので、注意して使用してください。デフォルトは false です。

    • IgnoreDefaultArgs IEnumerable?<string> (任意)#

      true の場合、Playwright は独自の構成引数を渡さず、Args の引数のみを使用します。危険なオプションですので、注意して使用してください。

    • 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プロキシが認証を必要とする場合に使用するオプションのパスワード。

      ネットワークプロキシ設定。

    • SlowMo [float]? (任意)#

      Playwrightの操作を、指定されたミリ秒数だけ遅らせます。何が起こっているかを確認するのに役立ちます。

    • Timeout [float]? (任意)#

      ブラウザインスタンスが起動するまで待機する最大時間（ミリ秒単位）。デフォルトは30000（30秒）です。タイムアウトを無効にするには0を渡します。

    • TracesDir string? (任意)#

      指定されている場合、トレースはこのディレクトリに保存されます。

戻り値

LaunchPersistentContextAsync​

v1.9より前に追加 browserType.LaunchPersistentContextAsync

永続的なブラウザコンテキストインスタンスを返します。

userDataDir にある永続ストレージを使用するブラウザを起動し、唯一のコンテキストを返します。このコンテキストを閉じると、ブラウザが自動的に閉じられます。

使用法

await BrowserType.LaunchPersistentContextAsync(userDataDir, options);

引数

  • userDataDir string#

    クッキーやローカルストレージなどのブラウザセッションデータを保存するユーザーデータディレクトリへのパス。一時ディレクトリを作成するには空の文字列を渡します。

    ChromiumおよびFirefoxの詳細。Chromiumのユーザーデータディレクトリは、chrome://versionで表示される「プロファイルパス」の親ディレクトリです。

    ブラウザは同じユーザーデータディレクトリで複数のインスタンスを起動できないことに注意してください。

    警告

    Chromium/Chrome: 最近のChromeポリシー変更により、デフォルトのChromeユーザープロファイルの自動化はサポートされていません。userDataDirをChromeのメインの「ユーザーデータ」ディレクトリ（通常のブラウジングに使用されるプロファイル）に指定すると、ページの読み込みが失敗したり、ブラウザが終了したりする可能性があります。代わりに、独自の自動化プロファイルとして別のディレクトリ（例：空のフォルダ）を作成して使用してください。詳細については、https://developer.chrome.com/blog/remote-debugging-portを参照してください。

  • options BrowserTypeLaunchPersistentContextOptions? (任意)

    • AcceptDownloads bool? (任意)#

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

    • Args IEnumerable?<string> (任意)#

      警告

      一部のカスタムブラウザ引数はPlaywrightの機能を破壊する可能性があるため、自己責任で使用してください。

      ブラウザインスタンスに渡す追加の引数。Chromiumフラグのリストはこちらで見つけることができます。

    • 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です。

    • Channel string? (任意)#

      ブラウザ配布チャネル。

      新しいヘッドレスモードをオプトインするには、「chromium」を使用します。

      ブランド化された Google Chrome および Microsoft Edge を使用するには、「chrome」、「chrome-beta」、「chrome-dev」、「chrome-canary」、「msedge」、「msedge-beta」、「msedge-dev」、または「msedge-canary」を使用します。

    • ChromiumSandbox bool? (任意)#

      Chromiumサンドボックスを有効にします。デフォルトは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 です。デバイススケールファクターによるデバイスのエミュレート の詳細。

    • Devtools bool? (任意)#

      非推奨

      代わりに デバッグツール を使用してください。

      Chromium-only 各タブで開発者ツールパネルを自動的に開くかどうか。このオプションが true の場合、Headless オプションは false に設定されます。

    • DownloadsPath string? (任意)#

      指定されている場合、受け入れられたダウンロードはこのディレクトリにダウンロードされます。そうでない場合、一時ディレクトリが作成され、ブラウザが閉じられると削除されます。いずれの場合も、ダウンロードは作成されたブラウザコンテキストが閉じられると削除されます。

    • Env IDictionary?<string, string> (任意)#

      ブラウザに表示される環境変数を指定します。デフォルトはprocess.envです。

    • ExecutablePath string? (任意)#

      バンドルされているブラウザの代わりに実行するブラウザ実行可能ファイルへのパス。ExecutablePath が相対パスの場合、現在の作業ディレクトリからの相対パスとして解決されます。Playwright はバンドルされている Chromium、Firefox、または WebKit でのみ動作することに注意してください。自己責任でご使用ください。

    • ExtraHTTPHeaders IDictionary?<string, string> (任意)#

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

    • FirefoxUserPrefs IDictionary?<string, [object]> (任意)追加されたバージョン: v1.40#

      Firefoxのユーザー設定。Firefoxのユーザー設定の詳細については、about:configを参照してください。

      カスタムのpolicies.jsonファイルへのパスをPLAYWRIGHT_FIREFOX_POLICIES_JSON環境変数経由で提供することもできます。

    • 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です。

    • HandleSIGHUP bool? (任意)#

      SIGHUPでブラウザプロセスを閉じます。デフォルトはtrueです。

    • HandleSIGINT bool? (任意)#

      Ctrl-Cでブラウザプロセスを閉じます。デフォルトはtrueです。

    • HandleSIGTERM bool? (任意)#

      SIGTERMでブラウザプロセスを閉じます。デフォルトはtrueです。

    • HasTouch bool? (任意)#

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

    • Headless bool? (任意)#

      ブラウザをヘッドレスモードで実行するかどうか。Chromium および Firefox の詳細。デフォルトは true です。ただし、Devtools オプションが true の場合は除きます。

    • 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認証用の資格情報。オリジンが指定されていない場合、ユーザー名とパスワードは、不正な応答があった場合にすべてのサーバーに送信されます。

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

      true の場合、Playwright は独自の構成引数を渡さず、Args の引数のみを使用します。危険なオプションですので、注意して使用してください。デフォルトは false です。

    • IgnoreDefaultArgs IEnumerable?<string> (任意)#

      true の場合、Playwright は独自の構成引数を渡さず、Args の引数のみを使用します。危険なオプションですので、注意して使用してください。

    • 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はすべてのサービスワーカーの登録をブロックします。

    • SlowMo [float]? (任意)#

      Playwrightの操作を、指定されたミリ秒数だけ遅らせます。何が起こっているかを確認するのに役立ちます。

    • StrictSelectors bool? (任意)#

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

    • Timeout [float]? (任意)#

      ブラウザインスタンスが起動するまで待機する最大時間（ミリ秒単位）。デフォルトは30000（30秒）です。タイムアウトを無効にするには0を渡します。

    • TimezoneId string? (任意)#

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

    • TracesDir string? (任意)#

      指定されている場合、トレースはこのディレクトリに保存されます。

    • UserAgent string? (任意)#

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

    • ViewportSize ViewportSize? (任意)#

      • Width int

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

      • Height int

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

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

      注

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

戻り値

Name​

v1.9より前に追加 browserType.Name

ブラウザ名を返します。例えば、'chromium'、'webkit'、または'firefox'です。

使用法

BrowserType.Name

戻り値