WebDriver Protokoll

newSession

Der New Session Befehl erzeugt eine neue WebDriver-Sitzung mit dem Endpunktknoten. Wenn die Erstellung fehlschlägt, wird ein "session not created"-Fehler zurückgegeben.

WebDriver Protocol-Befehl. Weitere Details finden Sie in der offiziellen Protokolldokumentation.

Verwendung

browser.newSession(capabilities)

Parameter

Name	Typ	Details
capabilities	object	ein JSON-Objekt, das Set von Capabilities, das letztendlich im Capability-Verarbeitungsalgorithmus zusammengeführt und abgeglichen wurde

Gibt zurück

• <Object> session: Objekt, das sessionId und Capabilities der erstellten WebDriver-Sitzung enthält.

---

deleteSession

Der Delete Session Befehl schließt alle übergeordneten Browsing-Kontexte, die mit der aktuellen Sitzung verknüpft sind, beendet die Verbindung und schließt schließlich die aktuelle Sitzung.

WebDriver Protocol-Befehl. Weitere Details finden Sie in der offiziellen Protokolldokumentation.

Verwendung

browser.deleteSession(deleteSessionOpts)

Parameter

Name	Typ	Details
deleteSessionOpts optional	object	Objekt, das Optionen für den deleteSession-Befehl enthält, z.B. { shutdownDriver: boolean }

---

status

Der Status-Befehl gibt Informationen darüber zurück, ob ein Remote-Ende in einem Zustand ist, in dem es neue Sitzungen erstellen kann, und kann zusätzlich beliebige Meta-Informationen enthalten, die für die Implementierung spezifisch sind.

WebDriver Protocol-Befehl. Weitere Details finden Sie in der offiziellen Protokolldokumentation.

Verwendung

browser.status()

Beispiel

examples.js

loading...

View on GitHub

Gibt zurück

• <Object> status: Objekt, das den Status des Treibers enthält.

---

getTimeouts

Der Get Timeouts Befehl ruft Timeout-Dauern ab, die mit der aktuellen Sitzung verknüpft sind.

WebDriver Protocol-Befehl. Weitere Details finden Sie in der offiziellen Protokolldokumentation.

Verwendung

browser.getTimeouts()

Beispiel

examples.js

loading...

View on GitHub

Gibt zurück

• <Object> timeouts: Objekt, das Timeout-Dauern für script, pageLoad und implicit Timeouts enthält.

---

setTimeouts

Der Set Timeouts Befehl legt Timeout-Dauern fest, die mit der aktuellen Sitzung verknüpft sind. Die Timeouts, die gesteuert werden können, sind in der Tabelle der Sitzungs-Timeouts unten aufgeführt.

WebDriver Protocol-Befehl. Weitere Details finden Sie in der offiziellen Protokolldokumentation.

Verwendung

browser.setTimeouts(implicit, pageLoad, script)

Parameter

Name	Typ	Details
implicit optional	number	Ganzzahl in ms für impliziten Sitzungs-Timeout
pageLoad optional	number	Ganzzahl in ms für Sitzungs-Seiten-Lade-Timeout
script optional	number	Ganzzahl in ms für Sitzungs-Skript-Timeout

Beispiel

examples.js

loading...

View on GitHub

---

getUrl

Der Get Current URL Befehl gibt die URL des aktuellen übergeordneten Browsing-Kontexts zurück.

WebDriver Protocol-Befehl. Weitere Details finden Sie in der offiziellen Protokolldokumentation.

Verwendung

browser.getUrl()

Beispiel

examples.js

loading...

View on GitHub

Gibt zurück

• <string> url: aktuelle URL des aktiven Dokuments des übergeordneten Browsing-Kontexts

---

navigateTo

Der navigateTo (go) Befehl wird verwendet, um den User-Agent dazu zu bringen, den aktuellen übergeordneten Browsing-Kontext zu einer neuen Adresse zu navigieren.

WebDriver Protocol-Befehl. Weitere Details finden Sie in der offiziellen Protokolldokumentation.

Info

Dieser Protokollbefehl ist in der folgenden praktischen Methode eingebettet: url. Es wird empfohlen, stattdessen diesen Befehl zu verwenden.

Verwendung

browser.navigateTo(url)

Parameter

Name	Typ	Details
url	string	eine Zeichenfolge, die eine absolute URL darstellt (beginnend mit http(s)), möglicherweise einschließlich eines Fragments (#...), könnte auch ein lokales Schema sein (about: usw.)

Beispiel

examples.js

loading...

View on GitHub

---

back

Der Back-Befehl veranlasst den Browser, einen Schritt rückwärts im gemeinsamen Sitzungsverlauf des aktuellen übergeordneten Browsing-Kontexts zu gehen. Dies entspricht dem Drücken der Zurück-Schaltfläche in der Browser-Chrome oder dem Aufruf von window.history.back.

WebDriver Protocol-Befehl. Weitere Details finden Sie in der offiziellen Protokolldokumentation.

Verwendung

browser.back()

Beispiel

examples.js

loading...

View on GitHub

---

forward

Der Forward-Befehl veranlasst den Browser, einen Schritt vorwärts im gemeinsamen Sitzungsverlauf des aktuellen übergeordneten Browsing-Kontexts zu gehen.

WebDriver Protocol-Befehl. Weitere Details finden Sie in der offiziellen Protokolldokumentation.

Verwendung

browser.forward()

Beispiel

examples.js

loading...

View on GitHub

---

refresh

Der Refresh-Befehl veranlasst den Browser, die Seite im aktuellen übergeordneten Browsing-Kontext neu zu laden.

WebDriver Protocol-Befehl. Weitere Details finden Sie in der offiziellen Protokolldokumentation.

Verwendung

browser.refresh()

Beispiel

examples.js

loading...

View on GitHub

---

getTitle

Der Get Title Befehl gibt den Dokumenttitel des aktuellen übergeordneten Browsing-Kontexts zurück, was dem Aufruf von document.title entspricht.

WebDriver Protocol-Befehl. Weitere Details finden Sie in der offiziellen Protokolldokumentation.

Verwendung

browser.getTitle()

Beispiel

examples.js

loading...

View on GitHub

Gibt zurück

• <string> title: Gibt eine Zeichenfolge zurück, die identisch mit document.title des aktuellen übergeordneten Browsing-Kontexts ist.

---

getWindowHandle

Der Get Window Handle Befehl gibt den Fensterhandle für den aktuellen übergeordneten Browsing-Kontext zurück. Er kann als Argument für Switch To Window verwendet werden.

WebDriver Protocol-Befehl. Weitere Details finden Sie in der offiziellen Protokolldokumentation.

Verwendung

browser.getWindowHandle()

Beispiel

examples.js

loading...

View on GitHub

Gibt zurück

• <string> handle: Gibt eine Zeichenfolge zurück, die der Fensterhandle für den aktuellen übergeordneten Browsing-Kontext ist.

---

closeWindow

Der Close Window Befehl schließt den aktuellen übergeordneten Browsing-Kontext. Sobald dies erledigt ist, wenn keine weiteren übergeordneten Browsing-Kontexte geöffnet sind, wird die WebDriver-Sitzung selbst geschlossen.

WebDriver Protocol-Befehl. Weitere Details finden Sie in der offiziellen Protokolldokumentation.

Verwendung

browser.closeWindow()

Beispiel

examples.js

loading...

View on GitHub

---

switchToWindow

Der Switch To Window Befehl wird verwendet, um den aktuellen übergeordneten Browsing-Kontext für die aktuelle Sitzung auszuwählen, d.h. denjenigen, der für die Verarbeitung von Befehlen verwendet wird.

WebDriver Protocol-Befehl. Weitere Details finden Sie in der offiziellen Protokolldokumentation.

Info

Dieser Protokollbefehl ist in der folgenden praktischen Methode eingebettet: switchWindow. Es wird empfohlen, stattdessen diesen Befehl zu verwenden.

Verwendung

browser.switchToWindow(handle)

Parameter

Name	Typ	Details
handle	string	eine Zeichenkette, die einen Fensterhandle darstellt, sollte eine der Zeichenketten sein, die in einem Aufruf von getWindowHandles zurückgegeben wurde

Beispiel

examples.js

loading...

View on GitHub

---

createWindow

Erstellt einen neuen übergeordneten Browsing-Kontext.

WebDriver Protocol-Befehl. Weitere Details finden Sie in der offiziellen Protokolldokumentation.

Verwendung

browser.createWindow(type)

Parameter

Name	Typ	Details
type	string	Auf 'tab' gesetzt, wenn das neu erstellte Fenster ein OS-Level-Fenster mit dem aktuellen Browsing-Kontext teilt, oder 'window' andernfalls.

Beispiel

examples.js

loading...

View on GitHub

Gibt zurück

• <Object> window: Neues Fensterobjekt, das 'handle' mit dem Wert des Handles und 'type' mit dem Wert des erstellten Fenstertyps enthält

---

getWindowHandles

Der Get Window Handles Befehl gibt eine Liste von Fensterhandles für jeden offenen übergeordneten Browsing-Kontext zurück. Die Reihenfolge, in der die Fensterhandles zurückgegeben werden, ist beliebig.

WebDriver Protocol-Befehl. Weitere Details finden Sie in der offiziellen Protokolldokumentation.

Verwendung

browser.getWindowHandles()

Beispiel

examples.js

loading...

View on GitHub

Gibt zurück

• <String[]> handles: Ein Array, das eine Liste von Fensterhandles ist.

---

printPage

Der Print Page Befehl rendert das Dokument zu einem paginierten PDF-Dokument. Hinweis: Chrome unterstützt dies derzeit nur im Headless-Modus, siehe crbug753118).

