Capabilities und EdgeOptions

Artikel
04/04/2023

Funktionen sind Optionen, mit denen Sie eine EdgeDriver Sitzung anpassen und konfigurieren können. Informationen zum Starten einer neuen EdgeDriver Sitzung finden Sie unter Automatisieren von Microsoft Edge. Dieser Artikel beschreibt alle unterstützten Funktionen für Microsoft Edge und enthält Details zur Übergabe der Funktionen an EdgeDriver Sitzungen.

Funktionen werden als JSON-Zuordnung an eine WebDriver-Sitzung übergeben, aber es ist nicht erforderlich oder empfohlen, sie auf diese Weise festzulegen. WebDriver-Testframeworks (z. B. Selenium) stellen Sprachbindungen bereit, die in der Regel über praktische Methoden verfügen, sodass Sie die JSON-Zuordnung nicht selbst konfigurieren müssen. Selenium konfiguriert beispielsweise Funktionen über die EdgeOptions -Klasse.

Weitere Informationen zum Konfigurieren von Funktionen finden Sie in der Dokumentation für Ihr bevorzugtes WebDriver-Testframework. Weitere Informationen finden Sie unter Auswählen eines WebDriver-Testframeworks.

Verwenden der EdgeOptions-Klasse

Erstellen Sie eine instance von EdgeOptions, die praktische Methoden zum Festlegen von Microsoft Edge-spezifischen Funktionen bietet. Nachdem Sie das -Objekt konfiguriert haben EdgeOptions , übergeben Sie EdgeOptions an den EdgeDriver Konstruktor.

var options = new EdgeOptions();
options.AddExtensions("/path/to/extension.crx");
var driver = new EdgeDriver(options);

Verwenden Sie die -Methode, um Funktionen zu verwenden, die AddAdditionalEdgeOption nicht über eine zugeordnete Komfortmethode verfügen. Sie müssen den vollständigen Namen der Funktion und einen Wert mit dem richtigen Typ übergeben. Eine vollständige Liste der akzeptierten Funktionen und Werttypen finden Sie unter EdgeOptions-Objekt.

options.AddAdditionalEdgeOption("wdpAddress", "remotehost:50080");

Erkannte Funktionen

Informationen zu Standardfunktionen, die EdgeDriver akzeptiert werden, finden Sie in der Selenium-Dokumentation und im W3C WebDriver-Standard. In diesem Artikel werden nur funktionen aufgeführt, die für Microsoft Edge spezifisch sind.

EdgeOptions-Objekt

Die meisten Microsoft Edge-spezifischen Funktionen werden über das EdgeOptions -Objekt verfügbar gemacht. In einigen Sprachen werden die Funktionen von der EdgeOptions -Klasse implementiert. In anderen Sprachen werden die Funktionen unter dem ms:edgeOptions Wörterbuch in DesiredCapabilitiesgespeichert.

