Использование WebDriver для автоматизации Microsoft Edge

Статья
09/24/2024

WebDriver позволяет автоматизировать Microsoft Edge, моделируя взаимодействие с пользователем. Тесты, использующие WebDriver, имеют некоторые преимущества по сравнению с модульными тестами JavaScript, выполняемыми в браузере:

WebDriver обращается к функциям и сведениям, недоступным для JavaScript, работающего в браузерах.
WebDriver имитирует события пользователя или события уровня ОС более точно, чем модульные тесты JavaScript.
WebDriver управляет несколькими окнами, вкладками и веб-страницами в одном тестовом сеансе.
WebDriver запускает несколько сеансов Microsoft Edge на определенном компьютере.

В этой статье приведены необработанные примеры кода, а не завершенные тесты. В этой статье не приводятся полные инструкции по началу работы с Selenium WebDriver, но рассматриваются только части процесса, относящиеся к Microsoft Edge. Сюда входит получение Microsoft Edge WebDriver и настройка параметров Microsoft Edge в коде.

Связь между WebDriver и другим программным обеспечением

Чтобы автоматизировать Microsoft Edge с помощью WebDriver для имитации взаимодействия с пользователем, вам потребуется три компонента:

Microsoft Edge.
Microsoft Edge WebDriver.
Платформа тестирования WebDriver.

Функциональная связь между этими компонентами выглядит следующим образом:

Технология	Роль
WebDriver	Стандарт W3C для протокола провода, не зависящий от платформы и языка. Этот протокол позволяет внепроцессным программам удаленно инструктировать поведение веб-браузеров.
Microsoft Edge WebDriver	Реализация протокола WebDriver корпорацией Майкрософт специально для Microsoft Edge. Авторы тестов пишут тесты, использующие команды WebDriver, получаемые Microsoft Edge WebDriver. Microsoft Edge WebDriver затем отвечает за передачу этой команды в браузер.
Платформа тестирования WebDriver	Авторы тестов используют платформу тестирования для написания комплексных тестов и автоматизации браузеров. Предоставляет интерфейс для конкретного языка, который преобразует код в команды, отправляемые в Microsoft Edge WebDriver. Платформы тестирования WebDriver существуют для всех основных платформ и языков. Одной из таких платформ является Selenium WebDriver.
Драйвер Обозреватель Интернета	Реализация протокола WebDriver с открытым кодом специально для интернет-Обозреватель. Для выполнения комплексных тестов прежних версий для режима Обозреватель Интернета рекомендуется использовать Драйвер Обозреватель Интернета.
Microsoft WebDriver (устаревшая версия)	Предыдущий, зависящий от браузера драйвер для Microsoft Edge (EdgeHTML), который также известен как устаревшая версия Microsoft Edge.

В следующих разделах описано, как приступить к работе с WebDriver для Microsoft Edge.

Скачать Microsoft Edge WebDriver

Чтобы начать написание автоматических тестов, убедитесь, что установленная версия Microsoft Edge WebDriver соответствует вашей версии Microsoft Edge. Первые три части номера версии из четырех частей должны совпадать.

Скачайте и установите версию Microsoft Edge WebDriver, соответствующую вашей версии браузера, следующим образом:

Перейдите по edge://settings/help адресу и обратите внимание на свою версию Microsoft Edge, четырехкомпонентный номер:
Перейдите в Microsoft Edge WebDriver.
В разделе Загрузки страницы нажмите кнопку платформы (например, x64) под номером версии, который соответствует вашему номеру версии Microsoft Edge:

Первые три части четырехкомпонентного номера версии должны совпадать между Microsoft Edge и Microsoft Edge WebDriver. Например, следующие версии Microsoft Edge и Microsoft Edge WebDriver будут работать вместе, так как первые три числа совпадают:
- 128.0.2739.79
- 128.0.2739.84
Чтобы скачать более старые версии, нажмите кнопку Перейти к полному каталогу под разделом Последние версии .
После завершения загрузки извлеките исполняемый файл в msedgedriver предпочитаемое расположение. Добавьте папку, в которой находится исполняемый файл, в PATH переменную среды.

Необходимо установить драйвер браузера (Microsoft Edge WebDriver) и платформу тестирования WebDriver (например, Selenium WebDriver), как описано в разделе Выбор платформы тестирования 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. Selenium — это межбраузерная библиотека автоматизации, которая не зависит от языка и платформы тестирования. В этой статье selenium WebDriver используется только в качестве иллюстрированного примера, так как он соответствует потребностям большинства пользователей. Если вы используете Selenium для автоматизации Microsoft Edge, необходимо использовать Selenium 4; Selenium 3 больше не поддерживается.

Чтобы выполнить те же задачи с помощью платформы тестирования WebDriver, отличной от Selenium WebDriver, обратитесь к официальной документации по выбранной платформе.