WebDriver Protocol-Befehl. Weitere Details finden Sie in der offiziellen Protokolldokumentation.

Verwendung

browser.printPage(orientation, scale, background, width, height, top, bottom, left, right, shrinkToFit, pageRanges)

Parameter

Name	Typ	Details
orientation optional	string	Seitenausrichtung. Standard: portrait
scale optional	number	Seitenskalierung. Standard: 1
background optional	boolean	Seitenhintergrund. Standard: false
width optional	number	Seitenbreite in cm. Standard: 21.59 von der Seite
height optional	number	Seitenhöhe in cm. Standard: 27.94 von der Seite
top optional	number	Seitenrand in cm vom oberen Rand. Standard: 1
bottom optional	number	Seitenrand in cm vom unteren Rand. Standard: 1
left optional	number	Seitenrand in cm vom linken Rand. Standard: 1
right optional	number	Seitenrand in cm vom rechten Rand. Standard: 1
shrinkToFit optional	boolean	PDF an Seite anpassen. Standard: true
pageRanges optional	object[]	Seitenbereiche. Standard []

Beispiel

examples.js

loading...

View on GitHub

Gibt zurück

• <string> pdf: Die Base64-kodierte PDF-Darstellung des paginierten Dokuments.

---

switchToFrame

Der Switch To Frame Befehl wird verwendet, um den aktuellen übergeordneten Browsing-Kontext oder einen untergeordneten Browsing-Kontext des aktuellen Browsing-Kontexts als aktuellen Browsing-Kontext für nachfolgende Befehle auszuwählen.

WebDriver Protocol-Befehl. Weitere Details finden Sie in der offiziellen Protokolldokumentation.

Achtung

Dieser Protokollbefehl ist veraltet
Dieser Befehl ist veraltet und wir empfehlen jedem, stattdessen switchFrame für das Wechseln in Frames zu verwenden. Lesen Sie mehr über diesen Befehl unter https://webdriver.io/docs/api/browser/switchFrame.

Verwendung

browser.switchToFrame(id)

Parameter

Name	Typ	Details
id	number, object, null	eine von drei möglichen Typen: null: dies repräsentiert den übergeordneten Browsing-Kontext (d.h. nicht einen iframe), eine Zahl, die den Index des Fensterobjekts darstellt, das einem Frame entspricht, ein Element-Objekt, das über findElement empfangen wurde.

Beispiel

examples.js

loading...

View on GitHub

---

switchToParentFrame

Der Switch to Parent Frame Befehl setzt den aktuellen Browsing-Kontext für zukünftige Befehle auf den übergeordneten Kontext des aktuellen Browsing-Kontexts.

WebDriver Protocol-Befehl. Weitere Details finden Sie in der offiziellen Protokolldokumentation.

Verwendung

browser.switchToParentFrame()

Beispiel

examples.js

loading...

View on GitHub

---

getWindowRect

Der Get Window Rect Befehl gibt die Größe und Position auf dem Bildschirm des Betriebssystemfensters zurück, das dem aktuellen übergeordneten Browsing-Kontext entspricht.

WebDriver Protocol-Befehl. Weitere Details finden Sie in der offiziellen Protokolldokumentation.

Info

Dieser Protokollbefehl ist in der folgenden praktischen Methode eingebettet: getWindowSize. Es wird empfohlen, stattdessen diesen Befehl zu verwenden.

Verwendung

browser.getWindowRect()

Beispiel

examples.js

loading...

View on GitHub

Gibt zurück

• <Object> windowRect: Eine JSON-Darstellung eines "window rect"-Objekts. Dies hat 4 Eigenschaften: x, y, width und height.

---

setWindowRect

Der Set Window Rect Befehl ändert die Größe und Position des Betriebssystemfensters, das dem aktuellen übergeordneten Browsing-Kontext entspricht.

WebDriver Protocol-Befehl. Weitere Details finden Sie in der offiziellen Protokolldokumentation.

Info

Dieser Protokollbefehl ist in der folgenden praktischen Methode eingebettet: setWindowSize. Es wird empfohlen, stattdessen diesen Befehl zu verwenden.

Verwendung

browser.setWindowRect(x, y, width, height)

Parameter

Name	Typ	Details
x	number, null	das screenX-Attribut des Fensterobjekts
y	number, null	das screenY-Attribut des Fensterobjekts
width	number, null	die Breite der äußeren Abmessungen des übergeordneten Browsing-Kontexts, einschließlich Browser-Chrome usw...
height	number, null	die Höhe der äußeren Abmessungen des übergeordneten Browsing-Kontexts, einschließlich Browser-Chrome usw...

Beispiel

examples.js

loading...

View on GitHub

Gibt zurück

• <Object> windowRect: Eine JSON-Darstellung eines "window rect"-Objekts basierend auf dem neuen Fensterzustand.

---

maximizeWindow

Der Maximize Window Befehl ruft die fenstermanager-spezifische "maximize"-Operation auf, falls vorhanden, für das Fenster, das den aktuellen übergeordneten Browsing-Kontext enthält. Dies vergrößert das Fenster typischerweise auf die maximal verfügbare Größe, ohne in den Vollbildmodus zu gehen.

