Começando
Bem-vindo à documentação do WebdriverIO. Isso ajudará você a começar rapidamente. Se você tiver problemas, poderá encontrar ajuda e respostas em nosso Servidor de Suporte do Discord ou pode entrar em contato comigo no Twitter.
Estas são as documentações para a versão mais recente (>=9.x) do WebdriverIO. If you are still using an older version, please visit the old documentation websites!
:::dica Canal Oficial do YouTube 🎥
Você pode encontrar mais vídeos sobre o WebdriverIO no canal oficial do YouTube. Não deixe 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 .
or if you want to create a new project:
npm init wdio@latest ./path/to/new/project
yarn create wdio .
or if you want to create a new project:
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 WebdriverIO CLI e executa um assistente de configuração que ajuda você a configurar seu conjunto de testes.
O assistente solicitará um conjunto de perguntas que o orientarão durante a configuração. Você pode passar um parâmetro --yes para escolher uma configuração padrão que usará o Mocha com o Chrome usando o padrão Objeto de Página.
- 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 # prints e.g. `8.13.10`
# executar assistente de configuração
npx wdio config
Executar teste
Você pode iniciar seu conjunto 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, você pode adicionar um parâmetro --spec:
npx wdio run ./wdio.conf.js --spec example.e2e.js
ou defina suítes em seu arquivo de configuração e execute 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 mecanismo de automação no Modo Autônomo dentro de um script Node.JS, você também pode instalar o WebdriverIO diretamente e usá-lo como um pacote, por exemplo, para gerar uma captura de tela de um site:
loading...
Observação: todos os comandos WebdriverIO são assíncronos e precisam ser manipulados corretamente usando async/await.
Testes de registro
O WebdriverIO fornece ferramentas para ajudar você a começar gravando suas ações de teste na tela e gerando scripts de teste do WebdriverIO automaticamente. Consulte Testes do gravador com o Chrome DevTools Recorder para obter mais informações.
Requisitos do sistema
Você precisará do Node.js instalado.
- Instale pelo menos a versão 18.20.0 ou superior, pois esta é a versão LTS ativa mais antiga
- Somente lançamentos que são ou se tornarão um lançamento LTS são oficialmente suportados
Se o Node não estiver instalado no seu sistema, sugerimos utilizar uma ferramenta como NVM ou Volta para ajudar no gerenciamento de várias versões ativas do Node.js. NVM é uma escolha popular, enquanto Volta também é uma boa alternativa.
