Aller au contenu principal

Chromium

isAlertOpen​

Indique si une boîte de dialogue simple est actuellement ouverte.

Commande Chromium non officielle et non documentée. Plus d'informations sur cette commande peuvent être trouvées ici.

Utilisation​
browser.isAlertOpen()
Exemple​
console.log(browser.isAlertOpen()); // affiche: false
browser.execute('window.alert()');
console.log(browser.isAlertOpen()); // affiche: true
Retourne​
  • <Boolean> isAlertOpen: true ou false selon qu'une boîte de dialogue simple est présente ou non.

isAutoReporting​

Indique s'il génère automatiquement des erreurs sur les journaux du navigateur.

Commande Chromium non officielle et non documentée. Plus d'informations sur cette commande peuvent être trouvées ici.

Utilisation​
browser.isAutoReporting()
Retourne​
  • <Boolean> isAutoReporting: true ou false selon que le rapport automatique est activé.

setAutoReporting​

Active ou désactive le retour de réponse avec une erreur inconnue contenant la première erreur du navigateur (par exemple, échec de chargement d'une ressource en raison d'une réponse 403/404) pour toutes les commandes suivantes (une fois activé).

Commande Chromium non officielle et non documentée. Plus d'informations sur cette commande peuvent être trouvées ici.

Utilisation​
browser.setAutoReporting(enabled)
Paramètres​
NomTypeDétails
enabledbooleantrue si le rapport automatique doit être activé, utilisez false pour désactiver un rapport automatique précédemment activé.
Exemples​
// Activer le rapport automatique dès le début après l'initialisation de la session avec des journaux de navigateur vides
console.log(browser.setAutoReporting(true)); // affiche: null
// En demandant une ressource non existante, l'exécution sera interrompue en raison d'une erreur inconnue
browser.url('https://webdriver.io/img/404-does-not-exist.png');
// Pendant la session, effectuez certaines opérations qui remplissent les journaux du navigateur
browser.url('https://webdriver.io/img/404-does-not-exist.png');
browser.url('https://webdriver.io/403/no-access');
// Activer le rapport automatique qui génère une erreur inconnue pour le premier journal du navigateur (réponse 404)
browser.setAutoReporting(true);
Retourne​
  • <Object|Null> firstBrowserError: Dans le cas où la première erreur du navigateur s'est déjà produite avant l'exécution de cette commande, elle lancera une erreur inconnue en réponse, qui est un objet avec une clé 'message' décrivant la première erreur du navigateur. Sinon, elle renvoie null en cas de succès.

isLoading​

Détermine l'état de chargement de la fenêtre active.

Commande Chromium non officielle et non documentée. Plus d'informations sur cette commande peuvent être trouvées ici.

Utilisation​
browser.isLoading()
Exemple​
console.log(browser.isLoading()); // affiche: false
browser.newWindow('https://webdriver.io');
console.log(browser.isLoading()); // affiche: true
Retourne​
  • <Boolean> isLoading: true ou false selon que la fenêtre active est en cours de chargement ou non.

takeHeapSnapshot​

Prend un instantané de la mémoire du contexte d'exécution actuel.

Commande Chromium non officielle et non documentée. Plus d'informations sur cette commande peuvent être trouvées ici.

Utilisation​
browser.takeHeapSnapshot()
Retourne​
  • <Object> heapSnapshot: Une représentation JSON de l'instantané de la mémoire. Qui peut être inspecté en le chargeant comme fichier dans Chrome DevTools.

getNetworkConnection​

Obtient le type de connexion pour l'émulation réseau. Cette commande n'est applicable que lorsque l'extrémité distante répond avec la capacité networkConnectionEnabled définie sur true.

Commande Chromium non officielle et non documentée. Plus d'informations sur cette commande peuvent être trouvées ici.