WebDriver Protocol-Befehl. Weitere Details finden Sie in der offiziellen Protokolldokumentation.

Verwendung

browser.maximizeWindow()

Beispiel

examples.js

loading...

View on GitHub

Gibt zurück

• <Object> windowRect: Eine JSON-Darstellung eines "window rect"-Objekts basierend auf dem neuen Fensterzustand.

---

minimizeWindow

Der Minimize Window Befehl ruft die fenstermanager-spezifische "minimize"-Operation auf, falls vorhanden, für das Fenster, das den aktuellen übergeordneten Browsing-Kontext enthält. Dies versteckt das Fenster typischerweise in der System-Taskleiste.

WebDriver Protocol-Befehl. Weitere Details finden Sie in der offiziellen Protokolldokumentation.

Verwendung

browser.minimizeWindow()

Gibt zurück

• <Object> windowRect: Eine JSON-Darstellung eines "window rect"-Objekts des (neuen) aktuellen übergeordneten Browsing-Kontexts.

---

fullscreenWindow

Der Fullscreen Window Befehl ruft die fenstermanager-spezifische "full screen"-Operation auf, falls vorhanden, für das Fenster, das den aktuellen übergeordneten Browsing-Kontext enthält. Dies vergrößert das Fenster typischerweise auf die Größe des physischen Displays und kann Browser-Chrome-Elemente wie Symbolleisten ausblenden.

WebDriver Protocol-Befehl. Weitere Details finden Sie in der offiziellen Protokolldokumentation.

Verwendung

browser.fullscreenWindow()

Gibt zurück

• <Object> windowRect: Eine JSON-Darstellung eines "window rect"-Objekts des (neuen) aktuellen übergeordneten Browsing-Kontexts.

---

findElement

Der Find Element Befehl wird verwendet, um ein Element im aktuellen Browsing-Kontext zu finden, das für zukünftige Befehle verwendet werden kann. Dieser Befehl gibt eine JSON-Darstellung des Elements zurück, die an den $ Befehl übergeben werden kann, um die Referenz in ein erweitertes WebdriverIO-Element zu transformieren.

WebDriver Protocol-Befehl. Weitere Details finden Sie in der offiziellen Protokolldokumentation.

Info

Dieser Protokollbefehl ist in der folgenden praktischen Methode eingebettet: $. Es wird empfohlen, stattdessen diesen Befehl zu verwenden.

Verwendung

browser.findElement(using, value)

Parameter

Name	Typ	Details
using	string	eine gültige Element-Lokalisierungsstrategie
value	string	der tatsächliche Selektor, der verwendet wird, um ein Element zu finden

Beispiel

examples.js

loading...

View on GitHub

Gibt zurück

• <object> element: Eine JSON-Darstellung eines Element-Objekts, z.B. { 'element-6066-11e4-a52e-4f735466cecf': 'ELEMENT_1' }.

---

findElementFromShadowRoot

Der Find Element From Shadow Root Befehl wird verwendet, um ein Element innerhalb des Shadow-Root eines Elements zu finden, das für zukünftige Befehle verwendet werden kann. Dieser Befehl gibt eine JSON-Darstellung des Elements zurück, die an den $ Befehl übergeben werden kann, um die Referenz in ein erweitertes WebdriverIO-Element zu transformieren.

WebDriver Protocol-Befehl. Weitere Details finden Sie in der offiziellen Protokolldokumentation.

Info

Dieser Protokollbefehl ist in der folgenden praktischen Methode eingebettet: shadow$. Es wird empfohlen, stattdessen diesen Befehl zu verwenden.

Verwendung

browser.findElementFromShadowRoot(shadowId, using, value)

Parameter

Name	Typ	Details
shadowId	String	Element-ID eines Shadow-Root-Elements
using	string	eine gültige Element-Lokalisierungsstrategie
value	string	der tatsächliche Selektor, der verwendet wird, um ein Element zu finden

Beispiel

examples.js

loading...

View on GitHub

Gibt zurück

• <object> element: Eine JSON-Darstellung eines Element-Shadow-Objekts, z.B. { 'element-6066-11e4-a52e-4f735466cecf': 'ELEMENT_1' }.

---

findElements

Der Find Elements Befehl wird verwendet, um Elemente im aktuellen Browsing-Kontext zu finden, die für zukünftige Befehle verwendet werden können. Dieser Befehl gibt ein Array von JSON-Darstellungen der Elemente zurück, die an den $ Befehl übergeben werden können, um die Referenz in ein erweitertes WebdriverIO-Element zu transformieren (siehe findElement).

WebDriver Protocol-Befehl. Weitere Details finden Sie in der offiziellen Protokolldokumentation.

Info

Dieser Protokollbefehl ist in der folgenden praktischen Methode eingebettet: $$. Es wird empfohlen, stattdessen diesen Befehl zu verwenden.

Verwendung

browser.findElements(using, value)

Parameter

Name	Typ	Details
using	string	eine gültige Element-Lokalisierungsstrategie
value	string	der tatsächliche Selektor, der verwendet wird, um ein Element zu finden

Beispiel

examples.js

loading...

View on GitHub

Gibt zurück

• <object[]> elements: Eine (möglicherweise leere) JSON-Liste von Darstellungen eines Element-Objekts, z.B. [{ 'element-6066-11e4-a52e-4f735466cecf': 'ELEMENT_1' }].

---

findElementsFromShadowRoot

Der Find Elements Befehl wird verwendet, um Elemente innerhalb des Shadow-Root eines Elements zu finden, die für zukünftige Befehle verwendet werden können. Dieser Befehl gibt ein Array von JSON-Darstellungen der Elemente zurück, die an den $ Befehl übergeben werden können, um die Referenz in ein erweitertes WebdriverIO-Element zu transformieren (siehe findElement).

WebDriver Protocol-Befehl. Weitere Details finden Sie in der offiziellen Protokolldokumentation.

Info

Dieser Protokollbefehl ist in der folgenden praktischen Methode eingebettet: shadow$$. Es wird empfohlen, stattdessen diesen Befehl zu verwenden.

Verwendung

browser.findElementsFromShadowRoot(shadowId, using, value)

Parameter

Name	Typ	Details
shadowId	String	Element-ID eines Shadow-Root-Elements
using	string	eine gültige Element-Lokalisierungsstrategie
value	string	der tatsächliche Selektor, der verwendet wird, um ein Element zu finden

Beispiel

examples.js

loading...

View on GitHub

Gibt zurück

• <object[]> elements: Eine (möglicherweise leere) JSON-Liste von Darstellungen eines Element-Objekts, z.B. { 'element-6066-11e4-a52e-4f735466cecf': 'ELEMENT_1' }.

---

findElementFromElement

Der Find Element From Element Befehl wird verwendet, um ein Element von einem Web-Element im aktuellen Browsing-Kontext zu finden, das für zukünftige Befehle verwendet werden kann. Dieser Befehl gibt eine JSON-Darstellung des Elements zurück, die an den $ Befehl übergeben werden kann, um die Referenz in ein erweitertes WebdriverIO-Element zu transformieren (siehe findElement).

WebDriver Protocol-Befehl. Weitere Details finden Sie in der offiziellen Protokolldokumentation.

Info

