WebDriver を使用して Microsoft Edge を自動化する

[アーティクル]
09/24/2024

WebDriver を使用すると、ユーザーの操作をシミュレートすることで Microsoft Edge を自動化できます。 WebDriver を使用するテストには、ブラウザーで実行される JavaScript 単体テストに比べていくつかの利点があります。

WebDriver は、ブラウザで実行されている JavaScript では利用できない機能や情報にアクセスします。
WebDriver は、JavaScript 単体テストよりもユーザーイベントまたは OS レベルのイベントをより正確にシミュレートします。
WebDriver は、1 回のテストセッションで、複数のウィンドウ、タブ、Web ページを管理します。
WebDriver は、特定のコンピューターで Microsoft Edge の複数のセッションを実行します。

この記事では、完全なテストではなく、生のコードサンプルを提供します。この記事では、Selenium WebDriver の使用を開始するための完全な方法を提供しませんが、プロセスの Microsoft Edge 固有の部分についてのみ説明します。これには、Microsoft Edge WebDriver の取得とコードでの Microsoft Edge 固有のオプションの設定が含まれます。

WebDriver と他のソフトウェアの関係

WebDriver を使用して Microsoft Edge を自動化し、ユーザーの操作をシミュレートするには、次の 3 つのコンポーネントが必要です。

Microsoft Edge の詳細をご覧ください。
Microsoft Edge WebDriver。
WebDriver テストフレームワーク。

これらのコンポーネント間の機能的な関係は次のとおりです。

テクノロジ	ロール
WebDriver	プラットフォームおよび言語に依存しないワイヤープロトコルの W3C 標準。このプロトコルにより、アウトプロセスプログラムは Web ブラウザーの動作をリモートで指示できます。
Microsoft Edge WebDriver	Microsoft Edge 専用の WebDriver プロトコルの Microsoft による実装。テストの作成者は、Microsoft Edge Web ドライバーが受け取る WebDriver コマンドを使用するテストを書き込みます。 Microsoft Edge WebDriver は、そのコマンドをブラウザーに通信する役割を担います。
WebDriver テストフレームワーク	テストの作成者は、テストフレームワークを使用して、エンドツーエンドのテストを書き込み、ブラウザーを自動化します。 Microsoft Edge WebDriver に送信されるコマンドにコードを変換する言語固有のインターフェイスを提供します。 WebDriver テストフレームワークは、すべての主要なプラットフォームと言語に対応しています。このようなフレームワークの 1 つは Selenium WebDriver です。
Internet Explorer ドライバー	InternetExplorer 専用の WebDriver プロトコルのオープンソース実装。 Internet Explorer モードのレガシエンドツーエンドテストを実行するには、Internet Explorer ドライバーを使用することをお勧めします。
Microsoft WebDriver (レガシ)	以前の Microsoft Edge 用のブラウザー固有のドライバー (EdgeHTML)。これは Microsoft Edge Legacy とも呼ばれます。

次のセクションでは、Microsoft Edge の WebDriver の使用を開始する方法について説明します。

Microsoft Edge WebDriver をダウンロードする

自動テストの作成を開始するには、インストールする Microsoft Edge WebDriver バージョンが Microsoft Edge のバージョンと一致していることを確認します。 4 部構成のバージョン番号の最初の 3 つの部分が一致している必要があります。

次のように、ブラウザーのバージョンに一致するバージョンの Microsoft Edge WebDriver をダウンロードしてインストールします。

edge://settings/helpに移動し、4 部構成の Microsoft Edge のバージョンを確認します。
Microsoft Edge WebDriver に移動します。
ページの [ ダウンロード ] セクションで、Microsoft Edge のバージョン番号と一致するバージョン番号の下にあるプラットフォームボタン ( x64 など) をクリックします。