Utilisation​
browser.getNetworkConnection()
Exemple​
const browser = remote({
    capabilities: {
        browserName: 'chrome',
        'goog:chromeOptions': {
            // L'émulation réseau nécessite le mode appareil, qui n'est activé que lorsque l'émulation mobile est activée
            mobileEmulation: { deviceName: 'iPad' },
        },
    }
});
console.log(browser.getNetworkConnection()); // affiche: 6 (Wi-Fi et données)
Retourne​
  • <Number> connectionType: Un masque binaire pour représenter le type de connexion réseau. Mode Avion (1), Wi-Fi uniquement (2), Wi-Fi et données (6), 4G (8), 3G (10), 2G (20). Par défaut, Wi-Fi et données sont activés.

setNetworkConnection​

Change le type de connexion pour la connexion réseau. Cette commande n'est applicable que lorsque l'extrémité distante répond avec la capacité networkConnectionEnabled définie sur true.

Commande Chromium non officielle et non documentée. Plus d'informations sur cette commande peuvent être trouvées ici.

Utilisation​
browser.setNetworkConnection(parameters)
Paramètres​
NomTypeDétails
parametersobjectObjet contenant ConnectionType, définissez le masque binaire comme valeur pour la clé type dans l'objet. Mode Avion (1), Wi-Fi uniquement (2), Wi-Fi et données (6), 4G (8), 3G (10), 2G (20).
Exemple​
const browser = remote({
    capabilities: {
        browserName: 'chrome',
        'goog:chromeOptions': {
            // L'émulation réseau nécessite le mode appareil, qui n'est activé que lorsque l'émulation mobile est activée
            mobileEmulation: { deviceName: 'iPad' },
        },
    }
});
console.log(browser.setNetworkConnection({ type: 1 })); // affiche: 1 (Mode Avion)
Retourne​
  • <Number> connectionType: Un masque binaire pour représenter le type de connexion réseau. La valeur doit correspondre au type spécifié dans l'objet, cependant, l'appareil peut ne pas être capable du type de connexion réseau demandé.

getNetworkConditions​

Obtient les conditions réseau actuelles utilisées pour l'émulation.

Commande Chromium non officielle et non documentée. Plus d'informations sur cette commande peuvent être trouvées ici.

Utilisation​
browser.getNetworkConditions()
Retourne​
  • <Object> networkConditions: Objet contenant les conditions réseau pour offline, latency, download_throughput et upload_throughput. Les conditions réseau doivent être définies avant de pouvoir les récupérer.

setNetworkConditions​

Définit les conditions réseau utilisées pour l'émulation en limitant la connexion.

Commande Chromium non officielle et non documentée. Plus d'informations sur cette commande peuvent être trouvées ici.

Utilisation​
browser.setNetworkConditions(network_conditions, network_name)
Paramètres​
NomTypeDétails
network_conditionsobjectObjet contenant les conditions réseau qui sont latency, throughput (ou download_throughput/upload_throughput) et offline (facultatif).
network_name
optional		stringNom du préréglage de limitation réseau. GPRS, Regular 2G, Good 2G, Regular 3G, Good 3G, Regular 4G, DSL, WiFi ou No throttling pour désactiver. Lorsque le préréglage est spécifié, les valeurs passées dans le premier argument ne sont pas respectées.
Exemples​
// Utiliser différentes valeurs de débit en téléchargement (25kb/s) et en téléversement (50kb/s) pour la limitation avec une latence de 1000ms
browser.setNetworkConditions({ latency: 1000, download_throughput: 25600, upload_throughput: 51200 });
// Forcer la déconnexion du réseau en définissant 'offline' sur true
browser.setNetworkConditions({ latency: 0, throughput: 0, offline: true });
// Lorsque le nom du préréglage (par exemple 'DSL') est spécifié, il ne respecte pas les valeurs dans l'objet (par exemple 'offline')
browser.setNetworkConditions({ latency: 0, throughput: 0, offline: true }, 'DSL');
// La meilleure pratique pour spécifier un préréglage de limitation réseau est d'utiliser un objet vide
browser.setNetworkConditions({}, 'Good 3G');

deleteNetworkConditions​

Désactive toute limitation réseau qui pourrait avoir été définie. Équivalent à définir le préréglage No throttling.

Commande Chromium non officielle et non documentée. Plus d'informations sur cette commande peuvent être trouvées ici.

Utilisation​
browser.deleteNetworkConditions()

sendCommand​

