BrowserType

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

同期

from playwright.sync_api import sync_playwright, Playwright

def run(playwright: Playwright):
    chromium = playwright.chromium
    browser = chromium.launch()
    page = browser.new_page()
    page.goto("https://example.com")
    # other actions...
    browser.close()

with sync_playwright() as playwright:
    run(playwright)

非同期

import asyncio
from playwright.async_api import async_playwright, Playwright

async def run(playwright: Playwright):
    chromium = playwright.chromium
    browser = await chromium.launch()
    page = await browser.new_page()
    await page.goto("https://example.com")
    # other actions...
    await browser.close()

async def main():
    async with async_playwright() as playwright:
        await run(playwright)
asyncio.run(main())

---

メソッド

connect

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

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

注

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

使用法

browser_type.connect(ws_endpoint)
browser_type.connect(ws_endpoint, **kwargs)

引数

• ws_endpoint str追加バージョン: v1.10#

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

• expose_network str (オプション)追加されたバージョン: 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 Dict[str, str] (オプション)追加されたバージョン: v1.11#

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

• slow_mo float (オプション)追加バージョン: v1.10#

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

• timeout float (オプション)追加バージョン: v1.10#

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

戻り値

• ブラウザ#

---

connect_over_cdp

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

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

デフォルトのブラウザコンテキストは browser.contexts 経由でアクセスできます。

注

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

注

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

使用法

同期

browser = playwright.chromium.connect_over_cdp("https://:9222")
default_context = browser.contexts[0]
page = default_context.pages[0]

非同期

browser = await playwright.chromium.connect_over_cdp("https://:9222")
default_context = browser.contexts[0]
page = default_context.pages[0]

引数

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

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

• headers Dict[str, str] (オプション)追加されたバージョン: v1.11#

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

• slow_mo float (オプション)追加されたバージョン: v1.11#

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

• timeout float (オプション)追加されたバージョン: v1.11#

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

戻り値

• ブラウザ#

---

launch

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

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

使用法

デフォルト引数から --mute-audio を除外するには、ignore_default_args を使用できます

同期

browser = playwright.chromium.launch( # or "firefox" or "webkit".
    ignore_default_args=["--mute-audio"]
)

非同期

browser = await playwright.chromium.launch( # or "firefox" or "webkit".
    ignore_default_args=["--mute-audio"]
)

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

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

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

引数

• args List[str] (オプション)#

  警告

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

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

• channel str (オプション)#

  ブラウザ配布チャネル。

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

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

• chromium_sandbox bool (オプション)#

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

• devtools bool (オプション)#

  非推奨

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

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

• downloads_path Union[str, pathlib.Path] (オプション)#

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

• env Dict[str, str | float | bool] (オプション)#

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

• executable_path Union[str, pathlib.Path] (オプション)#

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

• firefox_user_prefs Dict[str, str | float | bool] (オプション)#

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

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

• handle_sighup bool (オプション)#

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

• handle_sigint bool (オプション)#

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

• handle_sigterm bool (オプション)#

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

• headless bool (オプション)#

  ブラウザをヘッドレスモードで実行するかどうか。ChromiumとFirefoxの詳細。デフォルトはtrueですが、devtoolsオプションがtrueの場合は異なります。

• ignore_default_args bool | List[str] (オプション)#

  trueの場合、Playwrightは独自の構成引数を渡さず、argsからの引数のみを使用します。配列が与えられた場合、与えられたデフォルト引数をフィルタリングします。危険なオプションですので、注意して使用してください。デフォルトはfalseです。

• proxy Dict (オプション)#

  • server str

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

  • bypass str (オプション)

    プロキシをバイパスするオプションのカンマ区切りドメイン。例: ".com, chromium.org, .domain.com"。

  • username str (オプション)

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

  • password str (オプション)

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

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

• slow_mo float (オプション)#

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

• timeout float (オプション)#

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

• traces_dir Union[str, pathlib.Path] (オプション)#

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

戻り値

• ブラウザ#

---

launch_persistent_context

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

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

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

使用法

browser_type.launch_persistent_context(user_data_dir)
browser_type.launch_persistent_context(user_data_dir, **kwargs)

引数

• user_data_dir Union[str, pathlib.Path]#

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

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

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

  警告

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

• accept_downloads bool (オプション)#

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

• args List[str] (オプション)#

  警告

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

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

• base_url str (オプション)#

  page.goto()、page.route()、page.wait_for_url()、page.expect_request()、またはpage.expect_response()を使用する場合、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になります。

• bypass_csp bool (オプション)#

  ページのコンテンツセキュリティポリシーをバイパスするかどうかを切り替えます。デフォルトはfalseです。

• channel str (オプション)#

  ブラウザ配布チャネル。

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

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

• chromium_sandbox bool (オプション)#

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

• client_certificates List[Dict] (オプション)追加されたバージョン: 1.46#

  • origin str

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

  • certPath Union[str, pathlib.Path] (オプション)

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

  • cert bytes (オプション)

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

  • keyPath Union[str, pathlib.Path] (オプション)

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

  • key bytes (オプション)

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

  • pfxPath Union[str, pathlib.Path] (オプション)

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

  • pfx bytes (オプション)

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

  • passphrase str (オプション)

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

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

  詳細

  使用するクライアント証明書の配列。各証明書オブジェクトは、certPathとkeyPathの両方、単一のpfxPath、またはそれらに対応する直接値（certとkey、またはpfx）のいずれかを持っている必要があります。オプションで、証明書が暗号化されている場合はpassphraseプロパティを提供する必要があります。originプロパティは、証明書が有効なリクエストオリジンと正確に一致するように提供する必要があります。

  クライアント証明書認証は、少なくとも1つのクライアント証明書が提供された場合にのみ有効になります。サーバーから送信されたすべてのクライアント証明書を拒否したい場合は、訪問する予定のドメインのいずれとも一致しないoriginを持つクライアント証明書を提供する必要があります。

  注

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