Dieser Protokollbefehl ist in der folgenden praktischen Methode eingebettet: $. Es wird empfohlen, stattdessen diesen Befehl zu verwenden.

Verwendung

browser.findElementFromElement(elementId, using, value)

Parameter

Name	Typ	Details
elementId	String	die ID eines Elements, das in einem früheren Aufruf von Find Element(s) zurückgegeben wurde
using	string	eine gültige Element-Lokalisierungsstrategie
value	string	der tatsächliche Selektor, der verwendet wird, um ein Element zu finden

Beispiel

examples.js

loading...

View on GitHub

Gibt zurück

• <object> element: Eine JSON-Darstellung eines Element-Objekts, z.B. { 'element-6066-11e4-a52e-4f735466cecf': 'ELEMENT_1' }.

---

findElementsFromElement

Der Find Elements From Element Befehl wird verwendet, um Elemente von einem Web-Element im aktuellen Browsing-Kontext zu finden, die für zukünftige Befehle verwendet werden können. Dieser Befehl gibt ein Array von JSON-Darstellungen der Elemente zurück, die an den $ Befehl übergeben werden können, um die Referenz in ein erweitertes WebdriverIO-Element zu transformieren (siehe findElement).

WebDriver Protocol-Befehl. Weitere Details finden Sie in der offiziellen Protokolldokumentation.

Info

Dieser Protokollbefehl ist in der folgenden praktischen Methode eingebettet: $$. Es wird empfohlen, stattdessen diesen Befehl zu verwenden.

Verwendung

browser.findElementsFromElement(elementId, using, value)

Parameter

Name	Typ	Details
elementId	String	die ID eines Elements, das in einem früheren Aufruf von Find Element(s) zurückgegeben wurde
using	string	eine gültige Element-Lokalisierungsstrategie
value	string	der tatsächliche Selektor, der verwendet wird, um ein Element zu finden

Beispiel

examples.js

loading...

View on GitHub

Gibt zurück

• <object[]> elements: Eine (möglicherweise leere) JSON-Liste von Darstellungen eines Element-Objekts, z.B. [{ 'element-6066-11e4-a52e-4f735466cecf': 'ELEMENT_1' }].

---

getElementShadowRoot

Ruft das Shadow-Root-Objekt eines Elements ab. Das Ergebnisobjekt kann verwendet werden, um Elemente innerhalb dieses Shadow-Roots zu finden, z.B. mit findElementFromShadowRoots oder findElementsFromShadowRoots.

WebDriver Protocol-Befehl. Weitere Details finden Sie in der offiziellen Protokolldokumentation.

Info

Dieser Protokollbefehl ist in der folgenden praktischen Methode eingebettet: shadow$. Es wird empfohlen, stattdessen diesen Befehl zu verwenden.

Verwendung

browser.getElementShadowRoot(elementId)

Parameter

Name	Typ	Details
elementId	String	die ID eines Elements, das in einem früheren Aufruf von Find Element(s) zurückgegeben wurde

Beispiel

examples.js

loading...

View on GitHub

Gibt zurück

• <string> shadowRoot: Eine JSON-Darstellung eines Element-Shadow-Roots, z.B. { 'shadow-6066-11e4-a52e-4f735466cecf': 'ELEMENT_1' }.

---

getActiveElement

Get Active Element gibt das aktive Element des Dokumentelements des aktuellen Browsing-Kontexts zurück. Dieser Befehl gibt eine JSON-Darstellung des Elements zurück, die an den $ Befehl übergeben werden kann, um die Referenz in ein erweitertes WebdriverIO-Element zu transformieren (siehe findElement).

WebDriver Protocol-Befehl. Weitere Details finden Sie in der offiziellen Protokolldokumentation.

Verwendung

browser.getActiveElement()

Beispiel

examples.js

loading...

View on GitHub

Gibt zurück

• <string> element: Eine JSON-Darstellung eines Element-Objekts, z.B. { 'element-6066-11e4-a52e-4f735466cecf': 'ELEMENT_1' }.

---

isElementSelected

Is Element Selected bestimmt, ob das referenzierte Element ausgewählt ist oder nicht. Diese Operation ist nur sinnvoll für Eingabeelemente der Zustände Checkbox und Radio Button oder für Option-Elemente.

WebDriver Protocol-Befehl. Weitere Details finden Sie in der offiziellen Protokolldokumentation.

Info

Dieser Protokollbefehl ist in der folgenden praktischen Methode eingebettet: isSelected. Es wird empfohlen, stattdessen diesen Befehl zu verwenden.

Verwendung

browser.isElementSelected(elementId)

Parameter

Name	Typ	Details
elementId	String	die ID eines Elements, das in einem früheren Aufruf von Find Element(s) zurückgegeben wurde

Beispiel

examples.js

loading...

View on GitHub

Gibt zurück

• <Boolean> isSelected: true oder false basierend auf dem ausgewählten Zustand.

---

isElementDisplayed

Is Element Displayed bestimmt die Sichtbarkeit eines Elements, die von dem geleitet wird, was für das menschliche Auge wahrnehmbar sichtbar ist. In diesem Kontext steht die Anzeigbarkeit eines Elements nicht im Zusammenhang mit den CSS-Eigenschaften visibility oder display.

WebDriver Protocol-Befehl. Weitere Details finden Sie in der offiziellen Protokolldokumentation.

Info

Dieser Protokollbefehl ist in der folgenden praktischen Methode eingebettet: isDisplayed. Es wird empfohlen, stattdessen diesen Befehl zu verwenden.

Verwendung

browser.isElementDisplayed(elementId)

Parameter

Name	Typ	Details
elementId	String	die ID eines Elements, das in einem früheren Aufruf von Find Element(s) zurückgegeben wurde

Beispiel

examples.js

loading...

View on GitHub

Gibt zurück

• <Boolean> isDisplayed: true oder false basierend auf dem sichtbaren Zustand.

---

getElementAttribute

Der Get Element Attribute Befehl gibt das Attribut eines Web-Elements zurück.

WebDriver Protocol-Befehl. Weitere Details finden Sie in der offiziellen Protokolldokumentation.

Info

Dieser Protokollbefehl ist in der folgenden praktischen Methode eingebettet: getAttribute. Es wird empfohlen, stattdessen diesen Befehl zu verwenden.

Verwendung

browser.getElementAttribute(elementId, name)

Parameter

Name	Typ	Details
elementId	String	die ID eines Elements, das in einem früheren Aufruf von Find Element(s) zurückgegeben wurde
name	String	Name des abzurufenden Attributwerts

Beispiel

examples.js

loading...

View on GitHub

Gibt zurück

• <string> attribute: Das benannte Attribut des Elements.

---

getElementProperty

Der Get Element Property Befehl gibt das Ergebnis des Abrufs einer Eigenschaft eines Elements zurück.

WebDriver Protocol-Befehl. Weitere Details finden Sie in der offiziellen Protokolldokumentation.

Info

Dieser Protokollbefehl ist in der folgenden praktischen Methode eingebettet: getProperty. Es wird empfohlen, stattdessen diesen Befehl zu verwenden.

Verwendung

browser.getElementProperty(elementId, name)

Parameter

Name	Typ	Details
elementId	String	die ID eines Elements, das in einem früheren Aufruf von Find Element(s) zurückgegeben wurde
name	String	Name der abzurufenden Attributeigenschaft

Beispiel

examples.js

loading...

View on GitHub