4 部構成のバージョン番号の最初の 3 つの部分は、Microsoft Edge と Microsoft Edge WebDriver の間で一致する必要があります。たとえば、次のバージョンの Microsoft Edge と Microsoft Edge WebDriver は連携します。最初の 3 つの数値は同じであるためです。
- 128.0.2739.79
- 128.0.2739.84
古いバージョンをダウンロードするには、[最近使ったバージョン] セクションの下にある [完全なディレクトリに移動 ] ボタンをクリックします。
ダウンロードが完了したら、msedgedriver 実行可能ファイルを希望の場所に解凍します。実行可能ファイルが配置されているフォルダーを PATH 環境変数に追加します。

以下の「WebDriver テストフレームワークを選択する」の説明に従って、ブラウザードライバー (Microsoft Edge WebDriver) と WebDriver テストフレームワーク (Selenium WebDriver など) の両方をインストールする必要があります。これらは個別のコンポーネントです。

WebDriver テストフレームワークを選択する

Microsoft Edge WebDriver をダウンロードした後、ダウンロードする必要がある最後のコンポーネントは WebDriver テストフレームワークです。テストの作成者は、WebDriver テストフレームワークを使用して、エンドツーエンドのテストを書き込み、ブラウザーを自動化します。 WebDriver テストフレームワークには、Microsoft Edge WebDriver が Microsoft Edge で実行するコマンドにコードを変換する言語固有のインターフェイスが用意されています。 WebDriver テストフレームワークは、Python、Java、C#、Ruby、JavaScript など、すべての主要なプラットフォームと言語に対して存在します。

Microsoft Edge WebDriver は、任意の WebDriver フレームワークで使用できます。この記事では、Selenium WebDriver フレームワークを使用する手順について説明しますが、WebDriver をサポートする任意のライブラリ、フレームワーク、プログラミング言語を使用できます。

Selenium WebDriver は、WebDriver フレームワークの一般的な実装の 1 つです。 Selenium は、言語に依存しない、テストフレームワークに依存しないブラウザー間のオートメーションライブラリです。この記事では、Selenium WebDriver を例示の例としてのみ使用します。これは、ほとんどのユーザーのニーズを満たしているためです。 Selenium を使用して Microsoft Edge を自動化する場合は、Selenium 4 を使用する必要があります。Selenium 3 はサポートされなくなりました。

Selenium WebDriver 以外の WebDriver テストフレームワークを使用して同じタスクを実行するには、選択したフレームワークの公式ドキュメントを参照してください。

Selenium WebDriver の使用

使用可能な WebDriver フレームワークの 1 つは、Selenium WebDriver です。これは、Selenium のツールスイートの一部です。 Selenium WebDriver は、任意のプラットフォームで使用できるオープンソースのテストフレームワークであり、Java、Python 3、C#、Ruby、JavaScript 用の言語バインドを提供します。

Selenium を使用して Microsoft Edge を自動化する場合は、Selenium 4 を使用する必要があります。Selenium 3 はサポートされなくなりました。

お好みの言語と開発環境用に Selenium をインストールする方法の詳細については、 Selenium ライブラリのインストールに関する Selenium のドキュメントを参照してください。

WebDriver を使用して Microsoft Edge を自動化する

WebDriver を使用してブラウザーを自動化するには、まず WebDriver テストフレームワークを使用して WebDriver セッションを開始する必要があります。 セッションは、WebDriver コマンドを使用して制御されるブラウザーの 1 つの実行中のインスタンスです。

WebDriver セッションを開始して、新しいブラウザーインスタンスを起動します。 WebDriver セッションを閉じるまで、起動されたブラウザーインスタンスは開いたままです。

次のセクションでは、Selenium 4 を使用して Microsoft Edge で WebDriver セッションを開始する方法について説明します。

注

この記事では、Selenium WebDriver フレームワークを使用する手順について説明しますが、WebDriver をサポートする任意のライブラリ、フレームワーク、プログラミング言語を使用できます。別のフレームワークを使用して同じタスクを実行するには、選択したフレームワークのドキュメントを参照してください。