Использование Selenium WebDriver

Одной из возможных платформ WebDriver, которую можно использовать, является Selenium WebDriver, которая входит в набор инструментов Selenium. Selenium WebDriver — это платформа тестирования с открытым кодом, которая может использоваться на любой платформе и предоставляет языковые привязки для Java, Python 3, C#, Ruby и JavaScript.

Если вы используете Selenium для автоматизации Microsoft Edge, необходимо использовать Selenium 4; Selenium 3 больше не поддерживается.

Подробные инструкции по установке Selenium для предпочитаемого языка и среды разработки см. в документации Selenium по установке библиотеки Selenium.

Автоматизация Microsoft Edge с помощью WebDriver

Чтобы автоматизировать браузер с помощью WebDriver, необходимо сначала запустить сеанс WebDriver с помощью платформы тестирования WebDriver. Сеанс WebDriver — это один запущенный экземпляр браузера, управляемый с помощью команд WebDriver.

Запустите сеанс WebDriver, чтобы запустить новый экземпляр браузера. Запущенный экземпляр браузера остается открытым до закрытия сеанса WebDriver.

В следующем разделе описывается использование Selenium 4 для запуска сеанса WebDriver в Microsoft Edge.

Примечание.

В этой статье содержатся инструкции по использованию платформы Selenium WebDriver, но вы можете использовать любую библиотеку, платформу и язык программирования, поддерживающий WebDriver. Чтобы выполнить те же задачи с помощью другой платформы, обратитесь к документации по выбранной платформе.

Автоматизация Microsoft Edge

Selenium использует класс для EdgeDriver управления сеансом Microsoft Edge. Следующий код:

Запускает сеанс Microsoft Edge.
Указывает Microsoft Edge перейти в Bing.
Выполняет поиск по запросу "WebDriver".
Выполняется в спящем режиме в течение нескольких секунд, чтобы увидеть результаты.

Чтобы приступить к автоматизации Microsoft Edge с помощью WebDriver, скопируйте и вставьте фрагмент кода для предпочитаемого языка:

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 запускает новый процесс Microsoft Edge WebDriver, с которым EdgeDriver объект взаимодействует. Процесс Microsoft Edge WebDriver закрывается при вызове EdgeDriver метода объекта Quit . Предоставление каждому EdgeDriver объекту управления собственным процессом драйвера может оказаться неэффективным, если у вас много тестов, так как каждый тест должен ждать запуска нового процесса драйвера. Вместо этого можно создать один процесс Microsoft Edge WebDriver, а затем повторно использовать его для нескольких тестов.

Selenium использует класс для EdgeDriverService управления процессом Microsoft Edge WebDriver. Вы можете создать объект EdgeDriverService один раз перед выполнением тестов, а затем передать этот EdgeDriverService объект конструктору EdgeDriver при создании нового EdgeDriver объекта. При передаче EdgeDriverServiceEdgeDriver в конструктор 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.

Выбор определенных двоичных файлов браузера

Вы можете запустить сеанс WebDriver с определенными двоичными файлами Microsoft Edge. Например, тесты можно выполнять с помощью каналов предварительной версии Microsoft Edge, таких как Microsoft Edge Beta, Dev или Canary.

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 и Microsoft Edge WebDriver.

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

Дополнительные сведения см. в разделе контейнер msedgedriver на Docker Hub.

Application Guard

Доверенные сайты, использующие Application Guard в Microsoft Defender, можно автоматизировать с помощью Microsoft Edge WebDriver. Application Guard в Microsoft Defender также называется Application Guard.

Ненадежные сайты, использующие Application Guard, нельзя автоматизировать или управлять с помощью Microsoft Edge WebDriver. Application Guard запускает ненадежные сайты в контейнере, и этот контейнер не предоставляет порт удаленной отладки, необходимый Microsoft Edge WebDriver для связи с сайтом.

Администратор предприятия определяет, какие сайты являются доверенными, включая облачные ресурсы и внутренние сети. Сайты, которые не входят в список доверенных сайтов, считаются ненадежными. Microsoft Edge WebDriver может автоматизировать как окна InPrivate, так и сайты в списке доверенных сайтов.

Дополнительные сведения о Application Guard см. в разделе:

Отказ от сбора диагностических данных

По умолчанию Microsoft Edge WebDriver отправляет в корпорацию Майкрософт такие диагностические данные, как состояние команды New Session WebDriver. Чтобы отключить сбор диагностических данных для Microsoft Edge WebDriver, задайте для переменной MSEDGEDRIVER_TELEMETRY_OPTOUT среды значение 1. Дополнительные сведения о данных, собираемых Microsoft Edge WebDriver, см. в статье Microsoft Edge WebDriver в техническом документе о конфиденциальности Microsoft Edge.