Gibt zurück

• <string> property: Die benannte Eigenschaft des Elements, auf die durch Aufruf von GetOwnProperty auf dem Element-Objekt zugegriffen wird.

---

getElementCSSValue

Der Get Element CSS Value Befehl ruft den berechneten Wert der angegebenen CSS-Eigenschaft des gegebenen Web-Elements ab.

WebDriver Protocol-Befehl. Weitere Details finden Sie in der offiziellen Protokolldokumentation.

Info

Dieser Protokollbefehl ist in der folgenden praktischen Methode eingebettet: getCSSProperty. Es wird empfohlen, stattdessen diesen Befehl zu verwenden.

Verwendung

browser.getElementCSSValue(elementId, propertyName)

Parameter

Name	Typ	Details
elementId	String	die ID eines Elements, das in einem früheren Aufruf von Find Element(s) zurückgegeben wurde
propertyName	String	Name der abzurufenden CSS-Eigenschaft

Beispiel

examples.js

loading...

View on GitHub

Gibt zurück

• <string> cssValue: Der berechnete Wert des Parameters, der der Eigenschaft name aus den Stildeklarationen des Elements entspricht (es sei denn, der Dokumenttyp ist xml, in diesem Fall ist der Rückgabewert einfach die leere Zeichenfolge).

---

getElementText

Der Get Element Text Befehl soll den Text eines Elements "wie gerendert" zurückgeben. Der gerenderte Text eines Elements wird auch zum Lokalisieren von Elementen nach ihrem Linktext und teilweisem Linktext verwendet.

WebDriver Protocol-Befehl. Weitere Details finden Sie in der offiziellen Protokolldokumentation.

Verwendung

browser.getElementText(elementId)

Parameter

Name	Typ	Details
elementId	String	die ID eines Elements, das in einem früheren Aufruf von Find Element(s) zurückgegeben wurde

Beispiel

examples.js

loading...

View on GitHub

Gibt zurück

• <string> text: Der sichtbare Text des Elements (einschließlich untergeordneter Elemente), gemäß dem im Selenium Atoms für bot.dom.getVisibleText definierten Algorithmus.

---

getElementTagName

Der Get Element Tag Name Befehl gibt den qualifizierten Elementnamen des gegebenen Web-Elements zurück.

WebDriver Protocol-Befehl. Weitere Details finden Sie in der offiziellen Protokolldokumentation.

Info

Dieser Protokollbefehl ist in der folgenden praktischen Methode eingebettet: getTagName. Es wird empfohlen, stattdessen diesen Befehl zu verwenden.

Verwendung

browser.getElementTagName(elementId)

Parameter

Name	Typ	Details
elementId	String	die ID eines Elements, das in einem früheren Aufruf von Find Element(s) zurückgegeben wurde

Beispiel

examples.js

loading...

View on GitHub

Gibt zurück

• <string> text: Das tagName-Attribut des Elements.

---

getElementRect

Der Get Element Rect Befehl gibt die Abmessungen und Koordinaten des gegebenen Web-Elements zurück.

WebDriver Protocol-Befehl. Weitere Details finden Sie in der offiziellen Protokolldokumentation.

Info

Dieser Protokollbefehl ist in den folgenden praktischen Methoden eingebettet: getSize, getLocation. Es wird empfohlen, diese Befehle stattdessen zu verwenden.

Verwendung

browser.getElementRect(elementId)

Parameter

Name	Typ	Details
elementId	String	die ID eines Elements, das in einem früheren Aufruf von Find Element(s) zurückgegeben wurde

Beispiel

examples.js

loading...

View on GitHub

Gibt zurück

• <Object> elementRect: Ein JSON-Objekt, das die Position und den Begrenzungsrahmen des Elements darstellt.

---

isElementEnabled

Is Element Enabled bestimmt, ob das referenzierte Element aktiviert ist oder nicht. Diese Operation ist nur für Formularsteuerelemente sinnvoll.

WebDriver Protocol-Befehl. Weitere Details finden Sie in der offiziellen Protokolldokumentation.

Info

Dieser Protokollbefehl ist in der folgenden praktischen Methode eingebettet: isEnabled. Es wird empfohlen, stattdessen diesen Befehl zu verwenden.

Verwendung

browser.isElementEnabled(elementId)

Parameter

Name	Typ	Details
elementId	String	die ID eines Elements, das in einem früheren Aufruf von Find Element(s) zurückgegeben wurde

Beispiel

examples.js

loading...

View on GitHub

Gibt zurück

• <Boolean> isEnabled: Wenn das Element in einem XML-Dokument ist oder ein deaktiviertes Formularelement ist: false, andernfalls true.

---

elementClick

Der Element Click Befehl scrollt das Element in die Ansicht, wenn es noch nicht Zeiger-interaktionsfähig ist, und klickt auf seinen sichtbaren Mittelpunkt. Wenn der Mittelpunkt des Elements durch ein anderes Element verdeckt wird, wird ein Fehler "element click intercepted" zurückgegeben. Wenn das Element außerhalb des Viewports liegt, wird ein Fehler "element not interactable" zurückgegeben.

WebDriver Protocol-Befehl. Weitere Details finden Sie in der offiziellen Protokolldokumentation.

Info

Dieser Protokollbefehl ist in der folgenden praktischen Methode eingebettet: click. Es wird empfohlen, stattdessen diesen Befehl zu verwenden.

Verwendung

browser.elementClick(elementId)

Parameter

Name	Typ	Details
elementId	String	die ID eines Elements, das in einem früheren Aufruf von Find Element(s) zurückgegeben wurde

Beispiel

examples.js

loading...

View on GitHub

---

elementClear

Der Element Clear Befehl scrollt ein bearbeitbares oder zurücksetzbares Element in die Ansicht und versucht dann, seine ausgewählten Dateien oder Textinhalte zu löschen.

WebDriver Protocol-Befehl. Weitere Details finden Sie in der offiziellen Protokolldokumentation.

Info

Dieser Protokollbefehl ist in der folgenden praktischen Methode eingebettet: clearValue. Es wird empfohlen, stattdessen diesen Befehl zu verwenden.

Verwendung

browser.elementClear(elementId)

Parameter

Name	Typ	Details
elementId	String	die ID eines Elements, das in einem früheren Aufruf von Find Element(s) zurückgegeben wurde

Beispiel

examples.js

loading...

View on GitHub

---

elementSendKeys

Der Element Send Keys Befehl scrollt das Formularsteuerelement in die Ansicht und sendet dann die bereitgestellten Tasten an das Element. Falls das Element nicht tastatur-interaktionsfähig ist, wird ein Fehler "element not interactable" zurückgegeben.

Der für die Eingabe verwendete Tasteneingabezustand kann mittendurch beim "Tippen" gelöscht werden, indem die Null-Taste gesendet wird, die U+E000 (NULL) ist.

WebDriver Protocol-Befehl. Weitere Details finden Sie in der offiziellen Protokolldokumentation.

Info

Dieser Protokollbefehl ist in den folgenden praktischen Methoden eingebettet: addValue, setValue. Es wird empfohlen, diese Befehle stattdessen zu verwenden.

Verwendung

browser.elementSendKeys(elementId, text)

Parameter

Name	Typ	Details
elementId	String	die ID eines Elements, das in einem früheren Aufruf von Find Element(s) zurückgegeben wurde
text	string	Zeichenfolge, die als Tastatureingaben an das Element gesendet werden soll