Microsoft Edge を自動化する

Selenium は、EdgeDriver クラスを使用して Microsoft Edge セッションを管理します。次のコードは:

Microsoft Edge セッションを開始します。
Bing に移動するように Microsoft Edge に指示します。
"WebDriver" を検索します。
数秒間スリープ状態になるため、結果を確認できます。

WebDriver で Microsoft Edge の自動化を開始するには、以下の目的の言語のコードスニペットをコピーして貼り付けます:

using OpenQA.Selenium;
using OpenQA.Selenium.Edge;
using System.Threading;

namespace EdgeDriverSample
{
    class Program
    {
        static void Main(string[] args)
        {
            var driver = new EdgeDriver();
            try
            {
                driver.Url = "https://bing.com";

                var element = driver.FindElement(By.Id("sb_form_q"));
                element.SendKeys("WebDriver");
                element.Submit();

                Thread.Sleep(5000);
            }
            finally
            {
                driver.Quit();
            }
        }
    }
}

from selenium import webdriver
from selenium.webdriver.common.by import By
import time

driver = webdriver.Edge()

driver.get('https://bing.com')

element = driver.find_element(By.ID, 'sb_form_q')
element.send_keys('WebDriver')
element.submit()

time.sleep(5)
driver.quit()

import org.openqa.selenium.By;
import org.openqa.selenium.WebElement;
import org.openqa.selenium.edge.EdgeDriver;

public class EdgeDriverSample {
    public static void main(String[] args) throws Exception {
        EdgeDriver driver = new EdgeDriver();
        try {
            driver.navigate().to("https://bing.com");

            WebElement element = driver.findElement(By.id("sb_form_q"));
            element.sendKeys("WebDriver");
            element.submit();

            Thread.sleep(5000);
        } finally {
            driver.quit();
        }
    }
}

const { Builder, By } = require('selenium-webdriver');

(async () => {
    const driver = await new Builder().forBrowser('MicrosoftEdge').build();
    try {
        await driver.get('https://bing.com');

        const element = await driver.findElement(By.id('sb_form_q'));
        await element.sendKeys('WebDriver');
        await element.submit();

        await driver.sleep(5000);
    } finally {
        await driver.quit();
    }
})();

Microsoft Edge WebDriver サービスを管理および構成する

新しい EdgeDriver オブジェクトを作成して Microsoft Edge セッションを開始すると、Selenium は、 EdgeDriver オブジェクトが通信する新しい Microsoft Edge WebDriver プロセスを起動します。 Microsoft Edge WebDriver プロセスは、 EdgeDriver オブジェクトの Quit メソッドを呼び出すと閉じられます。多くのテストがある場合、各 EdgeDriver オブジェクトに独自のドライバープロセスを管理させるのは非効率的です。これは、各テストが新しいドライバープロセスの起動を待機する必要があるためです。代わりに、1 つの Microsoft Edge WebDriver プロセスを作成し、それを複数のテストに再利用できます。

Selenium では、 EdgeDriverService クラスを使用して Microsoft Edge WebDriver プロセスを管理します。テストを実行する前に EdgeDriverService を一度作成し、新しい EdgeDriver オブジェクトを作成するときにこの EdgeDriverService オブジェクトを EdgeDriver コンストラクターに渡すことができます。 EdgeDriverService を EdgeDriver コンストラクターに渡すと、EdgeDriver オブジェクトは新しいものを作成する代わりにこの EdgeDriverService を使用します。

EdgeDriverServiceを使用して、次に示すように、Microsoft Edge WebDriver プロセスのコマンドラインオプションを構成することもできます。

次のスニペットは、新しい EdgeDriverService を作成し、詳細なログ出力を有効にします。

var service = EdgeDriverService.CreateDefaultService();
service.UseVerboseLogging = true;

