Pierwsze kroki
Witaj 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 do nas napisać na 𝕏.
To jest dokumentacja dla najnowszej wersji (>=9.x) WebdriverIO. Jeśli nadal korzystasz ze starszej wersji, odwiedź stare strony dokumentacji!
Więcej filmów dotyczących WebdriverIO znajdziesz na oficjalnym kanale YouTube. Pamiętaj, aby się zasubskrybować!
Inicjacja konfiguracji WebdriverIO
Aby dodać pełną konfigurację WebdriverIO do istniejącego lub nowego projektu za pomocą WebdriverIO Starter Toolkit, wykonaj:
Jeśli jesteś w katalogu głównym istniejącego projektu, wykonaj:
- 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
Ta pojedyncza komenda pobiera narzędzie WebdriverIO CLI i uruchamia kreator konfiguracji, który pomaga skonfigurować zestaw testów.
Kreator zada serię pytań, które przeprowadzą cię przez proces konfiguracji. Możesz przekazać parametr --yes, aby wybrać domyślną konfigurację, która będzie używać Mocha z Chrome, stosują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 kreator konfiguracji
npx wdio config
Uruchomienie testów
Możesz uruchomić swój zestaw testów za pomocą polecenia run i wskazując plik konfiguracyjny WebdriverIO, który właśnie utworzyłeś:
npx wdio run ./wdio.conf.js
Jeśli chcesz uruchomić określone pliki testowe, możesz dodać parametr --spec:
npx wdio run ./wdio.conf.js --spec example.e2e.js
lub zdefiniować zestawy (suites) w pliku konfiguracyjnym i uruchomić tylko pliki testowe zdefiniowane w zestawie:
npx wdio run ./wdio.conf.js --suite exampleSuiteName
Uruchamianie w skrypcie
Jeśli chcesz używać WebdriverIO jako silnika automatyzacji w trybie samodzielnym w skrypcie Node.JS, możesz bezpośrednio zainstalować WebdriverIO i używać go jako pakietu, np. do wygenerowania zrzutu ekranu strony internetowej:
loading...
Uwaga: wszystkie polecenia WebdriverIO są asynchroniczne i muszą być odpowiednio obsługiwane za pomocą async/await.
Nagrywanie testów
WebdriverIO dostarcza narzędzia, które pomogą ci rozpocząć pracę poprzez nagrywanie twoich działań testowych na ekranie i automatyczne generowanie skryptów testowych WebdriverIO. Zobacz Nagrywanie testów z Chrome DevTools Recorder aby uzyskać więcej informacji.
Wymagania systemowe
Potrzebujesz 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 wersje, które są lub staną się wydaniami 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ą.