Beispiel

examples.js

loading...

View on GitHub

---

getPageSource

Der Get Page Source Befehl gibt eine Zeichenkettenserialisierung des DOM des aktuellen aktiven Dokuments des Browsing-Kontexts zurück.

WebDriver Protocol-Befehl. Weitere Details finden Sie in der offiziellen Protokolldokumentation.

Verwendung

browser.getPageSource()

Beispiel

examples.js

loading...

View on GitHub

Gibt zurück

• <string> pageSource: das DOM des aktuellen aktiven Dokuments des Browsing-Kontexts

---

executeScript

Der Execute Script Befehl führt eine JavaScript-Funktion im Kontext des aktuellen Browsing-Kontexts aus und gibt den Rückgabewert der Funktion zurück.

WebDriver Protocol-Befehl. Weitere Details finden Sie in der offiziellen Protokolldokumentation.

Info

Dieser Protokollbefehl ist in der folgenden praktischen Methode eingebettet: execute. Es wird empfohlen, stattdessen diesen Befehl zu verwenden.

Verwendung

browser.executeScript(script, args)

Parameter

Name	Typ	Details
script	string	eine Zeichenfolge, der JavaScript-Funktionskörper, den Sie ausführen möchten
args	string, object, number, boolean, null, undefined[]	ein Array von JSON-Werten, die deserialisiert und als Argumente an Ihre Funktion übergeben werden

Beispiel

examples.js

loading...

View on GitHub

Gibt zurück

• <*> result: Entweder der Rückgabewert Ihres Skripts, die Erfüllung des von Ihrem Skript zurückgegebenen Versprechens oder der Fehler, der der Grund für die Ablehnung des von Ihrem Skript zurückgegebenen Versprechens war.

---

executeAsyncScript

Der Execute Async Script Befehl führt JavaScript als anonyme Funktion aus. Im Gegensatz zum Execute Script Befehl wird das Ergebnis der Funktion ignoriert. Stattdessen wird ein zusätzliches Argument als letztes Argument für die Funktion bereitgestellt. Dies ist eine Funktion, die bei Aufruf ihr erstes Argument als Antwort zurückgibt.

WebDriver Protocol-Befehl. Weitere Details finden Sie in der offiziellen Protokolldokumentation.

Info

Dieser Protokollbefehl ist in der folgenden praktischen Methode eingebettet: executeAsync. Es wird empfohlen, stattdessen diesen Befehl zu verwenden.

Verwendung

browser.executeAsyncScript(script, args)

Parameter

Name	Typ	Details
script	string	eine Zeichenfolge, der JavaScript-Funktionskörper, den Sie ausführen möchten
args	string, object, number, boolean, null, undefined[]	ein Array von JSON-Werten, die deserialisiert und als Argumente an Ihre Funktion übergeben werden

Beispiel

examples.js

loading...

View on GitHub

Gibt zurück

• <*> result: Entweder der Rückgabewert Ihres Skripts, die Erfüllung des von Ihrem Skript zurückgegebenen Versprechens oder der Fehler, der der Grund für die Ablehnung des von Ihrem Skript zurückgegebenen Versprechens war.

---

getAllCookies

Der Get All Cookies Befehl gibt alle Cookies zurück, die mit der Adresse des aktiven Dokuments des aktuellen Browsing-Kontexts verknüpft sind.

WebDriver Protocol-Befehl. Weitere Details finden Sie in der offiziellen Protokolldokumentation.

Verwendung

browser.getAllCookies()

Beispiel

examples.js

loading...

View on GitHub

Gibt zurück

• <Object[]> cookies: Eine Liste serialisierter Cookies. Jedes serialisierte Cookie hat eine Reihe optionaler Felder, die zusätzlich zu name und value zurückgegeben werden können oder auch nicht.

---

addCookie

Der Add Cookie Befehl fügt ein einzelnes Cookie zum Cookie-Speicher hinzu, der mit der Adresse des aktiven Dokuments verknüpft ist.

WebDriver Protocol-Befehl. Weitere Details finden Sie in der offiziellen Protokolldokumentation.

Verwendung

browser.addCookie(cookie)

Parameter

Name	Typ	Details
cookie	object	Ein JSON-Objekt, das ein Cookie darstellt. Es muss mindestens die Felder name und value haben und kann weitere haben, einschließlich Ablaufzeit usw.

Beispiel

examples.js

loading...

View on GitHub

---

deleteAllCookies

Der Delete All Cookies Befehl ermöglicht das Löschen aller Cookies, die mit der Adresse des aktiven Dokuments verknüpft sind.

WebDriver Protocol-Befehl. Weitere Details finden Sie in der offiziellen Protokolldokumentation.

Verwendung

browser.deleteAllCookies()

Beispiel

examples.js

loading...

View on GitHub

---

getNamedCookie

Der Get Named Cookie Befehl gibt das Cookie mit dem angeforderten Namen aus den zugehörigen Cookies im Cookie-Speicher des aktiven Dokuments des aktuellen Browsing-Kontexts zurück. Wenn kein Cookie gefunden wird, wird ein Fehler "no such cookie" zurückgegeben.

WebDriver Protocol-Befehl. Weitere Details finden Sie in der offiziellen Protokolldokumentation.

Verwendung

browser.getNamedCookie(name)

Parameter

Name	Typ	Details
name	String	Name des abzurufenden Cookies

Beispiel

examples.js

loading...

View on GitHub

Gibt zurück

• <Object> cookie: Ein serialisiertes Cookie mit name und value Feldern. Es gibt eine Reihe optionaler Felder wie path, domain und expiry-time, die ebenfalls vorhanden sein können.

---

deleteCookie

Der Delete Cookie Befehl ermöglicht es Ihnen, entweder ein einzelnes Cookie nach Parametername zu löschen oder alle Cookies, die mit der Adresse des aktiven Dokuments verknüpft sind, wenn name undefiniert ist.

WebDriver Protocol-Befehl. Weitere Details finden Sie in der offiziellen Protokolldokumentation.

Verwendung

browser.deleteCookie(name)

Parameter

Name	Typ	Details
name	String	Name des zu löschenden Cookies

Beispiel

examples.js

loading...

View on GitHub

---

performActions

Der Perform Actions Befehl wird verwendet, um komplexe Benutzeraktionen auszuführen. Siehe Spezifikation für weitere Details.

WebDriver Protocol-Befehl. Weitere Details finden Sie in der offiziellen Protokolldokumentation.

Verwendung

browser.performActions(actions)

Parameter

Name	Typ	Details
actions	object[]	eine Liste von Objekten, von denen jedes eine Eingabequelle und die zugehörigen Aktionen darstellt

---

releaseActions

Der Release Actions Befehl wird verwendet, um alle Tasten und Zeigerknöpfe freizugeben, die derzeit gedrückt sind. Dies führt dazu, dass Ereignisse ausgelöst werden, als ob der Zustand durch eine explizite Reihe von Aktionen freigegeben wurde. Es löscht auch den gesamten internen Zustand der virtuellen Geräte.

WebDriver Protocol-Befehl. Weitere Details finden Sie in der offiziellen Protokolldokumentation.

Verwendung

browser.releaseActions()

---

dismissAlert

