Primeiros Passos

Bem-vindo à documentação do WebdriverIO. Ela vai ajudá-lo a começar rapidamente. Se você encontrar problemas, pode obter ajuda e respostas em nosso Servidor de Suporte no Discord ou nos contatar no 𝕏.

informação

Esta é a documentação para a versão mais recente (>=9.x) do WebdriverIO. Se você ainda está usando uma versão mais antiga, visite os sites de documentação antigos!

Canal Oficial do YouTube 🎥

Você pode encontrar mais vídeos sobre o WebdriverIO no canal oficial do YouTube. Certifique-se de se inscrever!

Iniciar uma Configuração WebdriverIO

Para adicionar uma configuração completa do WebdriverIO a um projeto existente ou novo usando o WebdriverIO Starter Toolkit, execute:

Se você estiver no diretório raiz de um projeto existente, execute:

NPM

npm init wdio@latest .

ou se quiser criar um novo projeto:

npm init wdio@latest ./path/to/new/project

Yarn

yarn create wdio .

ou se quiser criar um novo projeto:

yarn create wdio ./path/to/new/project

pnpm

pnpm create wdio@latest .

ou se quiser criar um novo projeto:

pnpm create wdio@latest ./path/to/new/project

bun

bun create wdio@latest .

ou se quiser criar um novo projeto:

bun create wdio@latest ./path/to/new/project

Este único comando baixa a ferramenta CLI do WebdriverIO e executa um assistente de configuração que ajuda você a configurar sua suíte de testes.

O assistente irá fazer um conjunto de perguntas que orientam você durante a configuração. Você pode passar o parâmetro --yes para escolher uma configuração padrão que usará o Mocha com Chrome usando o padrão Page Object.

NPM

npm init wdio@latest . -- --yes

Yarn

yarn create wdio . --yes

pnpm

pnpm create wdio@latest . --yes

bun

bun create wdio@latest . --yes

Instalar CLI Manualmente

Você também pode adicionar o pacote CLI ao seu projeto manualmente via:

npm i --save-dev @wdio/cli
npx wdio --version # imprime, por exemplo, `8.13.10`

# executar assistente de configuração
npx wdio config

Executar Teste

Você pode iniciar sua suíte de testes usando o comando run e apontando para a configuração do WebdriverIO que você acabou de criar:

npx wdio run ./wdio.conf.js

Se quiser executar arquivos de teste específicos, você pode adicionar um parâmetro --spec:

npx wdio run ./wdio.conf.js --spec example.e2e.js

ou definir suítes no seu arquivo de configuração e executar apenas os arquivos de teste definidos em uma suíte:

npx wdio run ./wdio.conf.js --suite exampleSuiteName

Executar em um script

Se você quiser usar o WebdriverIO como um motor de automação no Modo Standalone dentro de um script Node.JS, você também pode instalar diretamente o WebdriverIO e usá-lo como um pacote, por exemplo, para gerar uma captura de tela de um site:

getting-started/run-in-script.js

loading...

View on GitHub

Nota: todos os comandos do WebdriverIO são assíncronos e precisam ser tratados adequadamente usando async/await.

Gravar testes

O WebdriverIO fornece ferramentas para ajudá-lo a começar gravando suas ações de teste na tela e gerando scripts de teste WebdriverIO automaticamente. Veja Gravar testes com Chrome DevTools Recorder para mais informações.

Requisitos do Sistema

Você precisará ter Node.js instalado.

• Instale pelo menos v18.20.0 ou superior, pois esta é a versão LTS ativa mais antiga
• Apenas versões que são ou se tornarão uma versão LTS são oficialmente suportadas

Se o Node não estiver atualmente instalado em seu sistema, sugerimos a utilização de uma ferramenta como NVM ou Volta para auxiliar no gerenciamento de múltiplas versões ativas do Node.js. NVM é uma escolha popular, enquanto Volta também é uma boa alternativa.