機能と EdgeOptions

  • [アーティクル]

機能は、セッションのカスタマイズと構成に使用できるオプションです EdgeDriver 。 新しい EdgeDriver セッションを開始する方法については、「 Microsoft Edge の自動化」を参照してください。 この記事では、Microsoft Edge でサポートされているすべての機能について説明し、機能をセッションに渡す方法の詳細について EdgeDriver 説明します。

機能は JSON マップとして WebDriver セッションに渡されますが、このように設定する必要も推奨もされません。 WebDriver テスト フレームワーク ( Selenium など) では、通常便利なメソッドを持つ言語バインドが提供されるため、JSON マップを自分で構成する必要はありません。 たとえば、Selenium は クラスを使用して機能を EdgeOptions 構成します。

機能を構成する方法の詳細については、推奨される WebDriver テスト フレームワークのドキュメントを参照してください。 詳細については、「 WebDriver テスト フレームワークを選択する」を参照してください。

EdgeOptions クラスの使用

の EdgeOptionsインスタンスを作成します。これにより、Microsoft Edge 固有の機能を設定するための便利なメソッドが提供されます。 オブジェクトを構成したらEdgeOptions、コンストラクターにEdgeDriver渡EdgeOptionsします。

var options = new EdgeOptions();
options.AddExtensions("/path/to/extension.crx");
var driver = new EdgeDriver(options);

便利なメソッドが関連付けられていない機能を使用するには、 メソッドを使用します AddAdditionalEdgeOption 。 機能の完全な名前と、正しい型の値を渡す必要があります。 受け入れられる機能と値の種類の完全な一覧については、「 EdgeOptions オブジェクト」を参照してください。

options.AddAdditionalEdgeOption("wdpAddress", "remotehost:50080");

認識された機能

受け入れる EdgeDriver 標準機能については、 Selenium のドキュメント と W3C WebDriver 標準に関するページを参照してください。 この記事では、Microsoft Edge に固有の機能のみを一覧表示します。

EdgeOptions オブジェクト

ほとんどの Microsoft Edge 固有の機能は、 オブジェクトを EdgeOptions 介して公開されます。 一部の言語では、 クラスによって EdgeOptions 機能が実装されます。 他の言語では、 のディクショナリDesiredCapabilitiesの下に機能がms:edgeOptions格納されます。

機能 型 詳細
args 文字列の一覧 起動時に Microsoft Edge プロセスに渡すコマンド ライン引数の一覧。 関連付けられた値を持つ引数は、['start-maximized', 'user-data-dir=/tmp/temp_profile']記号 (例: ) で=区切る必要があります。 WebView2 アプリを起動する場合、これらの引数は、基になる Microsoft Edge ブラウザー プロセスではなく、アプリに渡されます。 WebView2 アプリを起動するときにブラウザー プロセスに引数を渡すには、代わりに webviewOptions.additionalBrowserArguments を使用します。
binary 文字列 使用する Microsoft Edge バイナリへのパス (macOS の場合、パスはアプリだけでなく、実際のバイナリである必要があります)。 /Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge
debuggerAddress string などの127.0.0.1:38947形式で接続するデバッガー サーバーのhostname/ip:portアドレス。
detach ブール値 既定値 = falseです。 の場合 false、WebDriver ローカル エンドがセッションを閉じていない場合でも、WebDriver サービスのシャットダウン時に Microsoft Edge が終了します。 の場合 true、WebDriver ローカルエンドがセッションを閉じる場合にのみ、Microsoft Edge が終了します。 と WebDriver ローカル エンドでセッションが閉じられない場合true、 EdgeDriver Microsoft Edge インスタンスによって使用される一時ユーザー データ フォルダーがクリーンされません。
excludeSwitches 文字列の一覧 Microsoft Edge コマンド ラインの一覧は、Microsoft Edge の起動時に既定で EdgeDriver が渡されることを除外するように切り替えます。 スイッチのプレフィックスは -- 使用しないでください。
extensions 文字列の一覧 起動時にインストールする拡張機能の一覧。 リスト内の各項目は、base-64 でエンコードされたパックされた拡張機能 (.crx) である必要があります。
localState 辞書 基本設定の名前と値で構成される各エントリを含むディクショナリ。 基本設定は、ユーザー データ フォルダー内のローカル状態ファイルに適用されます。
minidumpPath 文字列 Microsoft Edge ミニダンプを格納するディレクトリ。 (Linux でのみサポートされます)。
mobileEmulation 辞書 の値、または および userAgentのdeviceName値deviceMetricsを持つディクショナリ。
perfLoggingPrefs 辞書 パフォーマンス ログの基本設定を指定する省略可能なディクショナリ。 詳細については、「 perfLoggingPrefs オブジェクト」を参照してください。
prefs 辞書 基本設定の名前と値で構成される各エントリを含むディクショナリ。 基本設定は、使用中のユーザー プロファイルにのみ適用されます。 たとえば、Microsoft Edge の Preferences ユーザー データ フォルダー内のファイルを参照してください。
wdpAddress string などの127.0.0.1:50080形式で接続する Windows デバイス ポータル サーバーのhostname/ip:portアドレス。 詳細については、「リモート デバッグ - Windows 10 デバイス」を参照してください。
wdpPassword 文字列 Windows デバイス ポータル サーバーに接続するときに使用する省略可能なパスワード。 サーバーで認証が有効になっている場合は必須です。
wdpUsername string Windows デバイス ポータル サーバーに接続するときに使用する省略可能なユーザー名。 サーバーで認証が有効になっている場合は必須です。
wdpProcessId integer 実行中の WebView2 UWP アプリにアタッチする場合に使用する必要なプロセス ID (例: 36590)。 この情報は、 にありますbrowserProcessIdhttp://<Device Portal URL>/msedge。
webviewOptions 辞書 WebView2 アプリを起動するときに WebView2 環境を構成するために使用できる省略可能なディクショナリ。 詳細については、「 webviewOptions オブジェクト」を参照してください。
windowsApp string 起動する Microsoft Edge アプリ パッケージのアプリケーション ユーザー モデル ID (例: Microsoft.MicrosoftEdge.Stable_8wekyb3d8bbwe!MSEDGE)。 Windows デバイス ポータルを使用してWindows 10Xデバイスまたはエミュレーターに接続する場合は、代わりに binary を使用windowsAppします。
windowTypes 文字列の一覧 ウィンドウ ハンドルの一覧に表示されるウィンドウの種類の一覧。 Android Webview 要素にアクセスするには、リストに を含 webview めます。

