Iniziare
Benvenuto alla documentazione di WebdriverIO. Ti aiuterà a iniziare rapidamente. Se incontri problemi, puoi trovare aiuto e risposte sul nostro Server di Supporto Discord o puoi contattarmi su Twitter.
Questa è la documentazione per la versione più recente (>=9.x) di WebdriverIO. Se stai ancora utilizzando una versione precedente, visita i vecchi siti di documentazione!
Puoi trovare più video su WebdriverIO sul canale YouTube ufficiale. Assicurati di iscriverti!
Iniziare una configurazione WebdriverIO
Per aggiungere una configurazione completa di WebdriverIO a un progetto esistente o nuovo utilizzando WebdriverIO Starter Toolkit, esegui:
Se sei nella directory principale di un progetto esistente, esegui:
- NPM
- Yarn
- pnpm
- bun
npm init wdio@latest .
o se vuoi creare un nuovo progetto:
npm init wdio@latest ./path/to/new/project
yarn create wdio .
o se vuoi creare un nuovo progetto:
yarn create wdio ./path/to/new/project
pnpm create wdio@latest .
o se vuoi creare un nuovo progetto:
pnpm create wdio@latest ./path/to/new/project
bun create wdio@latest .
o se vuoi creare un nuovo progetto:
bun create wdio@latest ./path/to/new/project
Questo singolo comando scarica lo strumento CLI di WebdriverIO ed esegue una procedura guidata di configurazione che ti aiuta a configurare la tua suite di test.
La procedura guidata ti porrà una serie di domande che ti guideranno attraverso la configurazione. Puoi passare un parametro --yes
per scegliere una configurazione predefinita che utilizzerà Mocha con Chrome utilizzando il pattern 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
Installare CLI Manualmente
Puoi anche aggiungere il pacchetto CLI al tuo progetto manualmente tramite:
npm i --save-dev @wdio/cli
npx wdio --version # stampa ad es. `8.13.10`
# esegui la procedura guidata di configurazione
npx wdio config
Eseguire Test
Puoi avviare la tua suite di test utilizzando il comando run
e indicando la configurazione WebdriverIO che hai appena creato:
npx wdio run ./wdio.conf.js
Se desideri eseguire file di test specifici, puoi aggiungere un parametro --spec
:
npx wdio run ./wdio.conf.js --spec example.e2e.js
o definire suite nel tuo file di configurazione ed eseguire solo i file di test definiti in una suite:
npx wdio run ./wdio.conf.js --suite exampleSuiteName
Eseguire in uno script
Se desideri utilizzare WebdriverIO come motore di automazione in Modalità Standalone all'interno di uno script Node.JS, puoi anche installare direttamente WebdriverIO e utilizzarlo come pacchetto, ad esempio per generare uno screenshot di un sito web:
loading...
Nota: tutti i comandi WebdriverIO sono asincroni e devono essere gestiti correttamente utilizzando async/await
.
Registrare test
WebdriverIO fornisce strumenti per aiutarti a iniziare registrando le tue azioni di test sullo schermo e generando automaticamente script di test WebdriverIO. Vedi Registra test con Chrome DevTools Recorder per maggiori informazioni.
Requisiti di Sistema
Avrai bisogno di Node.js installato.
- Installa almeno v18.20.0 o superiore, poiché questa è la versione LTS attiva più vecchia
- Sono ufficialmente supportate solo le versioni che sono o diventeranno una versione LTS
Se Node non è attualmente installato sul tuo sistema, ti suggeriamo di utilizzare uno strumento come NVM o Volta per gestire più versioni attive di Node.js. NVM è una scelta popolare, mentre Volta è anche una buona alternativa.