Erste Schritte
Willkommen auf der WebdriverIO Dokumentation-Seite. Diese wird Ihnen Helfen Ihre WebdriverIO Journey zu starten. Wenn Sie auf Probleme stoßen, finden Sie Hilfe und Antworten auf unserem Discord Support Server oder Sie können das Projekt auf Twitterkontaktieren.
Dies sind die Dokumentation für die aktuelle Version (v8.x) von WebdriverIO. Wenn Sie noch eine ältere Version verwenden, besuchen Sie bitte die alten Dokumentations-Webseiten!
Weitere Videos rund um WebdriverIO finden Sie auf dem offiziellen YouTube-Kanal. Vergewissern Sie sich, dass Sie abonnieren!
WebdriverIO Einrichten
Um ein vollständiges WebdriverIO Setup zu einem existierenden oder neuen Projekt hinzuzufügen, verwenden Sie das WebdriverIO Starter Toolkit:
Wenn Sie sich im Root-Verzeichnis eines vorhandenen Projekts befinden, führen Sie Folgendes aus:
- NPM
- Yarn
- pnpm
npm init wdio .
```sh
npm init wdio .
or if you want to create a new project:
npm init wdio ./path/to/new/project
yarn create wdio .
```sh
yarn create wdio .
or if you want to create a new project:
yarn create wdio ./path/to/new/project
pnpm create wdio .
```sh
pnpm create wdio .
or if you want to create a new project:
pnpm create wdio ./path/to/new/project
Dieser lädt das WebdriverIO-CLI-Tool herunter und führt einen Konfigurationsassistenten aus, der Sie bei der Konfiguration Ihrer Testsuite unterstützt.
Der Assistent wird eine Reihe von Fragen stellen, die Sie durch das Setup führt. Sie können einen --yes
Parameter übergeben, um eine Standardeinstellung auszuwählen, die Mocha mit Chrome unter Verwendung des Page Object -Musters verwendet.
- NPM
- Yarn
- pnpm
npm init wdio . -- --yes
yarn create wdio . --yes
pnpm create wdio . --yes
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
Tests Ausführen
Sie können Ihre Testsuite starten, indem Sie den Befehl run
verwenden und auf die gerade erstellte WebdriverIO-Konfiguration verweisen:
npx wdio run ./wdio.conf.js
Wenn Sie bestimmte Testdateien ausführen möchten, können Sie einen Parameter --spec
hinzufügen:
npx wdio run ./wdio.conf.js --spec example.e2e.js
oder definieren Sie Suiten in Ihrer Konfigurationsdatei und führen Sie nur die Testdateien aus, die in einer Suite definiert sind:
npx wdio run ./wdio.conf.js --suite exampleSuiteName
In einem Skript Ausführen
Wenn Sie WebdriverIO als Automatisierungs-Engine im Standalone-Modus innerhalb eines Node.JS-Skripts verwenden möchten, können Sie WebdriverIO auch direkt installieren und als Paket verwenden, um beispielsweise einen einer Website zu erstellen:
loading...
Hinweis: Alle WebdriverIO-Befehle sind asynchron und müssen ordnungsgemäß mit async/await
ausgeführt werden.
Tests Aufzeichnen
WebdriverIO bietet Tools an, die Ihnen den Einstieg erleichtern, indem Sie Ihre Testaktionen auf dem Bildschirm aufzeichnen und automatisch in WebdriverIO-Testskripte umwandeln. Weitere Informationen finden Sie unter Recorder-Tests mit Chrome DevTools Recorder.
Systemanforderungen
Sie müssen Node.js installiert haben.
- Installieren Sie mindestens v16.x oder höher, da dies die älteste aktive LTS-Version ist
- Nur Releases, die als LTS-Releases markiert sind, werden offiziell unterstützt
Wenn Sie Node.js noch nicht auf Ihrem System installiert haben, empfehlen wir die Verwendung eines Tools wie NVM oder Volta , um die Verwaltung mehrerer aktiver Node.js-Versionen zu unterstützen. NVM ist eine beliebte Wahl, während Volta auch eine gute Alternative ist.