Microsoft webdriver windows 10 что это

Use WebDriver to automate Microsoft Edge

WebDriver allows developers to automate Microsoft Edge by simulating user interaction. WebDriver tests and simulations differ from JavaScript unit tests in the following ways:

Relationship between WebDriver and other software

To automate Microsoft Edge with WebDriver to simulate user interaction, you need three components:

The functional relationship between these components is as follows:

The following sections describe how to get started with WebDriver for Microsoft Edge.

Download Microsoft Edge Driver

To begin automating tests, make sure the WebDriver version you install matches your browser version, as follows:

Go to edge://settings/help and note your version of Microsoft Edge.

In the Get the latest version section of the page, click a platform in the channel that matches your version number of Microsoft Edge.

After the download completes, extract the msedgedriver executable to your preferred location. Add the folder where the executable is located to your PATH environment variable.

Choose a WebDriver testing framework

After downloading Microsoft Edge Driver, the last component you must download is a WebDriver testing framework. Test authors use WebDriver testing frameworks to write end-to-end tests and automate browsers. The framework provides a language-specific interface that translates your code (such as Python, Java, C#, Ruby, or JavaScript) into commands that Microsoft Edge Driver runs in Microsoft Edge. WebDriver testing frameworks exist for all major platforms and languages.

This article provides instructions for using the Selenium framework, but you can use any library, framework, and programming language that supports WebDriver. To accomplish the same tasks using a WebDriver testing framework other than Selenium, consult the official documentation for your framework of choice.

If you’re using Selenium, the Microsoft Edge team recommends Selenium 4 or later, because that version of Selenium supports Microsoft Edge. However, you can control Microsoft Edge in all older versions of Selenium, including Selenium 3.

Using Selenium 4

The Selenium WebDriver testing framework can be used on any platform, and is available for Java, Python, C#, Ruby, and JavaScript.

Selenium 4 has built-in support for Microsoft Edge. To install Selenium 4, see Installing Selenium libraries.

If you’re using Selenium 4 and get this error, remove Microsoft.Edge.SeleniumTools from your project, and make sure you’re using the official EdgeOptions and EdgeDriver classes from the OpenQA.Selenium.Edge namespace.

Using Selenium 3

If you already use Selenium 3, you may have existing browser tests and want to add coverage for Microsoft Edge without changing your version of Selenium. To use Selenium 3 to write automated tests for both legacy EdgeHTML and Microsoft Edge, install the Selenium Tools for Microsoft Edge package to use the updated driver. The EdgeDriver and EdgeDriverService classes included in the tools are fully compatible with the built-in equivalents in Selenium 4.

If you’re using Selenium 3, use the following steps to add the Selenium Tools for Microsoft Edge and Selenium 3 to your project.

Use pip to install the msedge-selenium-tools and selenium packages.

If your Java project uses Maven, copy and paste the following dependency to your pom.xml file to add msedge-selenium-tools-java.

The Java package is also available to download directly on the Selenium Tools for Microsoft Edge Releases page.

Automate Microsoft Edge with WebDriver

To automate a browser using WebDriver, you must first start a WebDriver session using your preferred WebDriver testing framework. A session is a single running instance of a browser controlled using WebDriver commands. Start a WebDriver session to launch a new browser instance. The launched browser instance remains open until you close the WebDriver session.

The following content walks you through using Selenium to start a WebDriver session with Microsoft Edge. You can run these examples using either Selenium 3 or 4. To use WebDriver with Selenium 3, the Selenium Tools for Microsoft Edge package must be installed.

This article provides instructions for using the Selenium framework, but you can use any library, framework, and programming language that supports WebDriver. To accomplish the same tasks using another framework, consult the documentation for your framework of choice.

Automate Microsoft Edge

Choose Specific Browser Binaries (Chromium-Only)

You can start a WebDriver session with specific Microsoft Edge binaries. For example, you can run tests using the Microsoft Edge preview channels such as Microsoft Edge Beta.

Customize the Microsoft Edge Driver Service

When you use the EdgeOptions class to create an EdgeDriver class instance, it creates and launches the appropriate EdgeDriverService class for either legacy EdgeHTML or Microsoft Edge (Chromium).

You don’t need to provide the EdgeOptions object when you pass EdgeDriverService to the EdgeDriver instance. The EdgeDriver class uses the default options for either legacy EdgeHTML or Microsoft Edge (Chromium), based on the service you provide. However, if you want to provide both EdgeDriverService and EdgeOptions classes, make sure that both are configured for the same version of Microsoft Edge. For example, suppose you use a default legacy EdgeHTML EdgeDriverService class but use Microsoft Edge (Chromium) properties in the EdgeOptions class. The EdgeDriver class would throw an error to prevent using different versions of Microsoft Edge.

Use the createDefaultService() method to create an EdgeDriverService configured for Microsoft Edge. Use Java system properties to customize driver services in Java. For example, the following code uses the «webdriver.edge.verboseLogging» property to turn on verbose log output:

Use Chromium-Specific Options

Other WebDriver installation options

Docker

If you use Docker, run the following command to download a pre-configured image with Microsoft Edge and Microsoft Edge Driver pre-installed.

Application Guard

Trusted sites that use Microsoft Defender Application Guard (Application Guard) can be automated using Microsoft Edge Driver.

Untrusted sites that use Application Guard cannot be automated or manipulated using Microsoft Edge Driver. Application Guard launches untrusted sites in a container, and this container doesn’t expose the remote debugging port that Microsoft Edge Driver needs to communicate with the site.

Your enterprise administrator defines what are trusted sites, including cloud resources and internal networks. Sites that aren’t in the trusted sites list are considered untrusted. Microsoft Edge Driver can automate both InPrivate windows, and sites in the trusted sites list.

For more information about Application Guard, see:

Opt out of diagnostic data collection

Источник

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

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

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

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

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

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

Скачать Microsoft Edge

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

Перейдите edge://settings/help к и обратите внимание на свою версию Microsoft Edge.

В разделе Получить последнюю версию страницы щелкните платформу в канале, которая соответствует номеру версии Microsoft Edge.

После завершения загрузки извлеките msedgedriver исполняемый файл в предпочтительное расположение. Добавьте папку, в которой исполнитель находится в переменной PATH среды.

Выбор основы тестирования WebDriver

После загрузки Microsoft Edge драйвера последним компонентом, который необходимо скачать, является база тестирования WebDriver. Тестовые авторы используют тестовые рамки WebDriver для записи конечных тестов и автоматизации браузеров. Фреймворк предоставляет языковой интерфейс, который переводит код (например, Python, Java, C#, Ruby или JavaScript) в команды, Microsoft Edge Driver выполняется в Microsoft Edge. Платформы тестирования WebDriver существуют для всех основных платформ и языков.

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

Если вы используете selenium, Microsoft Edge рекомендует selenium 4 или более поздний, так как эта версия selenium поддерживает Microsoft Edge. Однако вы можете управлять Microsoft Edge во всех старых версиях selenium, включая Selenium 3.

Использование selenium 4

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

Selenium 4 имеет встроенную поддержку Microsoft Edge. Чтобы установить selenium 4, см. в рублях Установка библиотек selenium.

Если вы используете Selenium 4 и получите эту ошибку, удалите из проекта и убедитесь, что вы используете официальные и классы из Microsoft.Edge.SeleniumTools EdgeOptions пространства EdgeDriver OpenQA.Selenium.Edge имен.

Использование selenium 3

Если вы уже используете Selenium 3,возможно, у вас есть существующие тесты браузера и вы хотите добавить покрытие для Microsoft Edge без изменения версии Selenium. Чтобы использовать Selenium 3 для записи автоматических тестов для устаревших edgeHTML и Microsoft Edge, установите пакет Selenium Tools для Microsoft Edge для использования обновленного драйвера. Классы и классы, включенные в инструменты, полностью совместимы со встроенными эквивалентами EdgeDriver EdgeDriverService в Selenium 4.

Если вы используете selenium 3, используйте следующие действия, чтобы добавить в проект средства selenium для Microsoft Edge и Selenium 3.

Если в проекте Java используется Maven, скопируйте и вклейте в файл следующую зависимость, чтобы добавить pom.xml msedge-selenium-tools-java.

Пакет Java также доступен для скачивания непосредственно на странице Selenium Tools for Microsoft Edge Releases.

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

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

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

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

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

Если ваш ИТ-администратор задает политику DeveloperToolsAvailability, Microsoft Edge драйверу будет заблокировано управление Microsoft Edge, так как водитель использует Microsoft Edge 2 DevTools. Убедитесь, что политика developerToolsAvailability настроена на автоматизацию 0 1 Microsoft Edge.

Выбор отдельных бинарей браузера (Chromium-only)

Сеанс WebDriver можно запустить с помощью определенных Microsoft Edge разных серверов. Например, можно выполнить тесты с Microsoft Edge каналов предварительного просмотра, таких как Microsoft Edge Beta.

Настройка службы Microsoft Edge драйверов

При создании экземпляра класса класс создает и запускает соответствующий класс для устаревших EdgeOptions EdgeDriver EdgeDriverService edgeHTML или Microsoft Edge (Chromium).

Если вы хотите создать метод, используйте метод для создания настраиваемого EdgeDriverService CreateChromiumService() для Microsoft Edge. Метод CreateChromiumService() полезен при добавлении настроек. Например, в следующем коде начинается подробный выход журнала:

Вам не нужно предоставлять объект при проходе EdgeOptions EdgeDriverService в EdgeDriver экземпляр. Класс использует параметры по умолчанию для устаревших edgeHTML или Microsoft Edge (Chromium), основанных на EdgeDriver предоставляемой вами службе. Однако, если вы хотите предоставить как классы, так и классы, убедитесь, что оба настроены для одной и той же версии EdgeDriverService EdgeOptions Microsoft Edge. Например, предположим, что вы используете устаревший класс EdgeHTML по умолчанию, но используете Microsoft Edge EdgeDriverService (Chromium) свойства EdgeOptions в классе. Класс EdgeDriver будет бросать ошибку, чтобы предотвратить использование различных версий Microsoft Edge.

Используйте метод createDefaultService() для создания EdgeDriverService настраиваемого для Microsoft Edge. Используйте свойства системы Java для настройки служб драйверов в Java. Например, следующий код использует свойство «webdriver.edge.verboseLogging» для включаемой многословной выходной записи журнала:

При использовании JavaScript создайте и настройте Service ServiceBuilder класс. Необязательно, вы можете передать объект объекту, который запускает Service Driver (и останавливает) службу для вас. Чтобы настроить Service метод, запустите другой метод в ServiceBuilder классе перед build() использованием метода. Затем service передай параметр в Driver.createSession() методе:

Использование Chromium-Specific параметры

Если вы установите свойство, вы можете использовать класс для доступа к тем же свойствам Chromium и методам, которые используются при автоматизации других Chromium UseChromium true EdgeOptions браузеров.

Если свойство установлено, вы не можете использовать свойства и методы для Microsoft Edge UseChromium true (EdgeHTML).

Другие параметры установки WebDriver

Docker

Если вы используете Docker,запустите следующую команду, чтобы скачать предварительно настроенное изображение с предварительно установленным Microsoft Edge и Microsoft Edge драйвером.

Application Guard

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

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

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

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

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

Источник

Автоматизация и тестирование приложений WebView2 с помощью Microsoft Edge драйвера

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

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

Чтобы создать автоматизированные тесты, имитирующие взаимодействие пользователей для приложения WebView2, можно использовать Microsoft Edge Driver. Microsoft Edge — это реализация Microsoft протокола W3C WebDriver. Протокол W3C WebDriver позволяет программам контролировать поведение веб-браузеров.

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

Связь между протоколом WebDriver Microsoft Edge драйвером в качестве реализации этого протокола и тестовой рамкой Selenium см. в обзоре WebDriver.

Шаг 1. Скачайте образец WebView2API

Если у вас нет существующего проекта WebView2, скачайте пример приложения WebView2API,которое является полным образцом последнего SDK WebView2. Убедитесь, что вы удовлетворили необходимые условия для примера приложения WebView2API.

После клонирования репо создайте проект в Visual Studio. Она должна выглядеть как следующая фигура.

Шаг 2. Установка Microsoft Edge драйвера

Следуйте инструкциям по установке Microsoft Edge Driver. Microsoft Edge Драйвер — это драйвер, определенный для браузера, необходимый Selenium для автоматизации и тестирования WebView2.

Убедитесь, что Microsoft Edge драйвера совпадает с версией времени запуска WebView2, которое использует ваше приложение. Чтобы образец WebView2API работал, убедитесь, что ваша версия webView2 runtime больше или равна поддерживаемой версии последнего выпуска SDK WebView2.

Шаг 3. Добавление селена в образец WebView2API

К этому моменту вы установили время запуска WebView2, создали проект WebView2 и установили Microsoft Edge Driver. Далее начинайте использовать selenium следующим образом.

Дайте вашему проекту Project имя, сохраните его в предпочтительном расположении, **** а затем выберите Создать.

Создается новый проект со всем кодом, размещенным в Program.cs файле.

Далее добавьте selenium в проект; Установите selenium с помощью пакета Selenium.WebDriver NuGet следующим образом. Чтобы скачать пакет Selenium.WebDriver NuGet, в Visual Studioвыберите **** Project Управление > NuGet пакетами.

Выберите вкладку Просмотр. Появится следующий экран.

В списке выпаданий источника пакета выберите nuget.org.

Выберите почтовый ящик Include prerelease.

Введите Selenium.WebDriver в панели Поиска и выберите Selenium.WebDriver из результатов.

В окне подробно справа **** убедитесь, что версия установлена на 4.0.0 или более поздней версии, а затем выберите Установите. NuGet загружает selenium на компьютер.

Дополнительные информацию о пакете Selenium.WebDriver NuGet см. в странице Selenium.WebDriver.

Используйте, OpenQA.Selenium.Edge добавив заявление в начале using OpenQA.Selenium.Edge; Program.cs файла:

Теперь вы создали пустой проект Visual Studio, подходящий для тестирования selenium. Далее настройте Selenium для привода WebView2 с помощью подхода «запуск» или «прикрепить».

Шаг 4. Выбор того, следует ли Microsoft Edge драйверу запустить приложение или прикрепить к нему

Решение о настройке selenium для привода WebView2 с помощью подхода «запуск» или «присоединение».

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

Подход «присоединение». В других сценариях целесообразно прикрепить Microsoft Edge драйвера к запущенной экземпляру WebView2. Вы запускаете приложение вне Microsoft Edge драйвера, а затем прикрепите Microsoft Edge драйвер к экземпляру WebView2. Этот подход «прикрепить» подходит для приложения WebView2, которое не совместимо с подходом «запуск».

Подход 1. Разрешение Microsoft Edge запуска приложения WebView2

Если у вас есть простое приложение, которое создает один экземпляр WebView2 и этот экземпляр активен сразу после запуска, можно использовать подход «запуск»; использование шага 4a. Позволить Microsoft Edge драйверу запустить приложение WebView2.

В этом сценарии имеется один экземпляр WebView2, который доступен при запуске без необходимости перемещаться по родному пользовательскому интерфейсу.

Подход 2. Присоединение Microsoft Edge драйвера к запущенным приложениям WebView2

Некоторые примеры сценариев, которые не соответствуют сценарию «запуск»:

В таких сценариях рекомендуется прикрепляться к определенному экземпляру WebView2, так как запуск Microsoft Edge драйвера приложения WebView2 — это только относительно простые сценарии. Когда Microsoft Edge драйвер запускает ваше приложение, оно автоматически присоединяется к первому созданному экземпляру WebView2 и сбой, если экземпляр WebView2 не найден.

Независимо от того, используется ли метод «запуск» или «присоединение», необходимо скачать Microsoft Edge Driver и убедиться, что версия соответствует версии времени запуска WebView2, используемого вашим приложением. Начальные действия по настройке структуры WebDriver (например, Selenium) будут отличаться между подходами «запуск» и «присоединение».

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

Шаг 4a. Позволить Microsoft Edge драйверу запустить приложение WebView2

Используйте этот подход к запуску, если у вас есть простое приложение, которое создает один экземпляр WebView2 и этот экземпляр активен сразу после запуска. В этом сценарии имеется один экземпляр WebView2, который доступен при запуске без необходимости перемещаться по родному пользовательскому интерфейсу.

Чтобы управлять WebView2 с помощью selenium и Microsoft Edge драйвера:

Создание объекта EdgeOptions путем копирования и вклейки следующего фрагмента кода:

Далее мы добавим код, который делает следующее:

Скопируйте следующий код и вклеите его ниже eo строки объявления:

В вышеуказанном коде укажите правильный путь файла для запуска проекта и Microsoft Edge драйвера на компьютере.

EdgeDriver теперь настроено управлять WebView2 в проекте. Например, если вы используете образец WebView2API, код теперь можно перейти к запуску команды, как показано в следующем https://microsoft.com e.Url = @»https://www.microsoft.com»; списке кода.

Убедитесь, что selenium может управлять WebView2. Для этого установите точку разлома на строке e.Url = @»https://www.microsoft.com»; и запустите проект.

Поздравляем! Вы успешно автоматизировали проект WebView2 и управляли WebView2 с помощью selenium и Microsoft Edge Driver в подходе «запуск».

Это конец статьи, если используется подход «запуск».

Шаг 4b: присоединение Microsoft Edge драйвера к запущенным приложениям WebView2

В этом разделе объясняется, как Microsoft Edge драйвера к уже запущенной экземпляру WebView2. Если у вас нет только одного экземпляра WebView2 или экземпляру WebView2 требуется навигация по некоторому пользовательскому интерфейсу, используйте этот раздел и подход.

Проблема заключается в том, что для автоматизации приложения на основе WebView2 иногда сначала необходимо выполнить некоторые действия в родном интерфейсе, чтобы запустить управление WebView2. В качестве решения необходимо перемещаться по родному пользовательскому интерфейсу вне Microsoft Edge драйвера и каким-либо образом убедиться, что экземпляр WebView2 отображается следующим образом.

В этом сценарии, где у вас есть собственный пользовательский интерфейс для навигации, запустите приложение с помощью метода, не Microsoft Edge Driver, например скрипта командной строки или отдельного средства, например WinAppDriver. После запуска процесса приложения запускается моментация WebView2, а затем Microsoft Edge драйвера к запущенной экземпляру WebView2.

Microsoft Edge Driver не обрабатывает автоматизацию пользовательского интерфейса, но вот несколько других подходов для навигации по родному пользовательскому интерфейсу и отображения экземпляра WebView2, который вы автоматизируете:

Windows Драйвер приложения(WinAppDriver)— это служба поддержки автоматизации тестирования пользовательского интерфейса на основе селена в Windows приложениях. Эта служба поддерживает тестирование приложений Universal Windows Platform (UWP), Windows Forms (WinForms), Windows Presentation Foundation (WPF) и классических приложений Windows (Win32) на Windows 10 ПК.

Непосредственное использование автоматизации пользовательского интерфейса Microsoft Native. Система автоматизации пользовательского интерфейса Майкрософт позволяет автоматическим тест-скриптам взаимодействовать с пользовательским интерфейсом. Автоматизация пользовательского интерфейса Майкрософт позволяет Windows приложениям предоставлять и потреблять программные сведения о пользовательских интерфейсах (UIS). Он предоставляет программный доступ к большинству элементов пользовательского интерфейса на рабочем столе. Это позволяет вспомогательным технологическим продуктам, таким как считыватели экрана, предоставлять сведения о пользовательском интерфейсе конечным пользователям и управлять пользовательским интерфейсом стандартным входным входом и средствами, не входными данными.

Чтобы избежать необходимости навигации по родному пользовательскому интерфейсу, используйте флаг, например параметр командной строки или переменную среды, чтобы сообщить приложению о запуске непосредственно в экземпляр WebView2. В зависимости от сценария это может сделать возможным использование подхода «запуск», описанного в шаге 4a: позволить Microsoft Edge драйверу запустить приложение WebView2.

Запуск приложения WebView2 с поддержкой удаленного отладки

Следующий шаг происходит при кодировании приложения. Этот дополнительный параметр командной строки необходимо предоставить при мгновенном пуске управления WebView2. Включить удаленную отладку, как следует.

Globals в WebView2 Win32 C++ Reference. Выберите доступный номер порта для этого параметра.

Запустите приложение. Запуск приложения зависит от использования других средств тестирования пользовательского интерфейса.

Присоединение Microsoft Edge драйвера к запущенной приложению WebView2

Дополнительные сведения о DebuggerAddress свойстве объекта см. в EdgeOptions сайте EdgeOptions.

Поздравляем! Вы успешно автоматизировали проект WebView2 и управляли WebView2 с помощью selenium и Microsoft Edge Driver, присоединив Microsoft Edge Driver к запущенным приложениям WebView2.

Источник