var driver = new EdgeDriver(service);

from selenium import webdriver
from selenium.webdriver.edge.service import Service

service = Service(verbose = True)

driver = webdriver.Edge(service = service)

System.setProperty("webdriver.edge.verboseLogging", "true");
EdgeDriverService service = EdgeDriverService.createDefaultService();

EdgeDriver driver = new EdgeDriver(service);

const edge = require('selenium-webdriver/edge');

const service = new edge.ServiceBuilder().enableVerboseLogging().build();

const options = new edge.Options();
const driver = edge.Driver.createSession(options, service);

Microsoft Edge オプションを構成する

EdgeOptions オブジェクトを EdgeDriver コンストラクターに渡して、Microsoft Edge ブラウザープロセスの追加オプションを構成できます。次のセクションでは、いくつかの一般的なシナリオで EdgeOptions を使用する方法を示します。サポートされているオプションの完全なリストについては、「機能と EdgeOptions」を参照してください。

特定のブラウザーバイナリを選択する

特定の Microsoft Edge バイナリを使用して WebDriver セッションを開始できます。たとえば、Microsoft Edge ベータ版、Dev、Canary などの Microsoft Edge プレビューチャネルを使用してテストを実行できます。

var options = new EdgeOptions();
options.BinaryLocation = @"C:\Program Files (x86)\Microsoft\Edge Beta\Application\msedge.exe";

var driver = new EdgeDriver(options);

from selenium import webdriver
from selenium.webdriver.edge.options import Options

options = Options()
options.binary_location = r"C:\Program Files (x86)\Microsoft\Edge Beta\Application\msedge.exe"

driver = webdriver.Edge(options = options)

EdgeOptions options = new EdgeOptions();
options.setBinary("C:\\Program Files (x86)\\Microsoft\\Edge Beta\\Application\\msedge.exe");

EdgeDriver driver = new EdgeDriver(options);

const edge = require('selenium-webdriver/edge');

let options = new edge.Options();
options.setBinaryPath("C:\\Program Files (x86)\\Microsoft\\Edge Beta\\Application\\msedge.exe");

let driver = edge.Driver.createSession(options);

追加のコマンドライン引数を渡す

EdgeOptions を使用して、セッションの作成時に Microsoft Edge ブラウザープロセスに渡されるコマンドライン引数を構成できます。たとえば、ヘッドレスモードで実行するようにブラウザを設定できます。

var options = new EdgeOptions();
options.AddArgument("headless");

var driver = new EdgeDriver(options);

from selenium import webdriver
from selenium.webdriver.edge.options import Options

options = Options()
options.add_argument("headless")

driver = webdriver.Edge(options = options)

EdgeOptions options = new EdgeOptions();
options.addArguments("headless");

EdgeDriver driver = new EdgeDriver(options);

const edge = require('selenium-webdriver/edge');

let options = new edge.Options();
options.addArguments("headless");

let driver = edge.Driver.createSession(options);

その他の WebDriver インストールオプション

Docker

Docker を使用する場合は、次のコマンドを実行して、Microsoft Edge と EdgeWebDriver が事前にインストールされている構成済みのイメージをダウンロードします。

docker run -d -p 9515:9515 mcr.microsoft.com/msedge/msedgedriver

詳細については、「DockerHub の msedgedriver コンテナ」を参照してください。

Application Guard

Microsoft Defender Application Guardを使用する信頼されたサイトは、Microsoft Edge WebDriver を使用して自動化できます。 Microsoft Defender Application Guard は Application Guard とも呼ばれます。

Application Guardを使用する信頼されていないサイトは、Microsoft Edge WebDriver を使用して自動化または操作することはできません。 Application Guardはコンテナー内の信頼されていないサイトを起動します。このコンテナーでは、Microsoft Edge WebDriver がサイトと通信するために必要なリモートデバッグポートは公開されません。

