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

BrowserType

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

import com.microsoft.playwright.*;

public class Example {
  public static void main(String[] args) {
    try (Playwright playwright = Playwright.create()) {
      BrowserType chromium = playwright.chromium();
      Browser browser = chromium.launch();
      Page page = browser.newPage();
      page.navigate("https://example.com");
      // other actions...
      browser.close();
    }
  }
}

メソッド​

connect​

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

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

注意

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

使用方法

BrowserType.connect(wsEndpoint);
BrowserType.connect(wsEndpoint, options);

引数

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

    接続するPlaywrightブラウザのWebSocketエンドポイント。このエンドポイントはBrowserServer.wsEndpointを介して取得します。

  • options BrowserType.ConnectOptions (任意)

    • setExposeNetwork 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. "<loopback>"はlocalhostネットワークを公開します。
      3. "*.test.internal-domain,*.staging.internal-domain,<loopback>"はテスト/ステージングのデプロイとlocalhostを公開します。

    • setHeaders Map<String, String> (任意)追加バージョン: v1.11#

      ウェブソケット接続リクエストと共に送信される追加のHTTPヘッダー。任意。

    • setSlowMo double (任意)追加バージョン: v1.10#

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

    • setTimeout double (任意)追加バージョン: v1.10#

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

戻り値

connectOverCDP​

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

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

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

注意

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

注意

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

使用方法

