Komma igång
Välkommen till WebdriverIO-dokumentationen. Den hjälper dig att komma igång snabbt. Om du stöter på problem kan du hitta hjälp och svar på vår Discord Support Server eller kontakta mig på Twitter.
Detta är dokumentationen för den senaste versionen (>=9.x) av WebdriverIO. Om du fortfarande använder en äldre version, besök gamla dokumentationswebbplatser!
Du kan hitta fler videor om WebdriverIO på den officiella YouTube-kanalen. Se till att du prenumererar!
Starta en WebdriverIO-konfiguration
För att lägga till en fullständig WebdriverIO-konfiguration till ett befintligt eller nytt projekt med hjälp av WebdriverIO Starter Toolkit, kör:
Om du befinner dig i rotkatalogen för ett befintligt projekt, kör:
- NPM
- Yarn
- pnpm
- bun
npm init wdio@latest .
eller om du vill skapa ett nytt projekt:
npm init wdio@latest ./path/to/new/project
yarn create wdio .
eller om du vill skapa ett nytt projekt:
yarn create wdio ./path/to/new/project
pnpm create wdio@latest .
eller om du vill skapa ett nytt projekt:
pnpm create wdio@latest ./path/to/new/project
bun create wdio@latest .
eller om du vill skapa ett nytt projekt:
bun create wdio@latest ./path/to/new/project
Detta enda kommando laddar ner WebdriverIO CLI-verktyget och kör en konfigurationsguide som hjälper dig att konfigurera din testsuite.
Guiden kommer att ställa en uppsättning frågor som vägleder dig genom konfigurationen. Du kan skicka en --yes
-parameter för att välja en standardkonfiguration som kommer att använda Mocha med Chrome och Page Object-mönstret.
- NPM
- Yarn
- pnpm
- bun
npm init wdio@latest . -- --yes
yarn create wdio . --yes
pnpm create wdio@latest . --yes
bun create wdio@latest . --yes
Installera CLI manuellt
Du kan också lägga till CLI-paketet till ditt projekt manuellt via:
npm i --save-dev @wdio/cli
npx wdio --version # skriver ut t.ex. `8.13.10`
# kör konfigurationsguiden
npx wdio config
Kör test
Du kan starta din testsuite genom att använda kommandot run
och peka på WebdriverIO-konfigurationen som du just skapat:
npx wdio run ./wdio.conf.js
Om du vill köra specifika testfiler kan du lägga till en --spec
-parameter:
npx wdio run ./wdio.conf.js --spec example.e2e.js
eller definiera testsviter i din konfigurationsfil och bara köra de testfiler som definierats i en svit:
npx wdio run ./wdio.conf.js --suite exampleSuiteName
Kör i ett skript
Om du vill använda WebdriverIO som en automatiseringsmotor i Fristående läge inom ett Node.JS-skript kan du också direkt installera WebdriverIO och använda det som ett paket, t.ex. för att generera en skärmdump av en webbplats:
loading...
Obs: alla WebdriverIO-kommandon är asynkrona och måste hanteras korrekt med async/await
.
Spela in tester
WebdriverIO tillhandahåller verktyg för att hjälpa dig komma igång genom att spela in dina teståtgärder på skärmen och automatiskt generera WebdriverIO-testskript. Se Spela in tester med Chrome DevTools Recorder för mer information.
Systemkrav
Du behöver ha Node.js installerat.
- Installera minst v18.20.0 eller högre eftersom detta är den äldsta aktiva LTS-versionen
- Endast versioner som är eller kommer att bli en LTS-version stöds officiellt
Om Node för närvarande inte är installerat på ditt system föreslår vi att du använder ett verktyg som NVM eller Volta för att hjälpa till att hantera flera aktiva Node.js-versioner. NVM är ett populärt val, medan Volta också är ett bra alternativ.