Passer au contenu principal

Premiers pas

Bienvenue sur la documentation de WebdriverIO. Cela vous aidera à démarrer rapidement. Si vous rencontrez des problèmes, vous pouvez trouver de l'aide et des réponses sur notre Discord Support Server ou vous pouvez me contacter sur Twitter.

information

Ce sont les documents de la dernière version (>=8.x) de WebdriverIO. Si vous utilisez toujours une version plus ancienne, veuillez visiter les anciens sites de documentation!

Official YouTube Channel 🎥

Vous pouvez trouver plus de vidéos autour de WebdriverIO sur la chaîne YouTube officielle. Assurez-vous de vous abonner!

Lancer une installation WebdriverIO

Pour ajouter une configuration WebdriverIO complète à un projet existant ou nouveau à l'aide de WebdriverIO Starter Toolkit, exécutez :

Si vous êtes dans le répertoire racine d'un projet existant, exécutez :

npm init wdio .

or if you want to create a new project:

npm init wdio ./path/to/new/project

Install CLI Manually

You can also add the CLI package to your project manually via:

npm i --save-dev @wdio/cli
npx wdio --version # prints e.g. `8.13.10`

# run configuration wizard
npx wdio config

Lancer un test

Vous pouvez démarrer votre suite de tests en utilisant la commande run et en pointant vers la configuration WebdriverIO que vous venez de créer :

npx wdio run ./wdio.conf.js

Si vous souhaitez exécuter des fichiers de test spécifiques, vous pouvez ajouter un paramètre --spec:

npx wdio run ./wdio.conf.js --spec example.e2e.js

ou définissez des suites dans votre fichier de configuration et exécutez uniquement les fichiers de test définis par dans une suite :

npx wdio run ./wdio.conf.js --suite exampleSuiteName

Exécuter dans un script

Si vous souhaitez utiliser WebdriverIO comme moteur d'automatisation en mode autonome dans un script Node.JS, vous pouvez également installer directement WebdriverIO et l'utiliser en tant que package, par exemple pour générer une capture d'écran d'un site Web :

getting-started/run-in-script.js
loading...

Remarque : toutes les commandes WebdriverIO sont asynchrones et doivent être correctement gérées à l'aide de async/wait.

Enregistrer les tests

WebdriverIO fournit des outils pour vous aider à démarrer en enregistrant vos actions de test à l'écran et en générant automatiquement des scripts de test WebdriverIO. Voir Tests de l'enregistreur avec Chrome DevTools Recorder pour plus d'informations.

Configuration système requise

Vous aurez besoin de Node.js installé.

  • Installez au moins la version v16.x ou supérieur car il s'agit de la plus ancienne version LTS active
  • Seules les versions qui sont ou deviendront une version LTS sont officiellement prises en charge

Si Node n'est pas installé sur votre système, nous suggérons d'utiliser un outil tel que NVM ou Volta pour vous aider à gérer plusieurs versions de Node.js. NVM est un choix populaire, tandis que Volta est également une bonne alternative.

Welcome! How can I help?

WebdriverIO AI Copilot