Premiers pas
Bienvenue dans la documentation WebdriverIO. Elle vous aidera à démarrer rapidement. Si vous rencontrez des problèmes, vous pouvez trouver de l'aide et des réponses sur notre Serveur de Support Discord ou vous pouvez me contacter sur Twitter.
Ceci est la documentation pour la dernière version (>=9.x) de WebdriverIO. Si vous utilisez encore une ancienne version, veuillez consulter les anciens sites de documentation !
Vous pouvez trouver plus de vidéos sur WebdriverIO sur la chaîne YouTube officielle. Assurez-vous de vous abonner !
Initier une configuration WebdriverIO
Pour ajouter une configuration complète de WebdriverIO à un projet existant ou nouveau en utilisant le WebdriverIO Starter Toolkit, exécutez :
Si vous êtes dans le répertoire racine d'un projet existant, exécutez :
- NPM
- Yarn
- pnpm
- bun
npm init wdio@latest .
ou si vous voulez créer un nouveau projet :
npm init wdio@latest ./path/to/new/project
yarn create wdio .
ou si vous voulez créer un nouveau projet :
yarn create wdio ./path/to/new/project
pnpm create wdio@latest .
ou si vous voulez créer un nouveau projet :
pnpm create wdio@latest ./path/to/new/project
bun create wdio@latest .
ou si vous voulez créer un nouveau projet :
bun create wdio@latest ./path/to/new/project
Cette commande unique télécharge l'outil CLI WebdriverIO et exécute un assistant de configuration qui vous aide à configurer votre suite de tests.
L'assistant vous posera une série de questions qui vous guideront à travers la configuration. Vous pouvez passer un paramètre --yes pour choisir une configuration par défaut qui utilisera Mocha avec Chrome en utilisant le modèle Page Object.
- NPM
- Yarn
- pnpm
- bun
npm init wdio@latest . -- --yes
yarn create wdio . --yes
pnpm create wdio@latest . --yes
bun create wdio@latest . --yes
Installer le CLI manuellement
Vous pouvez également ajouter le package CLI à votre projet manuellement via :
npm i --save-dev @wdio/cli
npx wdio --version # affiche par ex. `8.13.10`
# exécuter l'assistant de configuration
npx wdio config
Exécuter 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éfinir des suites dans votre fichier de configuration et exécuter uniquement les fichiers de test définis 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 comme un package, par exemple pour générer une capture d'écran d'un site web :
loading...
Remarque : toutes les commandes WebdriverIO sont asynchrones et doivent être correctement gérées en utilisant async/await.
Enregistrer des 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 Enregistrer des tests avec Chrome DevTools Recorder pour plus d'informations.
Configuration requise
Vous aurez besoin de Node.js installé.
- Installez au moins la version v18.20.0 ou supérieure car c'est 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 actuellement installé sur votre système, nous vous suggérons d'utiliser un outil tel que NVM ou Volta pour vous aider à gérer plusieurs versions actives de Node.js. NVM est un choix populaire, tandis que Volta est également une bonne alternative.