Der Dismiss Alert Befehl schließt einen einfachen Dialog, falls vorhanden, andernfalls gibt es einen Fehler. Eine Anfrage zum Schließen einer Warnmeldung für den Benutzer, die möglicherweise nicht unbedingt einen Schließen-Button hat, hat den gleichen Effekt wie das Akzeptieren.

WebDriver Protocol-Befehl. Weitere Details finden Sie in der offiziellen Protokolldokumentation.

Verwendung

browser.dismissAlert()

Beispiel

examples.js

loading...

View on GitHub

---

acceptAlert

Der Accept Alert Befehl akzeptiert einen einfachen Dialog, falls vorhanden, andernfalls gibt es einen Fehler.

WebDriver Protocol-Befehl. Weitere Details finden Sie in der offiziellen Protokolldokumentation.

Verwendung

browser.acceptAlert()

---

getAlertText

Der Get Alert Text Befehl gibt die Nachricht der aktuellen Benutzeraufforderung zurück. Wenn es keine aktuelle Benutzeraufforderung gibt, gibt er einen Fehler zurück.

WebDriver Protocol-Befehl. Weitere Details finden Sie in der offiziellen Protokolldokumentation.

Verwendung

browser.getAlertText()

Beispiel

examples.js

loading...

View on GitHub

Gibt zurück

• <string> alertText: Die Nachricht der Benutzeraufforderung.

---

sendAlertText

Der Send Alert Text Befehl setzt das Textfeld einer window.prompt-Benutzeraufforderung auf den angegebenen Wert.

WebDriver Protocol-Befehl. Weitere Details finden Sie in der offiziellen Protokolldokumentation.

Verwendung

browser.sendAlertText(text)

Parameter

Name	Typ	Details
text	string	Zeichenkette, auf die die Aufforderung gesetzt werden soll

---

takeScreenshot

Der Take Screenshot Befehl macht einen Screenshot vom Viewport des übergeordneten Browsing-Kontexts.

WebDriver Protocol-Befehl. Weitere Details finden Sie in der offiziellen Protokolldokumentation.

Verwendung

browser.takeScreenshot()

Gibt zurück

• <string> screenshot: Die Base64-kodierten PNG-Bilddaten, die den Screenshot des anfänglichen Viewports umfassen.

---

takeElementScreenshot

Der Take Element Screenshot Befehl macht einen Screenshot der sichtbaren Region, die durch das Begrenzungsrechteck eines Elements umfasst wird.

WebDriver Protocol-Befehl. Weitere Details finden Sie in der offiziellen Protokolldokumentation.

Verwendung

browser.takeElementScreenshot(elementId, scroll)

Parameter

Name	Typ	Details
elementId	String	die ID eines Elements, das in einem früheren Aufruf von Find Element(s) zurückgegeben wurde
scroll optional	boolean	scrolle das Element in die Ansicht. Standard: true

Gibt zurück

• <string> screenshot: Die Base64-kodierten PNG-Bilddaten, die den Screenshot der sichtbaren Region des Begrenzungsrechtecks eines Elements umfassen, nachdem es in die Ansicht gescrollt wurde.

---

getElementComputedRole

Ruft die berechnete WAI-ARIA-Rolle eines Elements ab.

WebDriver Protocol-Befehl. Weitere Details finden Sie in der offiziellen Protokolldokumentation.

Verwendung

browser.getElementComputedRole(elementId)

Parameter

Name	Typ	Details
elementId	String	die ID eines Elements, das in einem früheren Aufruf von Find Element(s) zurückgegeben wurde

Gibt zurück

• <string> role: Das Ergebnis der Berechnung der WAI-ARIA-Rolle des Elements.

---

getElementComputedLabel

Ruft den barrierefreien Namen des Elements ab.

WebDriver Protocol-Befehl. Weitere Details finden Sie in der offiziellen Protokolldokumentation.

Verwendung

browser.getElementComputedLabel(elementId)

Parameter

Name	Typ	Details
elementId	String	die ID eines Elements, das in einem früheren Aufruf von Find Element(s) zurückgegeben wurde

Gibt zurück

• <string> label: Das Ergebnis einer Berechnung des barrierefreien Namens und der Beschreibung für den barrierefreien Namen des Elements.

---

setPermissions

Simuliert die Benutzermodifikation des Berechtigungszustands eines PermissionDescriptors. Hinweis: Diese Funktion ist noch nicht in allen Browsern verfügbar.

WebDriver Protocol-Befehl. Weitere Details finden Sie in der offiziellen Protokolldokumentation.

Verwendung

browser.setPermissions(descriptor, state, oneRealm)

Parameter

Name	Typ	Details
descriptor	object	Jede leistungsstarke Funktion hat einen oder mehrere Aspekte, für die Websites um Berechtigungen zum Zugriff bitten können. Um diese Aspekte zu beschreiben, definiert jede Funktion einen Untertyp von PermissionDescriptor als ihren Berechtigungsdeskriptortyp. Hinweis: Diese Funktion ist noch nicht in allen Browsern verfügbar.
state	string	Bestimmt, ob die Erlaubnis erteilt, verweigert oder abgefragt wird.
oneRealm optional	boolean	Ob Berechtigungen auf alle Ausführungskontexte angewendet werden sollen oder nicht.

Beispiele

// MIDI-Berechtigungen festlegen
browser.setPermissions(
  { name: 'midi', sysex: true },
  'granted' // kann auch "denied" oder "prompt" sein
);

// Zwischenablage-Berechtigungen festlegen
browser.setPermissions({ name: 'clipboard-read' }, 'granted');
// jetzt können Sie die Zwischenablage lesen via, z.B.
const clipboardText = await browser.execute(() => navigator.clipboard.readText());

---

generateTestReport

Erzeugt einen Bericht für Tests. Erweiterung für Reporting API. Hinweis: Diese Funktion ist noch nicht in allen Browsern verfügbar.

WebDriver Protocol-Befehl. Weitere Details finden Sie in der offiziellen Protokolldokumentation.

Verwendung

browser.generateTestReport(message, group)

Parameter

Name	Typ	Details
message	string	Nachricht, die im Bericht angezeigt werden soll.
group optional	string	Gibt die Endpunktgruppe an, an die der Bericht geliefert werden soll.

---

createMockSensor

Erstellt einen Mock-Sensor, um Sensoren wie den Umgebungslichtsensor zu emulieren. Hinweis: Diese Funktion ist noch nicht in allen Browsern verfügbar.

WebDriver Protocol-Befehl. Weitere Details finden Sie in der offiziellen Protokolldokumentation.

Verwendung

browser.createMockSensor(mockSensorType, maxSamplingFrequency, minSamplingFrequency)

Parameter

Name	Typ	Details
mockSensorType	string	Typ der zu emulierenden Sensor-API, z.B. 'ambient-light'
maxSamplingFrequency optional	number	Eine Gleitkommazahl, die die Frequenz in Hz darstellt und verwendet wird, um die maximal unterstützte Abtastfrequenz für den zugehörigen Mock-Sensor festzulegen.
minSamplingFrequency optional	number	Eine Gleitkommazahl, die die Frequenz in Hz darstellt und verwendet wird, um die minimal unterstützte Abtastfrequenz für den zugehörigen Mock-Sensor festzulegen.

---

getMockSensor

Ruft Informationen über einen bestimmten Typ von Mock-Sensor ab. Hinweis: Diese Funktion ist noch nicht in allen Browsern verfügbar.

WebDriver Protocol-Befehl. Weitere Details finden Sie in der offiziellen Protokolldokumentation.

