Edge固有の機能
これらは、Microsoft Edgeブラウザに固有のCapabilityです。
Microsoft EdgeはChromiumで実装されており、サポートされている最も古いバージョンはv79です。
Chromeと同様に、edgedriverのメジャー バージョン番号は、Edgeブラウザのメジャーバージョンと一致する必要があります。
Chromeページ にあるすべての機能とオプションは、Edgeでも機能します。
オプション
すべてのブラウザに共通する機能はオプション ページに記載されています。
Chromiumに特有の機能は、GoogleのCapabilities & ChromeOptionsページに文書化されています。
基本的な定義済みオプションを使用して Edgeセッションを開始すると、次のようになります。
/examples/java/src/test/java/dev/selenium/browsers/EdgeTest.java
/examples/python/tests/browsers/test_edge.py
/examples/dotnet/SeleniumDocs/Browsers/EdgeTest.cs
/examples/ruby/spec/browsers/edge_spec.rb
/examples/javascript/test/getting_started/openEdgeTest.spec.js
引数
args パラメータは、ブラウザを起動する際に使用されるコマンドラインスイッチのリストです。これらの引数を調査するための優れたリソースが2つあります:
一般的に使用される引数には、--start-maximized および --headless=new が含まれます。 and --user-data-dir=...
オプションに引数を追加します。
/examples/java/src/test/java/dev/selenium/browsers/EdgeTest.java
/examples/python/tests/browsers/test_edge.py
/examples/dotnet/SeleniumDocs/Browsers/EdgeTest.cs
/examples/ruby/spec/browsers/edge_spec.rb
/examples/javascript/test/browser/edgeSpecificCaps.spec.js
指定された場所でブラウザを起動する
binary パラメータは、使用するブラウザの代替位置のパスを指定します。このパラメータを使用すると、chromedriverを利用してさまざまなChromiumベースのブラウザを操作できます。
オプションにブラウザの場所を追加する:
/examples/java/src/test/java/dev/selenium/browsers/EdgeTest.java
/examples/python/tests/browsers/test_edge.py
/examples/dotnet/SeleniumDocs/Browsers/EdgeTest.cs
/examples/ruby/spec/browsers/edge_spec.rb
拡張機能を追加する
extensions パラメータは、crxファイルを受け入れます。展開されたディレクトリについては、load-extension 引数を使用してください。このことはこの投稿で言及されています。
オプションに拡張機能を追加する:
/examples/java/src/test/java/dev/selenium/browsers/EdgeTest.java
/examples/python/tests/browsers/test_edge.py
/examples/dotnet/SeleniumDocs/Browsers/EdgeTest.cs
/examples/ruby/spec/browsers/edge_spec.rb
/examples/javascript/test/browser/edgeSpecificCaps.spec.js
ブラウザを開いたままにする
detach パラメータをtrue に設定すると、プロセスが終了した後でもブラウザが開いたままになります。ただし、quit コマンドがドライバーに送信されない限り、ブラウザは開いたままになります。
注意: これはすでにJavaのデフォルトの動作です。
/examples/python/tests/browsers/test_edge.py
注意: これはすでに.NETのデフォルトの動作です。
/examples/ruby/spec/browsers/edge_spec.rb
/examples/javascript/test/browser/edgeSpecificCaps.spec.js
引数を除外する
MSEdgedriverには、ブラウザを起動するために使用されるいくつかのデフォルト引数があります。それらの引数を追加したくない場合は、excludeSwitchesに渡してください。一般的な例は、ポップアップブロッカーを再度オンにすることです。デフォルト引数の完全なリストはChromium Source Codeから解析できます。
オプションに除外された引数を設定する:
/examples/java/src/test/java/dev/selenium/browsers/EdgeTest.java
/examples/python/tests/browsers/test_edge.py
/examples/dotnet/SeleniumDocs/Browsers/EdgeTest.cs
/examples/ruby/spec/browsers/edge_spec.rb
/examples/javascript/test/browser/edgeSpecificCaps.spec.js
サービス
デフォルトのサービスオブジェクトを作成するための例や、ドライバの場所とポートを設定する例は、Driver Service ページにあります。
ログ出力
ドライバのログを取得することは、問題をデバッグするのに役立ちます。サービスクラスを使用すると、ログの出力先を指定できます。ユーザーがどこかにログを指示しない限り、ログ出力は無視されます。
ファイル出力
特定のファイルに保存するようにログ出力を変更するには、以下のようにします:
Selenium v4.10
/examples/java/src/test/java/dev/selenium/browsers/EdgeTest.java
注意: Javaでもシステムプロパティを使用してファイル出力を設定できます:
プロパティキー: EdgeDriverService.EDGE_DRIVER_LOG_PROPERTY
プロパティ値: ログファイルのパスを表す文字列
/examples/python/tests/browsers/test_edge.py
/examples/dotnet/SeleniumDocs/Browsers/EdgeTest.cs
Selenium v4.10
/examples/ruby/spec/browsers/edge_spec.rb
コンソール出力
ログ出力をコンソールにSTDOUTとして表示するには:
Selenium v4.10
/examples/java/src/test/java/dev/selenium/browsers/EdgeTest.java
注: Javaでは、システムプロパティを使用してコンソール出力を設定することもできます。
プロパティキー: EdgeDriverService.EDGE_DRIVER_LOG_PROPERTY
プロパティ値:DriverService.LOG_STDOUT または DriverService.LOG_STDERR
Selenium v4.11
/examples/python/tests/browsers/test_edge.py
$stdout と $stderrはどちらも有効な値です。
Selenium v4.10
/examples/ruby/spec/browsers/edge_spec.rb
ログレベル
利用可能なログレベルは6つあります:ALL, DEBUG, INFO, WARNING, SEVEREおよび OFF。--verbose は --log-level=ALL と同等であり、--silent は--log-level=OFFと同等です。したがって、この例ではログレベルを一般的に設定しています:
Selenium v4.8
/examples/java/src/test/java/dev/selenium/browsers/EdgeTest.java
注意: Javaでは、システムプロパティを使用してログレベルを設定することもできます:
プロパティキー: EdgeDriverService.EDGE_DRIVER_LOG_LEVEL_PROPERTY
プロパティ値:ChromiumDriverLogLevel 列挙型の文字列表現
/examples/python/tests/browsers/test_edge.py
Selenium v4.10
/examples/ruby/spec/browsers/edge_spec.rb
ログファイルの機能
ファイルにログを記録する際にのみ利用可能な2つの機能があります:
これらを使用するには、ログパスとログレベルも明示的に指定する必要があります。ログ出力はプロセスではなくドライバによって管理されるため、若干の違いが見られることがあります。
Selenium v4.8
/examples/java/src/test/java/dev/selenium/browsers/EdgeTest.java
注意: Javaでは、これらの機能をSystem Propertyによって切り替えることもできます:
プロパティキー:EdgeDriverService.EDGE_DRIVER_APPEND_LOG_PROPERTY および EdgeDriverService.EDGE_DRIVER_READABLE_TIMESTAMP
プロパティ値: "true" または "false"
/examples/python/tests/browsers/test_edge.py
Selenium v4.8
/examples/ruby/spec/browsers/edge_spec.rb
ビルドチェックの無効化
Edge ブラウザとmsedgedriverのバージョンは一致する必要があり、一致しない場合はドライバにエラーが表示されます。ビルドチェックを無効にすると、任意のバージョンのEdgeでドライバを強制的に使用できます。
この機能はサポートされていないことに注意してください。バグは調査されません。
Selenium v4.8
/examples/java/src/test/java/dev/selenium/browsers/EdgeTest.java
注: Javaでは、システムプロパティを使用してビルドチェックを無効にすることもできます:
プロパティキー:EdgeDriverService.EDGE_DRIVER_DISABLE_BUILD_CHECK
プロパティ値: "true" または "false"
/examples/python/tests/browsers/test_edge.py
/examples/dotnet/SeleniumDocs/Browsers/EdgeTest.cs
Selenium v4.8
/examples/ruby/spec/browsers/edge_spec.rb
Internet Explorer Compatibility モード
Microsoft Edge は、Internet Explorer ドライバークラスを Microsoft Edgeと組み合わせて使用する
“Internet Explorer 互換モード"で動かすことができます。
詳細については、Internet Explorerページを参照してください。
特別な機能
一部のブラウザは、それぞれ特有の追加機能を実装しています。
キャスティング
Edge を使用して Chrome Cast デバイスを操作し、タブを共有することができます。
/examples/java/src/test/java/dev/selenium/browsers/EdgeTest.java
/examples/python/tests/browsers/test_edge.py
/examples/ruby/spec/browsers/edge_spec.rb
ネットワーク条件
さまざまなネットワーク条件をシミュレートすることができます。
/examples/java/src/test/java/dev/selenium/browsers/EdgeTest.java
/examples/python/tests/browsers/test_edge.py
/examples/ruby/spec/browsers/edge_spec.rb
ログ
/examples/java/src/test/java/dev/selenium/browsers/EdgeTest.java
/examples/python/tests/browsers/test_edge.py
/examples/ruby/spec/browsers/edge_spec.rb
権限
/examples/java/src/test/java/dev/selenium/browsers/EdgeTest.java
/examples/python/tests/browsers/test_edge.py
/examples/ruby/spec/browsers/edge_spec.rb
EdgeでDevToolsを使用する際の詳細については、[Chrome DevTools]セクションを参照してください。