Funktion	Typ	Details
`args`	Liste der Zeichenfolgen	Liste der Befehlszeilenargumente, die beim Start an den Microsoft Edge-Prozess übergeben werden sollen. Argumente mit einem zugeordneten Wert sollten durch ein `=` Vorzeichen getrennt werden (z. B `['start-maximized', 'user-data-dir=/tmp/temp_profile']`. ). Wenn Sie eine WebView2-App starten, werden diese Argumente anstelle des zugrunde liegenden Microsoft Edge-Browserprozesses an Ihre App übergeben. Wenn Sie beim Starten einer WebView2-App Argumente an den Browserprozess übergeben möchten, verwenden Sie stattdessen webviewOptions.additionalBrowserArguments .
`binary`	string	Pfad zur zu verwendenden Microsoft Edge-Binärdatei (unter macOS sollte der Pfad die tatsächliche Binärdatei sein, nicht nur die App. Beispiel `/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge`: ).
`debuggerAddress`	string	Eine Adresse eines Debuggerservers, mit dem eine Verbindung hergestellt werden soll, in Form von `hostname/ip:port`, z. B `127.0.0.1:38947`. .
`detach`	Boolescher Wert	Standardwert = `false`. Gibt `false`an, wird Microsoft Edge beendet, wenn der WebDriver-Dienst heruntergefahren wird, auch wenn das lokale WebDriver-Ende die Sitzung nicht geschlossen hat. Gibt `true`an, wird Microsoft Edge nur beendet, wenn das lokale WebDriver-Ende die Sitzung schließt. Wenn `true`, und das lokale WebDriver-Ende die Sitzung nicht schließt, `EdgeDriver` sauber der temporäre Benutzerdatenordner, der vom Microsoft Edge-instance verwendet wird, nicht auf.
`excludeSwitches`	Liste der Zeichenfolgen	Liste der Microsoft Edge-Befehlszeilenoptionen, um auszuschließen, dass EdgeDriver standardmäßig beim Starten von Microsoft Edge durchläuft. Vermeiden Sie das `--` Präfix für Switches.
`extensions`	Liste der Zeichenfolgen	Eine Liste der Erweiterungen, die beim Start installiert werden sollen. Jedes Element in der Liste sollte eine Base64-codierte gepackte Erweiterung (`.crx`) sein.
`localState`	Wörterbuch	Ein Wörterbuch mit jedem Eintrag, der aus dem Namen der Einstellung und dem Wert besteht. Die Einstellungen werden auf die Datei "Lokaler Status" im Ordner "Benutzerdaten" angewendet.
`minidumpPath`	string	Verzeichnis zum Speichern von Microsoft Edge-Minidumps. (Wird nur unter Linux unterstützt.)
`mobileEmulation`	Wörterbuch	Ein Wörterbuch mit einem Wert für `deviceName`, oder werten für `deviceMetrics` und `userAgent`.
`perfLoggingPrefs`	Wörterbuch	Ein optionales Wörterbuch, das Leistungsprotokollierungseinstellungen angibt. Weitere Informationen finden Sie unter perfLoggingPrefs-Objekt.
`prefs`	Wörterbuch	Ein Wörterbuch mit jedem Eintrag, der aus dem Namen der Einstellung und dem Wert besteht. Die Einstellungen werden nur auf das verwendete Benutzerprofil angewendet. Beispiele finden Sie in der `Preferences` Datei im Benutzerdatenordner von Microsoft Edge.
`wdpAddress`	string	Eine Adresse eines Windows-Geräteportalservers, mit dem eine Verbindung hergestellt werden soll, in Form von `hostname/ip:port`, z. B `127.0.0.1:50080`. . Weitere Informationen finden Sie unter Remotedebuggen – Windows 10-Geräte.
`wdpPassword`	string	Optionales Kennwort, das beim Herstellen einer Verbindung mit einem Windows Device Portal-Server verwendet werden soll. Erforderlich, wenn auf dem Server die Authentifizierung aktiviert ist.
`wdpUsername`	string	Optionaler Benutzername, der beim Herstellen einer Verbindung mit einem Windows Device Portal-Server verwendet werden soll. Erforderlich, wenn auf dem Server die Authentifizierung aktiviert ist.
`wdpProcessId`	ganze Zahl	Die erforderliche Prozess-ID, die beim Anfügen an eine ausgeführte WebView2-UWP-App verwendet werden soll, z. B `36590`. . Diese Informationen finden Sie in `browserProcessId` auf `http://<Device Portal URL>/msedge`.
`webviewOptions`	Wörterbuch	Ein optionales Wörterbuch, das zum Konfigurieren der WebView2-Umgebung beim Starten einer WebView2-App verwendet werden kann. Weitere Informationen finden Sie unter webviewOptions-Objekt.
`windowsApp`	string	Anwendungsbenutzermodell-ID eines zu startenden Microsoft Edge-App-Pakets, z. B `Microsoft.MicrosoftEdge.Stable_8wekyb3d8bbwe!MSEDGE`. . Verwenden Sie `windowsApp` anstelle von`binary`, wenn Sie über das Windows-Geräteportal eine Verbindung mit einem Windows 10X Gerät oder Emulator herstellen.
`windowTypes`	Liste der Zeichenfolgen	Eine Liste der Fenstertypen, die in der Liste der Fensterhandles angezeigt werden. Fügen Sie für den Zugriff auf Android-Webview-Elemente in die Liste ein `webview` .

