Share via

Возможности и возможности 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.