Freigeben über


Capabilities und EdgeOptions

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 falsean, wird Microsoft Edge beendet, wenn der WebDriver-Dienst heruntergefahren wird, auch wenn das lokale WebDriver-Ende die Sitzung nicht geschlossen hat. Gibt truean, 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 vonbinary, 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.