Começando
Bem-vindo à documentação do WebdriverIO. Ela irá ajudá-lo a começar rapidamente. Se você encontrar problemas, pode encontrar ajuda e respostas em nosso Servidor de Suporte no Discord ou pode me contatar no Twitter.
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!
Você pode encontrar mais vídeos sobre WebdriverIO no canal oficial do YouTube. Certifique-se de se inscrever!
Iniciar uma Configuração do 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
- Yarn
- pnpm
- bun
npm init wdio@latest .
ou se você quiser criar um novo projeto:
npm init wdio@latest ./path/to/new/project
yarn create wdio .
ou se você quiser criar um novo projeto:
yarn create wdio ./path/to/new/project
pnpm create wdio@latest .
ou se você quiser criar um novo projeto:
pnpm create wdio@latest ./path/to/new/project
bun create wdio@latest .
ou se você 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 fará um conjunto de perguntas que o guiará pela configuração. Você pode passar um parâmetro --yes
para escolher uma configuração padrão que usará Mocha com Chrome usando o padrão 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
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 você quiser executar arquivos de teste específicos, 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ê deseja 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:
loading...
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 do WebdriverIO automaticamente. Veja Gravar testes com o Chrome DevTools Recorder para mais informações.
Requisitos do Sistema
Você precisará ter Node.js instalado.
- Instale pelo menos a versão v18.20.0 ou superior, pois esta é a versão LTS ativa mais antiga
- Apenas as 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 utilizar 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.