Envoie une commande au débogueur DevTools.
Pour une liste des commandes disponibles et leurs paramètres, consultez le Chrome DevTools Protocol Viewer.

Commande Chromium non officielle et non documentée. Plus d'informations sur cette commande peuvent être trouvées ici.

Utilisation​
browser.sendCommand(cmd, params)
Paramètres​
NomTypeDétails
cmdstringNom de la commande (par exemple Browser.close).
paramsobjectParamètres de la commande. En cas d'absence de paramètres pour la commande, spécifiez un objet vide.

sendCommandAndGetResult​

Envoie une commande au débogueur DevTools et attend le résultat.
Pour une liste des commandes disponibles et leurs paramètres, consultez le Chrome DevTools Protocol Viewer.

Commande Chromium non officielle et non documentée. Plus d'informations sur cette commande peuvent être trouvées ici.

Utilisation​
browser.sendCommandAndGetResult(cmd, params)
Paramètres​
NomTypeDétails
cmdstringNom de la commande qui renvoie un résultat (par exemple Network.getAllCookies).
paramsobjectParamètres de la commande. En cas d'absence de paramètres pour la commande, spécifiez un objet vide.
Retourne​
  • <*> result: Soit la valeur de retour de votre commande, soit l'erreur qui était la raison de l'échec de votre commande.

file​

Téléverse un fichier sur la machine distante sur laquelle le navigateur s'exécute.

Commande Chromium non officielle et non documentée. Plus d'informations sur cette commande peuvent être trouvées ici.

Utilisation​
browser.file(file)
Paramètres​
NomTypeDétails
filestringArchive zip encodée en base64 contenant un seul fichier à téléverser. Si les données encodées en base64 ne représentent pas une archive zip ou si l'archive contient plus d'un fichier, elle génèrera une erreur inconnue.
Retourne​
  • <String> path: Chemin absolu du fichier téléversé sur la machine distante.

launchChromeApp​

Lance une application Chrome par identifiant spécifié.

Commande Chromium non officielle et non documentée. Plus d'informations sur cette commande peuvent être trouvées ici.

Utilisation​
browser.launchChromeApp(id)
Paramètres​
NomTypeDétails
idstringIdentifiant d'extension de l'application à lancer, tel que défini dans chrome://extensions.
Exemple​
import fs from 'fs'
const browser = remote({
    capabilities: {
        browserName: 'chrome',
        'goog:chromeOptions': {
            // Installer au démarrage du navigateur afin de le lancer
            extensions: [
              // L'entrée doit être une application Chrome empaquetée (.crx) encodée en base64
              fs.readFileSync('/absolute/path/app.crx').toString('base64')
            ]
        }
    }
});
browser.launchChromeApp('aohghmighlieiainnegkcijnfilokake')); // Google Docs (https://chrome.google.com/webstore/detail/docs/aohghmighlieiainnegkcijnfilokake)

getElementValue​

Récupère la valeur d'un élément de contrôle de formulaire donné.

Commande Chromium non officielle et non documentée. Plus d'informations sur cette commande peuvent être trouvées ici.

Utilisation​
browser.getElementValue(elementId)
Paramètres​
NomTypeDétails
elementIdStringidentifiant de l'élément dont on veut obtenir la valeur
Retourne​
  • <String|Null> value: Valeur actuelle de l'élément. Si l'élément spécifié n'est pas un élément de contrôle de formulaire, elle renverra null.

elementHover​

Active l'état de survol pour un élément, qui est réinitialisé lors de la prochaine interaction.

Commande Chromium non officielle et non documentée. Plus d'informations sur cette commande peuvent être trouvées ici.

Utilisation​
browser.elementHover(elementId)
Paramètres​
NomTypeDétails
elementIdStringidentifiant de l'élément à survoler

touchPinch​

Déclenche un effet de zoom par pincement.

Commande Chromium non officielle et non documentée. Plus d'informations sur cette commande peuvent être trouvées ici.

Utilisation​
browser.touchPinch(x, y, scale)
Paramètres​
NomTypeDétails
xnumberposition x pour le pincement
ynumberposition y pour le pincement
scalenumberéchelle de zoom par pincement