perfLoggingPrefs オブジェクト

ディクショナリの perfLoggingPrefs 形式は次のとおりです。 すべてのキーは省略可能です。

キー 型 既定値 詳細
bufferUsageReportingInterval 正の整数 1000 DevTools トレース バッファーの使用イベント間の要求されたミリ秒数。 たとえば、1000 が 1 秒あたり 1 回の場合、DevTools はトレース バッファーの完全な量を報告します。 レポートでバッファー使用量が 100% であることを示す場合は、警告が発行されます。
enableNetwork ブール値 true ネットワーク ドメインからイベントを収集する (または収集しない) 場合。
enablePage ブール値 true Page ドメインからイベントを収集する (または収集しない) 場合。
traceCategories string (空) トレース イベントを収集する Microsoft Edge トレース カテゴリのコンマ区切り文字列。 指定されていない文字列または空の文字列を指定すると、トレースが無効になります。

webviewOptions オブジェクト

ディクショナリは webviewOptions 、WebView2 アプリの起動時に WebView2 環境を構成するために使用されます。 形式は次のとおりです。 すべてのキーは省略可能です。

キー 型 既定値 詳細
browserExecutableFolder string (空) 使用する固定バージョンの WebView2 ランタイムを含むフォルダーへのパス。 WebView2 で固定バージョンのランタイム配布を使用する方法の詳細については、「 WebView2 アプリと WebView2 ランタイムを配布する」を参照してください。
userDataFolder string (空) WebView2 が使用するユーザー データ フォルダーへのパス。 が指定されていない場合 userDataFolder 、Microsoft Edge WebDriver は一時的なユーザー データ フォルダーを作成します。 WebView2 を使用したユーザー データ フォルダーの管理の詳細については、「 ユーザー データ フォルダーの管理」を参照してください。
additionalBrowserArguments 文字列の一覧 WebView2 が起動時にブラウザー プロセスに渡すコマンド ライン引数の一覧。 関連付けられた値を持つ引数は、['start-maximized', 'log-level=0']記号 (例: ) で=区切る必要があります。
releaseChannelPreference string 使用する優先 WebView2 常緑ランタイム分散。 または "stable" になります。"canary"

返される機能

次の一覧には、新しいセッションを作成するときに返されるすべての Microsoft Edge 固有の機能が EdgeDriver 含まれています。

機能 型 詳細
msedge.msedgedriverVersion string EdgeDriver のバージョン。
msedge.userDataDir string Microsoft Edge インスタンスで使用されるユーザー データ フォルダーへのパス。