• color_scheme "light" | "dark" | "no-preference" | "null" (オプション)#

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

• contrast "no-preference" | "more" | "null" (オプション)#

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

• device_scale_factor float (オプション)#

  デバイスのスケールファクター（dprとして考えることができます）を指定します。デフォルトは1です。デバイススケールファクターによるデバイスのエミュレーションについて詳しく学ぶことができます。

• devtools bool (オプション)#

  非推奨

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

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

• downloads_path Union[str, pathlib.Path] (オプション)#

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

• env Dict[str, str | float | bool] (オプション)#

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

• executable_path Union[str, pathlib.Path] (オプション)#

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

• extra_http_headers Dict[str, str] (オプション)#

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

• firefox_user_prefs Dict[str, str | float | bool] (オプション)追加されたバージョン: v1.40#

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

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

• forced_colors "active" | "none" | "null" (オプション)#

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

• geolocation Dict (オプション)#

  • latitude float

    -90から90の間の緯度。

  • longitude float

    -180から180の間の経度。

  • accuracy float (オプション)

    非負の精度値。デフォルトは0です。

• handle_sighup bool (オプション)#

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

• handle_sigint bool (オプション)#

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

• handle_sigterm bool (オプション)#

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

• has_touch bool (オプション)#

  ビューポートがタッチイベントをサポートするかどうかを指定します。デフォルトはfalseです。モバイルエミュレーションについて詳しく学ぶことができます。

• headless bool (オプション)#

  ブラウザをヘッドレスモードで実行するかどうか。ChromiumとFirefoxの詳細。デフォルトはtrueですが、devtoolsオプションがtrueの場合は異なります。

• http_credentials Dict (オプション)#

  • username str

  • password str

  • origin str (オプション)

    特定のオリジン(scheme://host:port)でのhttp資格情報の送信を制限します:ポート).

  • send "unauthorized" | "always" (optional)

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

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

• ignore_default_args bool | List[str] (オプション)#

  trueの場合、Playwrightは独自の構成引数を渡さず、argsからの引数のみを使用します。配列が与えられた場合、与えられたデフォルト引数をフィルタリングします。危険なオプションですので、注意して使用してください。デフォルトはfalseです。

• ignore_https_errors bool (オプション)#

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

• is_mobile bool (オプション)#

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

• java_script_enabled bool (オプション)#

  コンテキストでJavaScriptを有効にするかどうか。デフォルトはtrueです。JavaScriptの無効化について詳しく学ぶことができます。

• locale str (オプション)#

  ユーザーのロケールを指定します。例えば、en-GB、de-DEなどです。ロケールは、navigator.languageの値、Accept-Languageリクエストヘッダーの値、および数値と日付の書式設定ルールに影響を与えます。デフォルトはシステムデフォルトのロケールです。エミュレーションガイドでエミュレーションについて詳しく学ぶことができます。

• no_viewport bool (オプション)#

  固定ビューポートを強制せず、ヘッドモードでのウィンドウサイズ変更を許可します。

• offline bool (オプション)#

  ネットワークがオフラインであることをエミュレートするかどうか。デフォルトはfalseです。ネットワークエミュレーションについて詳しく学ぶことができます。

• permissions List[str] (オプション)#

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

• proxy Dict (オプション)#

  • server str

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

  • bypass str (オプション)

    プロキシをバイパスするオプションのカンマ区切りドメイン。例: ".com, chromium.org, .domain.com"。

  • username str (オプション)

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

  • password str (オプション)

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

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

• record_har_content "omit" | "embed" | "attach" (オプション)#

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

• record_har_mode "full" | "minimal" (オプション)#

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

• record_har_omit_content bool (オプション)#

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

• record_har_path Union[str, pathlib.Path] (オプション)#

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

• record_har_url_filter str | Pattern (オプション)#

• record_video_dir Union[str, pathlib.Path] (オプション)#

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

• record_video_size Dict (オプション)#

  • width int

    ビデオフレームの幅。

  • height int

    ビデオフレームの高さ。

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

• reduced_motion "reduce" | "no-preference" | "null" (オプション)#

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

• screen Dict (オプション)#

  • width int

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

  • height int

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

  viewportが設定されている場合にのみ使用されます。

• service_workers "allow" | "block" (オプション)#

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

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

• slow_mo float (オプション)#

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

• strict_selectors bool (オプション)#

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

• timeout float (オプション)#

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

• timezone_id str (オプション)#

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

• traces_dir Union[str, pathlib.Path] (オプション)#

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

• user_agent str (オプション)#

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

• viewport NoneType | Dict (オプション)#

  • width int

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

  • height int

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

  各ページに一貫したビューポートを設定します。デフォルトは1280x720ビューポートです。no_viewportは固定ビューポートを無効にします。ビューポートエミュレーションについて詳しく学ぶことができます。

戻り値

• BrowserContext#

---

プロパティ

executable_path

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

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

使用法

browser_type.executable_path

戻り値

• str#

---

name

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

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

使用法

browser_type.name

戻り値

• str#