Vai al contenuto principale

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.

info

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!

Canale YouTube Ufficiale 🎥

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 init wdio@latest .

o se vuoi creare un nuovo progetto:

npm init 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.

Crea un Progetto WebdriverIO per automatizzare le app MacOS

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 init 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:

getting-started/run-in-script.js
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.

Welcome! How can I help?

WebdriverIO AI Copilot