freeze​

Gèle la page actuelle. Extension pour Page Lifecycle API.

Commande Chromium non officielle et non documentée. Plus d'informations sur cette commande peuvent être trouvées ici.

Utilisation​
browser.freeze()

resume​

Reprend la page actuelle. Extension pour Page Lifecycle API.

Commande Chromium non officielle et non documentée. Plus d'informations sur cette commande peuvent être trouvées ici.

Utilisation​
browser.resume()

getCastSinks​

Renvoie la liste des récepteurs de diffusion (appareils Cast) disponibles pour le routeur multimédia Chrome.

Commande Chromium non officielle et non documentée. Plus d'informations sur cette commande peuvent être trouvées ici.

Utilisation​
browser.getCastSinks()
Retourne​
  • <string[]> sinks: Liste des récepteurs disponibles.

selectCastSink​

Sélectionne un récepteur de diffusion (appareil Cast) comme destinataire des intentions du routeur multimédia (connexion ou lecture).

Commande Chromium non officielle et non documentée. Plus d'informations sur cette commande peuvent être trouvées ici.

Utilisation​
browser.selectCastSink(sinkName)
Paramètres​
NomTypeDétails
sinkNamestringLe nom de l'appareil cible.

startCastTabMirroring​

Initie la mise en miroir de l'onglet pour l'onglet actuel du navigateur sur l'appareil spécifié.

Commande Chromium non officielle et non documentée. Plus d'informations sur cette commande peuvent être trouvées ici.

Utilisation​
browser.startCastTabMirroring(sinkName)
Paramètres​
NomTypeDétails
sinkNamestringLe nom de l'appareil cible.

getCastIssueMessage​

Renvoie un message d'erreur s'il y a un problème dans une session Cast.

Commande Chromium non officielle et non documentée. Plus d'informations sur cette commande peuvent être trouvées ici.

Utilisation​
browser.getCastIssueMessage()
Retourne​
  • <String> message: Message d'erreur, le cas échéant.

stopCasting​

Arrête la diffusion du routeur multimédia vers l'appareil spécifié, si connecté.

Commande Chromium non officielle et non documentée. Plus d'informations sur cette commande peuvent être trouvées ici.

Utilisation​
browser.stopCasting(sinkName)
Paramètres​
NomTypeDétails
sinkNamestringLe nom de l'appareil cible.

shutdown​

Arrête le processus ChromeDriver et par conséquent termine toutes les sessions actives.

Commande Chromium non officielle et non documentée. Plus d'informations sur cette commande peuvent être trouvées ici.

Utilisation​
browser.shutdown()

takeElementScreenshot​

La commande Take Element Screenshot prend une capture d'écran de la région visible englobée par le rectangle délimitant d'un élément.

Commande Chromium non officielle et non documentée. Plus d'informations sur cette commande peuvent être trouvées ici.

Utilisation​
browser.takeElementScreenshot(elementId, scroll)
Paramètres​
NomTypeDétails
elementIdStringl'identifiant d'un élément retourné lors d'un appel précédent à Find Element(s)
scroll
optional		booleanfaire défiler l'élément pour le rendre visible. Par défaut : true
Retourne​
  • <String> screenshot: Les données d'image PNG encodées en base64 constituant la capture d'écran de la région visible du rectangle délimitant d'un élément après qu'il ait été défilé pour être visible.

getLogTypes​

Obtient les types de journaux disponibles.

Commande Chromium non officielle et non documentée. Plus d'informations sur cette commande peuvent être trouvées ici.

Utilisation​
browser.getLogTypes()
Retourne​
  • <String[]> logTypes: La liste des types de journaux disponibles, exemple : browser, driver.

getLogs​

Obtient le journal pour un type de journal donné. Le tampon du journal est réinitialisé après chaque demande.

Commande Chromium non officielle et non documentée. Plus d'informations sur cette commande peuvent être trouvées ici.

Utilisation​
browser.getLogs(type)
Paramètres​
NomTypeDétails
typestringle type de journal
Retourne​
  • <Object[]> logs: La liste des entrées de journal.

Welcome! How can I help?

WebdriverIO AI Copilot