Pierwsze kroki
Witamy w dokumentacji WebdriverIO. Pomoże Ci szybko rozpocząć pracę. Jeśli napotkasz problemy, możesz znaleźć pomoc i odpowiedzi na naszym Serwerze Wsparcia Discord lub możesz napisać do mnie na Twitterze.
To jest dokumentacja dla najnowszej wersji (>=9.x) WebdriverIO. Jeśli nadal używasz starszej wersji, odwiedź stare strony dokumentacji!
Więcej filmów na temat WebdriverIO znajdziesz na oficjalnym kanale YouTube. Nie zapomnij zasubskrybować!
Rozpocznij konfigurację WebdriverIO
Aby dodać pełną konfigurację WebdriverIO do istniejącego lub nowego projektu za pomocą WebdriverIO Starter Toolkit, uruchom:
Jeśli jesteś w katalogu głównym istniejącego projektu, uruchom:
- NPM
- Yarn
- pnpm
- bun
npm init wdio@latest .
lub jeśli chcesz utworzyć nowy projekt:
npm init wdio@latest ./path/to/new/project
yarn create wdio .
lub jeśli chcesz utworzyć nowy projekt:
yarn create wdio ./path/to/new/project
pnpm create wdio@latest .
lub jeśli chcesz utworzyć nowy projekt:
pnpm create wdio@latest ./path/to/new/project
bun create wdio@latest .
lub jeśli chcesz utworzyć nowy projekt:
bun create wdio@latest ./path/to/new/project
To pojedyncze polecenie pobiera narzędzie WebdriverIO CLI i uruchamia kreatora konfiguracji, który pomaga skonfigurować pakiet testowy.
Kreator zada zestaw pytań, które prowadzą przez proces konfiguracji. Możesz przekazać parametr --yes, aby wybrać domyślną konfigurację, która będzie używać Mocha z Chrome, wykorzystując wzorzec 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
Ręczna instalacja CLI
Możesz również dodać pakiet CLI do swojego projektu ręcznie za pomocą:
npm i --save-dev @wdio/cli
npx wdio --version # wyświetla np. `8.13.10`
# uruchom kreatora konfiguracji
npx wdio config
Uruchom testy
Możesz uruchomić swój pakiet testów za pomocą polecenia run i wskazując na konfigurację WebdriverIO, którą właśnie utworzyłeś:
npx wdio run ./wdio.conf.js
Jeśli chcesz uruchomić konkretne pliki testowe, możesz dodać parametr --spec:
npx wdio run ./wdio.conf.js --spec example.e2e.js
lub zdefiniować zestawy w pliku konfiguracyjnym i uruchomić tylko pliki testowe zdefiniowane w zestawie:
npx wdio run ./wdio.conf.js --suite exampleSuiteName
Uruchom w skrypcie
Jeśli chcesz używać WebdriverIO jako silnika automatyzacji w trybie autonomicznym w skrypcie Node.JS, możesz również bezpośrednio zainstalować WebdriverIO i używać go jako pakietu, np. aby wygenerować zrzut ekranu strony internetowej:
loading...
Uwaga: wszystkie polecenia WebdriverIO są asynchroniczne i muszą być odpowiednio obsługiwane za pomocą async/await.
Nagrywanie testów
WebdriverIO udostępnia narzędzia, które pomogą Ci rozpocząć pracę, rejestrując twoje działania testowe na ekranie i automatycznie generując skrypty testowe WebdriverIO. Zobacz Nagrywanie testów za pomocą Chrome DevTools Recorder, aby uzyskać więcej informacji.
Wymagania systemowe
Będziesz potrzebować zainstalowanego Node.js.
- Zainstaluj co najmniej wersję v18.20.0 lub wyższą, ponieważ jest to najstarsza aktywna wersja LTS
- Oficjalnie obsługiwane są tylko wydania, które są lub staną się wydaniem LTS
Jeśli Node nie jest obecnie zainstalowany w Twoim systemie, sugerujemy korzystanie z narzędzia takiego jak NVM lub Volta, aby pomóc w zarządzaniu wieloma aktywnymi wersjami Node.js. NVM jest popularnym wyborem, podczas gdy Volta jest również dobrą alternatywą.