perfLoggingPrefs-Objekt

Das perfLoggingPrefs Wörterbuch hat das folgende Format. Alle Schlüssel sind optional.

Key	Typ	Standardwert	Details
`bufferUsageReportingInterval`	positive ganze Zahl	1000	Die angeforderte Anzahl von Millisekunden zwischen DevTools-Ablaufverfolgungspuffernutzungsereignissen. Wenn beispielsweise 1000, dann einmal pro Sekunde, DevTools meldet, wie voll der Ablaufverfolgungspuffer ist. Wenn ein Bericht angibt, dass die Pufferauslastung 100 % beträgt, wird eine Warnung ausgegeben.
`enableNetwork`	Boolescher Wert	true	Um Ereignisse aus der Netzwerkdomäne zu sammeln (oder nicht zu sammeln).
`enablePage`	Boolescher Wert	true	Um Ereignisse aus der Seitendomäne zu sammeln (oder nicht zu sammeln).
`traceCategories`	string	(leer)	Eine durch Trennzeichen getrennte Zeichenfolge von Microsoft Edge-Ablaufverfolgungskategorien, für die Ablaufverfolgungsereignisse gesammelt werden sollen. Eine nicht angegebene oder leere Zeichenfolge deaktiviert die Ablaufverfolgung.

webviewOptions-Objekt

Das webviewOptions Wörterbuch wird verwendet, um die WebView2-Umgebung beim Starten einer WebView2-App zu konfigurieren. Es hat das folgende Format. Alle Schlüssel sind optional.

Key	Typ	Standardwert	Details
`browserExecutableFolder`	string	(leer)	Pfad zu einem Ordner, der eine feste Version der zu verwendenden WebView2-Runtime enthält. Weitere Informationen zur Verwendung einer Laufzeitverteilung mit fester Version mit WebView2 finden Sie unter Verteilen einer WebView2-App und der WebView2-Runtime.
`userDataFolder`	string	(leer)	Pfad zum Benutzerdatenordner, den WebView2 verwendet. Wenn `userDataFolder` nicht angegeben ist, erstellt Microsoft Edge WebDriver einen temporären Benutzerdatenordner. Weitere Informationen zum Verwalten des Benutzerdatenordners mit WebView2 finden Sie unter Verwalten des Benutzerdatenordners.
`additionalBrowserArguments`	Liste der Zeichenfolgen		Liste der Befehlszeilenargumente, die WebView2 beim Start an den Browserprozess übergibt. Argumente mit einem zugeordneten Wert sollten durch ein `=` Vorzeichen getrennt werden (z. B `['start-maximized', 'log-level=0']`. ).
`releaseChannelPreference`	string		Bevorzugte WebView2-Evergreen-Runtimeverteilung für die Verwendung. Kann `"stable"` oder `"canary"` sein.

Zurückgegebene Funktionen

Die folgende Liste enthält alle Microsoft Edge-spezifischen Funktionen, die zurückgegeben werden, EdgeDriver wenn Sie eine neue Sitzung erstellen.

Funktion	Typ	Details
`msedge.msedgedriverVersion`	string	Die Version von EdgeDriver.
`msedge.userDataDir`	string	Der Pfad zum Benutzerdatenordner, der vom Microsoft Edge-instance verwendet wird.

Freigeben über