Возможности и возможности EdgeOptions

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

Возможности передаются в сеанс WebDriver в виде карты JSON, но задавать их таким образом не нужно или не рекомендуется. Платформы тестирования WebDriver (например , Selenium) предоставляют языковые привязки, которые обычно имеют удобные методы, поэтому вам не нужно настраивать карту JSON самостоятельно. Например, Selenium настраивает возможности с помощью EdgeOptions класса .

Дополнительные сведения о настройке возможностей см. в документации по предпочитаемой платформе тестирования WebDriver. Дополнительные сведения см. в статье Выбор платформы тестирования WebDriver.

Использование класса EdgeOptions

Создайте экземпляр EdgeOptions, который предоставляет удобные методы для задания возможностей Microsoft Edge. После настройки EdgeOptions объекта передайте EdgeOptions в EdgeDriver конструктор.

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 . В других языках возможности хранятся в словаре ms:edgeOptions в DesiredCapabilities.

Возможность	Тип	Сведения
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	Адрес сервера отладчика, к которому необходимо подключиться, в виде hostname/ip:port, например 127.0.0.1:38947.
detach	логический	Значение по умолчанию = false. Если falseзадано значение , Microsoft Edge завершает работу при завершении работы службы WebDriver, даже если локальный конец WebDriver не закрыл сеанс. Если trueзадано значение , Microsoft Edge завершает работу только в том случае, если локальный конец WebDriver закрывает сеанс. Если true, а локальный конец WebDriver не закрывает сеанс, не очищает временную папку данных пользователя, EdgeDriver используемую экземпляром Microsoft Edge.
excludeSwitches	список строк	Список переключений командной строки Microsoft Edge, чтобы исключить, что EdgeDriver по умолчанию пропускает при запуске Microsoft Edge. -- Избегайте префикса для параметров.
extensions	список строк	Список расширений для установки при запуске. Каждый элемент в списке должен быть упакованным расширением в кодировке Base-64 (.crx).
localState	Словарь	Словарь с каждой записью, состоящей из имени предпочтения и значения. Параметры применяются к файлу локального состояния в папке данных пользователя.
minidumpPath	string	Каталог для хранения мини-модулей Microsoft Edge. (Поддерживается только в Linux.)
mobileEmulation	Словарь	Словарь со значением для deviceNameили значениями для deviceMetrics и userAgent.
perfLoggingPrefs	Словарь	Необязательный словарь, указывающий параметры ведения журнала производительности. Дополнительные сведения см. в разделе объект perfLoggingPrefs.
prefs	Словарь	Словарь с каждой записью, состоящей из имени предпочтения и значения. Параметры применяются только к используемому профилю пользователя. Примеры см. в Preferences файле в папке данных пользователя Microsoft Edge.
wdpAddress	string	Адрес сервера портала устройств Windows, к которому необходимо подключиться, в виде hostname/ip:port, например 127.0.0.1:50080. Дополнительные сведения см. в статье Удаленная отладка — Windows 10 устройств.
wdpPassword	string	Необязательный пароль для использования при подключении к серверу портала устройств Windows. Требуется, если на сервере включена проверка подлинности.
wdpUsername	string	Необязательное имя пользователя, используемое при подключении к серверу портала устройств Windows. Требуется, если на сервере включена проверка подлинности.
wdpProcessId	integer	Обязательный идентификатор процесса для использования при подключении к работающему приложению UWP WebView2, например 36590. Эти сведения можно найти в browserProcessId .http://<Device Portal URL>/msedge
webviewOptions	Словарь	Необязательный словарь, который можно использовать для настройки среды WebView2 при запуске приложения WebView2. Дополнительные сведения см. в разделе объект webviewOptions.
windowsApp	string	Идентификатор пользовательской модели приложения для запуска пакета приложения Microsoft Edge, например Microsoft.MicrosoftEdge.Stable_8wekyb3d8bbwe!MSEDGE. Используйте windowsApp вместо при подключении binary к устройству Windows 10X или эмулятору с помощью портала устройств Windows.
windowTypes	список строк	Список типов окон, отображаемых в списке дескрипторов окон. Для доступа к элементам Веб-представления Android включите webview в список.

объект perfLoggingPrefs

Словарь perfLoggingPrefs имеет следующий формат. Все ключи являются необязательными.

Key	Тип	Значение по умолчанию	Сведения
bufferUsageReportingInterval	положительное целое число	1000	Запрошенное количество миллисекундах между событиями использования буфера трассировки DevTools. Например, если 1000, то один раз в секунду DevTools сообщает, насколько заполнен буфер трассировки. Если в отчете указано, что использование буфера равно 100 %, выдается предупреждение.
enableNetwork	логический	true	Сбор (или не сбор) событий из домена сети.
enablePage	логический	true	Сбор (или не сбор) событий из домена Page.
traceCategories	string	(пусто)	Разделенная запятыми строка категорий трассировки Microsoft Edge, для которых должны собираться события трассировки. Неуказанная или пустая строка отключает трассировку.

объект webviewOptions

Словарь webviewOptions используется для настройки среды WebView2 при запуске приложения WebView2. Он имеет следующий формат. Все ключи являются необязательными.

Key	Тип	Значение по умолчанию	Сведения
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".

Возвращенные возможности

В следующем списке содержатся все возможности Microsoft Edge, которые EdgeDriver возвращаются при создании нового сеанса.

Возможность	Тип	Сведения
msedge.msedgedriverVersion	string	Версия EdgeDriver.
msedge.userDataDir	string	Путь к папке данных пользователя, используемой экземпляром Microsoft Edge.