Browser browser = playwright.chromium().connectOverCDP("https://:9222");
BrowserContext defaultContext = browser.contexts().get(0);
Page page = defaultContext.pages().get(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 BrowserType.ConnectOverCDPOptions (任意)

    • setHeaders Map<String, String> (任意)追加バージョン: v1.11#

      接続リクエストとともに送信される追加のHTTPヘッダー。任意。

    • setSlowMo double (任意)追加バージョン: v1.11#

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

    • setTimeout double (任意)追加バージョン: v1.11#

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

戻り値

executablePath​

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

Playwrightがバンドルされたブラウザ実行可能ファイルを見つけることを期待するパス。

使用方法

BrowserType.executablePath();

戻り値

launch​

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

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

使用方法

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

// Or "firefox" or "webkit".
Browser browser = chromium.launch(new BrowserType.LaunchOptions()
  .setIgnoreDefaultArgs(Arrays.asList("--mute-audio")));

Chromiumのみ PlaywrightはGoogle ChromeまたはMicrosoft Edgeブラウザを制御するためにも使用できますが、バンドルされているChromiumのバージョンで最もよく機能します。他のバージョンで機能するという保証はありません。setExecutablePathオプションは非常に注意して使用してください。

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

Google ChromeやMicrosoft Edgeのようなストックブラウザは、ビデオ再生にプロプライエタリメディアコーデックを必要とするテストに適しています。ChromiumとChromeのその他の違いについてはこの記事を参照してください。Linuxユーザー向けの違いについてはこの記事を参照してください。

引数

  • options BrowserType.LaunchOptions (任意)

    • setArgs List<String> (任意)#

      警告

      カスタムブラウザ引数を使用すると、Playwrightの機能が損なわれる可能性があるため、自己責任で使用してください。

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

    • setChannel String (任意)#

      ブラウザ配布チャネル。

      新しいヘッドレスモードをオプトインするには「chromium」を使用してください。ブラウザについて

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

    • setChromiumSandbox boolean (任意)#

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

    • setDevtools boolean (任意)#

      非推奨

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

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

    • setDownloadsPath Path (任意)#

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

    • setEnv Map<String, String> (任意)#

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

    • setExecutablePath Path (任意)#

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

    • setFirefoxUserPrefs Map<String, Object> (任意)#

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

    • setHandleSIGHUP boolean (任意)#

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

    • setHandleSIGINT boolean (任意)#

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

    • setHandleSIGTERM boolean (任意)#

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

    • setHeadless boolean (任意)#

      ブラウザをヘッドレスモードで実行するかどうか。詳細についてはChromiumとFirefoxを参照してください。setDevtoolsオプションがtrueでない限り、デフォルトはtrueです。

    • setIgnoreAllDefaultArgs boolean (任意)追加バージョン: v1.9#

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

    • setIgnoreDefaultArgs List<String> (任意)#

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

    • setProxy Proxy (任意)#

      • setServer String

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

      • setBypass String (任意)

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

      • setUsername String (任意)

        HTTPプロキシで認証が必要な場合に使用する任意のユーザー名。

      • setPassword String (任意)

        HTTPプロキシで認証が必要な場合に使用する任意のパスワード。

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

    • setSlowMo double (任意)#

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

    • setTimeout double (任意)#

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

    • setTracesDir Path (任意)#

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

戻り値

launchPersistentContext​

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

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

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

使用方法

BrowserType.launchPersistentContext(userDataDir);
BrowserType.launchPersistentContext(userDataDir, options);

引数

  • userDataDir Path#

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

    詳細についてはChromiumおよびFirefoxを参照してください。Chromiumのユーザーデータディレクトリは、chrome://versionで表示される「Profile Path」の親ディレクトリです。

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

  • options BrowserType.LaunchPersistentContextOptions (任意)

    • setAcceptDownloads boolean (任意)#

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

    • setArgs List<String> (任意)#

      警告

      カスタムブラウザ引数を使用すると、Playwrightの機能が損なわれる可能性があるため、自己責任で使用してください。

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

    • setBaseURL String (任意)#

      Page.navigate()、Page.route()、Page.waitForURL()、Page.waitForRequest()、またはPage.waitForResponse()を使用する際、対応する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になります。

    • setBypassCSP boolean (任意)#

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

    • setChannel String (任意)#

      ブラウザ配布チャネル。

      新しいヘッドレスモードをオプトインするには「chromium」を使用してください。ブラウザについて

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

    • setChromiumSandbox boolean (任意)#

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

    • setClientCertificates List<ClientCertificates> (任意)追加バージョン: 1.46#

      • setOrigin String

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

      • setCertPath Path (任意)

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

      • setCert byte[] (任意)

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

      • setKeyPath Path (任意)

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

      • setKey byte[] (任意)

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

      • setPfxPath Path (任意)

        PFXまたはPKCS12エンコードされた秘密鍵および証明書チェーンのファイルパス。

      • setPfx byte[] (任意)

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

      • setPassphrase String (任意)

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

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

      詳細

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

      注意

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

    • setColorScheme null | enum ColorScheme { LIGHT, DARK, NO_PREFERENCE } (任意)#

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

    • setContrast null | enum Contrast { NO_PREFERENCE, MORE } (任意)#

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

    • setDeviceScaleFactor double (任意)#

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

    • setDevtools boolean (任意)#

      非推奨

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

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

    • setDownloadsPath Path (任意)#

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

    • setEnv Map<String, String> (任意)#

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

    • setExecutablePath Path (任意)#

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

    • setExtraHTTPHeaders Map<String, String> (任意)#

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

    • setFirefoxUserPrefs Map<String, Object> (任意)追加バージョン: v1.40#

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

    • setForcedColors null | enum ForcedColors { ACTIVE, NONE } (任意)#

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

    • setGeolocation Geolocation (任意)#

      • setLatitude double

        -90から90までの緯度。

      • setLongitude double

        -180から180までの経度。

      • setAccuracy double (任意)

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

    • setHandleSIGHUP boolean (任意)#

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

    • setHandleSIGINT boolean (任意)#

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

    • setHandleSIGTERM boolean (任意)#

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

    • setHasTouch boolean (任意)#

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

    • setHeadless boolean (任意)#

      ブラウザをヘッドレスモードで実行するかどうか。詳細についてはChromiumとFirefoxを参照してください。setDevtoolsオプションがtrueでない限り、デフォルトはtrueです。

    • setHttpCredentials HttpCredentials (任意)#

      • setUsername String

      • setPassword String

      • setOrigin String (任意)

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

      • setSend enum HttpCredentialsSend { UNAUTHORIZED, ALWAYS } (任意)

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

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

    • setIgnoreAllDefaultArgs boolean (任意)追加バージョン: v1.9#

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

    • setIgnoreDefaultArgs List<String> (任意)#

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

    • setIgnoreHTTPSErrors boolean (任意)#

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

    • setIsMobile boolean (任意)#

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

    • setJavaScriptEnabled boolean (任意)#

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

    • setLocale String (任意)#

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

    • setOffline boolean (任意)#

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

    • setPermissions List<String> (任意)#

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

    • setProxy Proxy (任意)#

      • setServer String

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

      • setBypass String (任意)

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

      • setUsername String (任意)

        HTTPプロキシで認証が必要な場合に使用する任意のユーザー名。

      • setPassword String (任意)

        HTTPプロキシで認証が必要な場合に使用する任意のパスワード。

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

    • setRecordHarContent enum HarContentPolicy { OMIT, EMBED, ATTACH } (任意)#

      リソースコンテンツ管理を制御する任意のパラメータ。omitが指定された場合、コンテンツは保持されません。attachが指定された場合、リソースは個別のファイルとして保持され、これらのファイルすべてがHARファイルと一緒にアーカイブされます。HAR仕様に従い、コンテンツをHARファイル内にインラインで保存するembedがデフォルトです。

    • setRecordHarMode enum HarMode { FULL, MINIMAL } (任意)#

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

    • setRecordHarOmitContent boolean (任意)#

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

    • setRecordHarPath Path (任意)#

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

    • setRecordHarUrlFilter String | Pattern (任意)#

    • setRecordVideoDir Path (任意)#

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

    • setRecordVideoSize RecordVideoSize (任意)#

      • setWidth int

        ビデオフレームの幅。

      • setHeight int

        ビデオフレームの高さ。

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

    • setReducedMotion null | enum ReducedMotion { REDUCE, NO_PREFERENCE } (任意)#

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

    • setScreenSize ScreenSize (任意)#

      • setWidth int

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

      • setHeight int

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

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

    • setServiceWorkers enum ServiceWorkerPolicy { ALLOW, BLOCK } (任意)#

      サイトがService Workerを登録することを許可するかどうか。デフォルトは'allow'です。

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

    • setSlowMo double (任意)#

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

    • setStrictSelectors boolean (任意)#

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

    • setTimeout double (任意)#

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

    • setTimezoneId String (任意)#

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

    • setTracesDir Path (任意)#

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

    • setUserAgent String (任意)#

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

    • setViewportSize null | ViewportSize (任意)#

      • setWidth int

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

      • setHeight int

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

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

      注意

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

戻り値

name​

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

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

使用方法

BrowserType.name();

戻り値