Erste Schritte

Willkommen zur WebdriverIO-Dokumentation. Sie wird Ihnen helfen, schnell loszulegen. Wenn Sie auf Probleme stoßen, können Sie Hilfe und Antworten auf unserem Discord Support Server finden oder mich auf Twitter kontaktieren.

Info

Dies ist die Dokumentation für die neueste Version (>=9.x) von WebdriverIO. Wenn Sie noch eine ältere Version verwenden, besuchen Sie bitte die alten Dokumentationswebsites!

Offizieller YouTube-Kanal 🎥

Weitere Videos rund um WebdriverIO finden Sie auf dem offiziellen YouTube-Kanal. Abonnieren Sie ihn unbedingt!

WebdriverIO-Setup initiieren

Um ein vollständiges WebdriverIO-Setup zu einem bestehenden oder neuen Projekt hinzuzufügen, verwenden Sie das WebdriverIO Starter Toolkit:

Wenn Sie sich im Stammverzeichnis eines bestehenden Projekts befinden, führen Sie aus:

NPM

npm init wdio@latest .

oder wenn Sie ein neues Projekt erstellen möchten:

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

Yarn

yarn create wdio .

oder wenn Sie ein neues Projekt erstellen möchten:

yarn create wdio ./path/to/new/project

pnpm

pnpm create wdio@latest .

oder wenn Sie ein neues Projekt erstellen möchten:

pnpm create wdio@latest ./path/to/new/project

bun

bun create wdio@latest .

oder wenn Sie ein neues Projekt erstellen möchten:

bun create wdio@latest ./path/to/new/project

Dieser einzelne Befehl lädt das WebdriverIO CLI-Tool herunter und führt einen Konfigurationsassistenten aus, der Ihnen bei der Konfiguration Ihrer Testsuite hilft.

Der Assistent stellt eine Reihe von Fragen, die Sie durch die Einrichtung führen. Sie können einen --yes-Parameter übergeben, um eine Standardeinrichtung zu wählen, die Mocha mit Chrome unter Verwendung des Page Object-Musters verwendet.

NPM

npm init wdio@latest . -- --yes

Yarn

yarn create wdio . --yes

pnpm

pnpm create wdio@latest . --yes

bun

bun create wdio@latest . --yes

CLI manuell installieren

Sie können das CLI-Paket auch manuell zu Ihrem Projekt hinzufügen:

npm i --save-dev @wdio/cli
npx wdio --version # gibt z.B. `8.13.10` aus

# Konfigurationsassistenten ausführen
npx wdio config

Test ausführen

Sie können Ihre Testsuite mit dem Befehl run starten und auf die WebdriverIO-Konfiguration verweisen, die Sie gerade erstellt haben:

npx wdio run ./wdio.conf.js

Wenn Sie bestimmte Testdateien ausführen möchten, können Sie einen --spec-Parameter hinzufügen:

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

oder definieren Sie Suites 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, z.B. um einen Screenshot einer Website zu erstellen:

getting-started/run-in-script.js

loading...

View on GitHub

Hinweis: Alle WebdriverIO-Befehle sind asynchron und müssen mit async/await korrekt behandelt werden.

Tests aufzeichnen

WebdriverIO bietet Tools, die Ihnen helfen, durch Aufzeichnen Ihrer Testaktionen auf dem Bildschirm und automatisches Generieren von WebdriverIO-Testskripten zu beginnen. Weitere Informationen finden Sie unter Tests mit Chrome DevTools Recorder aufzeichnen.

Systemanforderungen

Sie benötigen Node.js.

• Installieren Sie mindestens v18.20.0 oder höher, da dies die älteste aktive LTS-Version ist
• Nur Versionen, die eine LTS-Version sind oder werden, werden offiziell unterstützt

Wenn Node derzeit nicht auf Ihrem System installiert ist, empfehlen wir die Verwendung eines Tools wie NVM oder Volta, um bei der Verwaltung mehrerer aktiver Node.js-Versionen zu helfen. NVM ist eine beliebte Wahl, während Volta ebenfalls eine gute Alternative ist.