エンタープライズ管理者は、クラウドリソースや内部ネットワークなど、信頼済みサイトを定義します。信頼済みサイトのリストにないサイトは、信頼できないと見なされます。 Microsoft Edge WebDriver では、InPrivate ウィンドウと信頼されたサイトリスト内のサイトの両方を自動化できます。

Application Guard の詳細については、以下を参照してください。

診断データの収集をオプトアウトする

既定では、Microsoft Edge WebDriver は、新しいセッション WebDriver コマンドの状態などの診断データを Microsoft に送信します。 Microsoft Edge WebDriver の診断データ収集をオフにするには、 MSEDGEDRIVER_TELEMETRY_OPTOUT 環境変数を 1 に設定します。 Microsoft Edge WebDriver が収集するデータの詳細については、「Microsoft Edge プライバシーホワイトペーパーの Microsoft Edge WebDriver」を参照してください。

従来の Microsoft WebDriver for EdgeHTML

Microsoft WebDriver は、EdgeHTML ベースの Microsoft Edge の従来の WebDriver 実装です。レガシ Microsoft Edge (EdgeHTML) が OS で更新されたため、Microsoft WebDriver は省略可能な Windows コンポーネントとして配布されました。 Microsoft WebDriver は、最新の Chromium ベースのバージョンの Microsoft Edge と互換性がありません。 Microsoft WebDriver は、UWP アプリの WebDriver ベースのテストを作成した開発者が引き続き利用できます。これは、これらが EdgeHTML に依存しているためですが、Microsoft WebDriver は推奨されなくなりました。

WebDriver (EdgeHTML) を参照してください。

トラブルシューティング

WebDriver を使用して Microsoft Edge を自動化する際のトラブルシューティングの考慮事項を次に示します。

開発者ツールの可用性ポリシー

IT 管理者が DeveloperToolsAvailability ポリシーを 2 に設定している場合、ドライバーは Microsoft Edge DevTools を使用するため、Microsoft Edge WebDriver では Microsoft Edge の駆動がブロックされます。 Microsoft Edge を自動化するには、DeveloperToolsAvailability ポリシーが 0 または 1 に設定されていることを確認してください。

Visual Studio テンプレートの使用

単純なテストプロジェクトを作成する Visual Studio で提供される Microsoft Edge WebDriver テンプレートを使用している場合は、次の作業が完了していることを確認してください。

Microsoft Edge WebDriver をダウンロードし、PATH で使用できることを確認します。
WebDriver フレームワーク ( Selenium.WebDriver NuGet パッケージなど) をプロジェクトに追加します。

これらの手順を実行すると、Bingに移動するサンプルテストが正常に完了します。

Microsoft Edge 用 Selenium Tools によるエラー

新しい EdgeDriver インスタンスを作成しようとすると、次のエラーが発生する場合: System.MissingMethodException: 'Method not found: 'OpenQA.Selenium.Remote.DesiredCapabilities OpenQA.Selenium.DriverOptions.GenerateDesiredCapabilities(Boolean)'、以下の「Selenium 3 から Selenium 4 へのアップグレード」を参照してください。

Selenium 3 から Selenium 4 へのアップグレード

Selenium Tools for Microsoft Edge を使用して Selenium 3 ブラウザーテストに Microsoft Edge サポートを追加した場合は、次のようにテストを Selenium 4 に更新します。

プロジェクトから [Microsoft Edge 用の Selenium ツール]を削除します。
代わりに Selenium 4 が提供する組み込みの EdgeDriver および関連するクラスを使用するようにテストを更新します。既存の Selenium 3 テストを Selenium 4 にアップグレードする必要があります。 Selenium 4 へのアップグレードの詳細については、「Selenium 4 へのアップグレード」を参照してください。
EdgeOptions.UseChromium プロパティのすべての使用法を削除します。 Selenium 4 では Microsoft Edge (Chromium ブラウザーエンジン) のみがサポートされているため、このプロパティは Selenium 4 に存在しなくなりました。