Устаревшая версия Microsoft WebDriver для EdgeHTML

Microsoft WebDriver — это устаревшая реализация WebDriver для Microsoft Edge на основе EdgeHTML. Microsoft WebDriver распространялся как необязательный компонент Windows, так как устаревшая версия Microsoft Edge (EdgeHTML) была обновлена с помощью ОС. Microsoft WebDriver несовместим с последними версиями Microsoft Edge на основе Chromium. Microsoft WebDriver по-прежнему доступен для разработчиков, написавших тесты на основе WebDriver для приложений UWP, так как они используют EdgeHTML, но Microsoft WebDriver больше не рекомендуется.

См. статью WebDriver (EdgeHTML).

Поиск и устранение неисправностей

Ниже приведены рекомендации по устранению неполадок при использовании WebDriver для автоматизации Microsoft Edge.

Политика доступности средств разработчика

Если ит-администратор установил для политики DeveloperToolsAvailability значение 2, Microsoft Edge WebDriver будет заблокировано использовать Microsoft Edge, так как драйвер использует средства разработки Microsoft Edge. Чтобы автоматизировать Microsoft Edge, убедитесь, что для политики DeveloperToolsAvailability задано значение 0 или 1.

Использование шаблона Visual Studio

Если вы используете шаблон Microsoft Edge WebDriver, который предоставляется вместе с Visual Studio, который создает простой тестовый проект, убедитесь, что вы сделали следующее:

Скачайте Microsoft Edge WebDriver и убедитесь, что он доступен в PATH.
Добавьте в проект платформу WebDriver (например, пакет NuGet Selenium.WebDriver ).

После выполнения этих действий пример теста, который переходит к Bing, должен завершиться успешно.

Ошибка из-за selenium Tools for Microsoft Edge

Если при попытке создать новый EdgeDriver экземпляр возникает следующая ошибка: System.MissingMethodException: 'Method not found: 'OpenQA.Selenium.Remote.DesiredCapabilities OpenQA.Selenium.DriverOptions.GenerateDesiredCapabilities(Boolean)', см. раздел Обновление с Selenium 3 до Selenium 4 ниже.

Обновление с Selenium 3 до Selenium 4

Если вы использовали Средства Selenium для Microsoft Edge, чтобы добавить поддержку Microsoft Edge в тесты браузера Selenium 3, обновите тесты до Selenium 4 следующим образом:

Удалите selenium Tools for Microsoft Edge из проекта.
Обновите тесты, чтобы использовать встроенные EdgeDriver и связанные классы, которые предоставляет Selenium 4. Необходимо обновить все существующие тесты Selenium 3 до Selenium 4. Дополнительные сведения об обновлении до Selenium 4 см. в статье Обновление до Selenium 4.
Удалите все виды EdgeOptions.UseChromium использования свойства. Это свойство больше не существует в Selenium 4, так как Selenium 4 поддерживает только Microsoft Edge (Chromium обработчик браузера).

Selenium 3 не поддерживается

Чтобы автоматизировать Microsoft Edge с помощью WebDriver, убедитесь, что используется Selenium 4. Selenium 3 не поддерживается.

Все новые проекты, использующие Selenium, должны использовать Selenium 4. Чтобы автоматизировать Microsoft Edge с помощью WebDriver, убедитесь, что используется Selenium 4. Selenium 3 больше не поддерживается.

Инструменты Selenium для Microsoft Edge больше не используются

Selenium 4 не требует selenium Tools для Microsoft Edge. Selenium Tools for Microsoft Edge предназначен только для Selenium 3.

Не используйте Selenium 4 со средствами Selenium для Microsoft Edge, так как Selenium 4 уже имеет встроенную поддержку Microsoft Edge. При попытке использовать средства Selenium для Microsoft Edge при попытке создать новый EdgeDriver экземпляр вы получите следующую ошибку: System.MissingMethodException: 'Method not found: 'OpenQA.Selenium.Remote.DesiredCapabilities OpenQA.Selenium.DriverOptions.GenerateDesiredCapabilities(Boolean)'. Если вы используете Selenium 4 и получаете эту ошибку, удалите Microsoft.Edge.SeleniumTools из проекта и убедитесь, что используете официальные EdgeOptions классы и EdgeDriver из OpenQA.Selenium.Edge пространства имен.

См. также

Проект автоматизации selenium Browser Automation — сведения о WebDriver в контексте Selenium и о написании автоматизированных тестов WebDriver с помощью Selenium.
Пакет NuGet Selenium.WebDriver.
Обратитесь к команде Microsoft Edge WebDriver , чтобы отправить отзыв об использовании WebDriver, платформ тестирования WebDriver (например, Selenium) и Microsoft Edge.

Поделиться через