emuler

WebdriverIO vous permet d'émuler les API Web en utilisant la commande emulate. Ces API Web peuvent alors se comporter exactement comme vous le spécifiez. Les domaines suivants sont pris en charge :

• geolocation: Émuler l'API de géolocalisation
• userAgent: Émuler l'agent utilisateur
• colorScheme: Émuler le thème de couleur
• onLine: Émuler le statut de connexion
• device: Émuler un appareil mobile ou de bureau spécifique
• clock: Émuler l'horloge système

La commande emulate renvoie une fonction qui peut être appelée pour réinitialiser l'émulation. Ceci est utile lorsque vous souhaitez réinitialiser l'émulation après un test ou une série de tests.

Pour en savoir plus, consultez les directives Émulation.

info

À l'exception du domaine clock, il n'est pas possible de modifier la valeur émulée sans recharger la page.

info

Cette fonctionnalité nécessite la prise en charge de WebDriver Bidi pour le navigateur. Bien que les versions récentes de Chrome, Edge et Firefox disposent de cette prise en charge, Safari ne l'a pas. Pour les mises à jour, suivez wpt.fyi. De plus, si vous utilisez un fournisseur cloud pour lancer des navigateurs, assurez-vous que votre fournisseur prend également en charge WebDriver Bidi.

L'objet EmulationOptions peut avoir les propriétés suivantes en fonction du domaine :

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

Utilisation

browser.emulate(scope, options)

Paramètres

Nom	Type	Détails
scope	string	fonctionnalité du navigateur que vous souhaitez émuler, peut être soit clock, geolocation, userAgent, colorScheme ou onLine
options	EmulationOptions	option d'émulation pour un domaine spécifique

Exemples

example.js

loading...

View on GitHub

example.js

loading...

View on GitHub

Retourne

• <Function> returns: une fonction pour réinitialiser l'émulation