機能と EdgeOptions

2025-06-21

機能は、 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`	string	使用する 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`場合、Microsoft Edge は、WebDriver ローカルエンドがセッションを閉じる場合にのみ終了します。 `true`、WebDriver ローカルエンドがセッションを閉じていない場合、`EdgeDriver`は Microsoft Edge インスタンスによって使用される一時ユーザーデータフォルダーをクリーンしません。
`excludeSwitches`	文字列のリスト	Microsoft Edge コマンドラインの一覧は、Microsoft Edge の起動時に既定で EdgeDriver が渡されることを除外するように切り替えます。スイッチの `--` プレフィックスは使用しないでください。
`extensions`	文字列のリスト	起動時にインストールする拡張機能の一覧。リスト内の各項目は、base-64 でエンコードされたパックされた拡張機能 (`.crx`) である必要があります。
`localState`	ディクショナリ	ユーザー設定の名前と値で構成される各エントリを含むディクショナリ。基本設定は、ユーザーデータフォルダー内のローカル状態ファイルに適用されます。
`minidumpPath`	string	Microsoft Edge ミニダンプを格納するディレクトリ。 (Linux でのみサポートされます)。
`mobileEmulation`	ディクショナリ	`deviceName`の値を持つディクショナリ、または`deviceMetrics`と`userAgent`の値。
`perfLoggingPrefs`	ディクショナリ	パフォーマンスログの基本設定を指定する省略可能なディクショナリ。詳細については、「 perfLoggingPrefs オブジェクト」を参照してください。
`prefs`	ディクショナリ	ユーザー設定の名前と値で構成される各エントリを含むディクショナリ。基本設定は、使用中のユーザープロファイルにのみ適用されます。たとえば、Microsoft Edge のユーザーデータフォルダーにある `Preferences` ファイルを参照してください。
`wdpAddress`	string	`127.0.0.1:50080`など、`hostname/ip:port`の形式で接続する Windows デバイスポータルサーバーのアドレス。詳細については、「リモートで Windows デバイスをデバッグする」を参照してください。
`wdpPassword`	string	Windows デバイスポータルサーバーに接続するときに使用する省略可能なパスワード。サーバーで認証が有効になっている場合は必須です。
`wdpUsername`	string	Windows デバイスポータルサーバーに接続するときに使用する省略可能なユーザー名。サーバーで認証が有効になっている場合は必須です。
`wdpProcessId`	integer	実行中の WebView2 UWP アプリにアタッチする場合に使用する必要なプロセス ID (たとえば、 `36590`)。この情報は、`http://<Device Portal URL>/msedge`の`browserProcessId`にあります。
`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"`

返される機能

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

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