emulate

WebdriverIO ermöglicht es Ihnen, Web-APIs mit dem Befehl emulate zu emulieren. Diese Web-APIs können dann genau so funktionieren, wie Sie es angeben. Die folgenden Bereiche werden unterstützt:

• geolocation: Emulieren der Geolocation-API
• userAgent: Emulieren des User-Agents
• colorScheme: Emulieren des Farbschemas
• onLine: Emulieren des Online-Status
• device: Emulieren eines bestimmten mobilen oder Desktop-Geräts
• clock: Emulieren der Systemuhr

Der Befehl emulate gibt eine Funktion zurück, die aufgerufen werden kann, um die Emulation zurückzusetzen. Dies ist nützlich, wenn Sie die Emulation nach einem Test oder einer Testsuite zurücksetzen möchten.

Lesen Sie mehr dazu in den Emulation-Richtlinien.

Info

Mit Ausnahme des clock-Bereichs ist es nicht möglich, den emulierten Wert zu ändern, ohne die Seite neu zu laden.

Info

Diese Funktion erfordert WebDriver Bidi-Unterstützung für den Browser. Während neuere Versionen von Chrome, Edge und Firefox diese Unterstützung haben, unterstützt Safari sie nicht. Für Updates folgen Sie wpt.fyi. Darüber hinaus, wenn Sie einen Cloud-Anbieter zum Starten von Browsern verwenden, stellen Sie sicher, dass Ihr Anbieter auch WebDriver Bidi unterstützt.

Das EmulationOptions-Objekt kann je nach Bereich die folgenden Eigenschaften haben:

Bereich	Optionen
geolocation	{ latitude: number, longitude: number }
userAgent	string
colorScheme	'light' | 'dark'
onLine	boolean
clock	FakeTimerInstallOpts

Verwendung

browser.emulate(scope, options)

Parameter

Name	Typ	Details
scope	string	Funktion des Browsers, die Sie emulieren möchten, kann entweder clock, geolocation, userAgent, colorScheme oder onLine sein
options	EmulationOptions	Emulationsoption für den spezifischen Bereich

Beispiele

example.js

loading...

View on GitHub

example.js

loading...

View on GitHub

Rückgabe

• <Function> returns: eine Funktion zum Zurücksetzen der Emulation