Selenium 3 はサポートされていません

WebDriver を使用して Microsoft Edge を自動化するには、Selenium を使用している場合は、Selenium 4 を使用していることを確認してください。 Selenium 3 はサポートされていません。

Selenium を使用するすべての新しいプロジェクトでは、Selenium 4 を使用する必要があります。 WebDriver を使用して Microsoft Edge を自動化するには、Selenium を使用している場合は、Selenium 4 を使用していることを確認してください。 Selenium 3 はサポートされなくなりました。

Microsoft Edge 用 Selenium Tools が使用されなくなりました

Selenium 4 には、Microsoft Edge 用の Selenium Tools は必要ありません。 Microsoft Edge 用の Selenium Tools は Selenium 3 専用でした。

Selenium 4 には既に Microsoft Edge のサポートが組み込まれているため、Selenium 4 を Microsoft Edge 用 Selenium Tools で使用しないでください。 Microsoft Edge 用 Selenium Tools を使用しようとすると、新しい EdgeDriver インスタンスを作成しようとすると、 System.MissingMethodException: 'Method not found: 'OpenQA.Selenium.Remote.DesiredCapabilities OpenQA.Selenium.DriverOptions.GenerateDesiredCapabilities(Boolean)'というエラーが表示されます。 Selenium 4 を使用していてこのエラーが発生した場合は、プロジェクトから Microsoft.Edge.SeleniumTools を削除し、OpenQA.Selenium.Edge 名前空間の公式の EdgeOptions クラスと EdgeDriver クラスを使用していることを確認します。

次の方法で共有

WebDriver を使用して Microsoft Edge を自動化する

WebDriver と他のソフトウェアの関係

Microsoft Edge WebDriver をダウンロードする

WebDriver テストフレームワークを選択する

Selenium WebDriver の使用

WebDriver を使用して Microsoft Edge を自動化する

Microsoft Edge を自動化する

Microsoft Edge WebDriver サービスを管理および構成する

Microsoft Edge オプションを構成する

特定のブラウザーバイナリを選択する

追加のコマンドライン引数を渡す

その他の WebDriver インストールオプション

Docker

Application Guard

診断データの収集をオプトアウトする

従来の Microsoft WebDriver for EdgeHTML

トラブルシューティング

開発者ツールの可用性ポリシー

Visual Studio テンプレートの使用

Microsoft Edge 用 Selenium Tools によるエラー

Selenium 3 から Selenium 4 へのアップグレード

Selenium 3 はサポートされていません

Microsoft Edge 用 Selenium Tools が使用されなくなりました

関連項目

フィードバック

その他のリソース

次の方法で共有

WebDriver を使用して Microsoft Edge を自動化する

WebDriver と他のソフトウェアの関係

Microsoft Edge WebDriver をダウンロードする

WebDriver テスト フレームワークを選択する

Selenium WebDriver の使用

WebDriver を使用して Microsoft Edge を自動化する

Microsoft Edge を自動化する

Microsoft Edge WebDriver サービスを管理および構成する

Microsoft Edge オプションを構成する

特定のブラウザー バイナリを選択する

追加のコマンド ライン引数を渡す

その他の WebDriver インストール オプション

Docker

Application Guard

診断データの収集をオプトアウトする

従来の Microsoft WebDriver for EdgeHTML

トラブルシューティング

開発者ツールの可用性ポリシー

Visual Studio テンプレートの使用

Microsoft Edge 用 Selenium Tools によるエラー

Selenium 3 から Selenium 4 へのアップグレード

Selenium 3 はサポートされていません

Microsoft Edge 用 Selenium Tools が使用されなくなりました

関連項目

フィードバック

その他のリソース

WebDriver テストフレームワークを選択する

特定のブラウザーバイナリを選択する

追加のコマンドライン引数を渡す

その他の WebDriver インストールオプション