Verwendung

browser.getMockSensor(type)

Parameter

Name	Typ	Details
type	String	Mock-Sensor-Typ, von dem Informationen abgerufen werden sollen.

Gibt zurück

• <object> sensorReading: Werte der Mock-Sensor-Lesung.

---

updateMockSensor

Aktualisiert den Mock-Sensor-Typ. Hinweis: Diese Funktion ist noch nicht in allen Browsern verfügbar.

WebDriver Protocol-Befehl. Weitere Details finden Sie in der offiziellen Protokolldokumentation.

Verwendung

browser.updateMockSensor(type, mockSensorType, maxSamplingFrequency, minSamplingFrequency)

Parameter

Name	Typ	Details
type	String	Mock-Sensor-Typ, für den Informationen aktualisiert werden sollen.
mockSensorType	string	Typ der zu emulierenden Sensor-API, z.B. 'ambient-light'
maxSamplingFrequency optional	number	Eine Gleitkommazahl, die die Frequenz in Hz darstellt und verwendet wird, um die maximal unterstützte Abtastfrequenz für den zugehörigen Mock-Sensor festzulegen.
minSamplingFrequency optional	number	Eine Gleitkommazahl, die die Frequenz in Hz darstellt und verwendet wird, um die minimal unterstützte Abtastfrequenz für den zugehörigen Mock-Sensor festzulegen.

---

deleteMockSensor

Der Delete Session Befehl schließt alle übergeordneten Browsing-Kontexte, die mit der aktuellen Sitzung verknüpft sind, beendet die Verbindung und schließt schließlich die aktuelle Sitzung. Hinweis: Diese Funktion ist noch nicht in allen Browsern verfügbar.

WebDriver Protocol-Befehl. Weitere Details finden Sie in der offiziellen Protokolldokumentation.

Verwendung

browser.deleteMockSensor(type)

Parameter

Name	Typ	Details
type	String	Zu löschender Mock-Sensor-Typ.

---

setTimeZone

Simuliert das Ändern einer Zeitzone für Testzwecke. Hinweis: Diese Funktion ist noch nicht in allen Browsern verfügbar.

WebDriver Protocol-Befehl. Weitere Details finden Sie in der offiziellen Protokolldokumentation.

Verwendung

browser.setTimeZone(time_zone)

Parameter

Name	Typ	Details
time_zone	string	Name der Zeitzone, z.B. Asia/Tokyo

---

addVirtualAuthenticator

Erstellt einen Software-Virtual Authenticator.

WebDriver Protocol-Befehl. Weitere Details finden Sie in der offiziellen Protokolldokumentation.

Verwendung

browser.addVirtualAuthenticator(protocol, transport, hasResidentKey, hasUserVerification, isUserConsenting, isUserVerified, extensions, uvm)

Parameter

Name	Typ	Details
protocol optional	string	Gültige Werte: 'ctap1/u2f', 'ctap2', 'ctap2_1'.
transport optional	string	Gültige Werte: 'usb', 'nfc', 'ble' oder 'internal'.
hasResidentKey optional	boolean	Gültige Werte: true, false.
hasUserVerification optional	boolean	Gültige Werte: true, false.
isUserConsenting optional	boolean	Gültige Werte: true, false.
isUserVerified optional	boolean	Gültige Werte: Ein Array, das Erweiterungs-Identifikatoren enthält.
extensions optional	string[]	Gültige Werte: Bis zu 3 User Verification Method-Einträge.
uvm optional	object[]

Gibt zurück

• <string> authenticatorId: Gibt die String-ID des Authentifikators zurück.

---

removeVirtualAuthenticator

Entfernt einen zuvor erstellten Virtual Authenticator.

WebDriver Protocol-Befehl. Weitere Details finden Sie in der offiziellen Protokolldokumentation.

Verwendung

browser.removeVirtualAuthenticator(authenticatorId)

Parameter

Name	Typ	Details
authenticatorId	String	ID des Authentifikators

---

addCredential

Fügt eine Public Key Credential Source in einen bestehenden Virtual Authenticator ein.

WebDriver Protocol-Befehl. Weitere Details finden Sie in der offiziellen Protokolldokumentation.

Verwendung

browser.addCredential(authenticatorId, credentialId, isResidentCredential, rpId, privateKey, userHandle, signCount, largeBlob)

Parameter

Name	Typ	Details
authenticatorId	String	ID des Authentifikators
credentialId	string	Die Credential-ID, kodiert mit Base64url-Kodierung.
isResidentCredential	boolean	Wenn auf true gesetzt, wird eine clientseitig auffindbare Anmeldeinformation erstellt. Wenn auf false gesetzt, wird stattdessen eine serverseitige Anmeldeinformation erstellt.
rpId	string	Die Relying Party ID, auf die die Anmeldeinformation beschränkt ist.
privateKey	string	Ein asymmetrisches Schlüsselpaket, das einen einzelnen privaten Schlüssel gemäß [RFC5958] enthält, kodiert mit Base64url-Kodierung.
userHandle	string	Der mit der Anmeldeinformation verknüpfte userHandle, kodiert mit Base64url-Kodierung. Diese Eigenschaft ist möglicherweise nicht definiert.
signCount	number	Der Anfangswert für einen Signaturzähler, der der Public Key Credential Source zugeordnet ist.
largeBlob optional	string	Der große, anmeldeinformationsspezifische Blob, der der Public Key Credential Source zugeordnet ist, kodiert mit Base64url-Kodierung. Diese Eigenschaft ist möglicherweise nicht definiert.

---

getCredentials

Gibt ein Credential Parameters-Objekt für jede Public Key Credential Source zurück, die in einem Virtual Authenticator gespeichert ist, unabhängig davon, ob sie mit Add Credential oder navigator.credentials.create() gespeichert wurden.

WebDriver Protocol-Befehl. Weitere Details finden Sie in der offiziellen Protokolldokumentation.

Verwendung

browser.getCredentials(authenticatorId)

Parameter

Name	Typ	Details
authenticatorId	String	ID des Authentifikators

Gibt zurück

• <object[]> credentials: Gibt ein Array von Anmeldeinformationen zurück.

---

removeAllCredentials

Entfernt alle Public Key Credential Sources, die auf einem Virtual Authenticator gespeichert sind.

WebDriver Protocol-Befehl. Weitere Details finden Sie in der offiziellen Protokolldokumentation.

Verwendung

browser.removeAllCredentials(authenticatorId)

Parameter

Name	Typ	Details
authenticatorId	String	ID des Authentifikators

---

removeCredential

Entfernt eine Public Key Credential Source, die auf einem Virtual Authenticator gespeichert ist.

WebDriver Protocol-Befehl. Weitere Details finden Sie in der offiziellen Protokolldokumentation.

Verwendung

browser.removeCredential(authenticatorId, credentialId)

Parameter

Name	Typ	Details
authenticatorId	String	ID des Authentifikators
credentialId	String	ID der Anmeldeinformation

---

setUserVerified

Der Set User Verified Erweiterungsbefehl setzt die isUserVerified-Eigenschaft auf dem Virtual Authenticator.

WebDriver Protocol-Befehl. Weitere Details finden Sie in der offiziellen Protokolldokumentation.

Verwendung

browser.setUserVerified(authenticatorId)

Parameter

Name	Typ	Details
authenticatorId	String	ID des Authentifikators