executeAsync

avertissement

La commande executeAsync est dépréciée et sera supprimée dans une version future. Veuillez utiliser la commande execute à la place, car elle offre un meilleur support pour la gestion des erreurs via async/await.

Injecte un fragment de JavaScript dans la page pour exécution dans le contexte de la frame actuellement sélectionnée. Le script exécuté est supposé être asynchrone et doit signaler qu'il est terminé en invoquant le callback fourni, qui est toujours fourni comme argument final à la fonction. La valeur de ce callback sera retournée au client.

Les commandes de script asynchrones ne peuvent pas s'étendre sur les chargements de page. Si un événement de déchargement est déclenché pendant l'attente d'un résultat de script, une erreur doit être retournée au client.

L'argument script définit le script à exécuter sous forme de corps de fonction. La fonction sera invoquée avec le tableau d'arguments fourni et les valeurs peuvent être accédées via l'objet arguments dans l'ordre spécifié. Le dernier argument sera toujours une fonction de callback qui doit être invoquée pour signaler que le script est terminé.

Les arguments peuvent être n'importe quelle primitive JSON, tableau ou objet JSON. Les objets JSON qui définissent une référence WebElement seront convertis en l'élément DOM correspondant. De même, tous les WebElements dans le résultat du script seront retournés au client sous forme d'objets JSON WebElement.

attention

Veuillez utiliser execute à la place

Utilisation

browser.executeAsync(script, arguments)

Paramètres

Nom	Type	Détails
script	String, Function	Le script à exécuter.
arguments optionnel	*	arguments du script

Exemple

executeAsync.js

it('should execute async JavaScript on the page', async () => {
    await browser.setTimeout({ script: 5000 })
    const result = await browser.executeAsync(function(a, b, c, d, done) {
        // browser context - you may not access client or console
        setTimeout(() => {
            done(a + b + c + d)
        }, 3000);
    }, 1, 2, 3, 4)
    // node.js context - client and console are available
    console.log(result) // outputs: 10
});

Retourne

• <*> return: Le résultat du script.