Erste Schritte

Willkommen bei der WebdriverIO-Dokumentation. Sie wird Ihnen helfen, schnell einzusteigen. Wenn Sie auf Probleme stoßen, können Sie Hilfe und Antworten auf unserem Discord Support Server finden oder uns auf 𝕏 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. Vergessen Sie nicht zu abonnieren!

WebdriverIO-Setup initiieren

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

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 ordnungsgemäß behandelt werden.

Tests aufzeichnen

WebdriverIO bietet Tools, die Ihnen helfen, den Einstieg zu erleichtern, indem Sie Ihre Testaktionen auf dem Bildschirm aufzeichnen und automatisch WebdriverIO-Testskripte generieren. Weitere Informationen finden Sie unter Tests mit Chrome DevTools Recorder aufzeichnen.

Systemanforderungen

Sie benötigen Node.js auf Ihrem System.

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

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 darstellt.