Testrunner
O WebdriverIO vem com seu próprio test runner para ajudá-lo a começar a testar o mais rápido possível. Ele é destinado a fazer todo o trabalho para você, permite integração com serviços de terceiros e ajuda você a executar seus testes da maneira mais eficiente possível.
O testrunner do WebdriverIO é distribuído separadamente no pacote NPM @wdio/cli.
Instale-o assim:
- npm
- Yarn
- pnpm
- Bun
npm install @wdio/cli
yarn add @wdio/cli
pnpm add @wdio/cli
bun add @wdio/cli
Para ver a ajuda da interface de linha de comando, digite o seguinte comando no seu terminal:
$ npx wdio --help
wdio <command>
Commands:
wdio config Initialize WebdriverIO and setup configuration in
your current project.
wdio install <type> <name> Add a `reporter`, `service`, or `framework` to
your WebdriverIO project
wdio repl <option> [capabilities] Run WebDriver session in command line
wdio run <configPath> Run your WDIO configuration file to initialize
your tests.
Options:
--version Show version number [boolean]
--help Show help [boolean]
Ótimo! Agora você precisa definir um arquivo de configuração onde todas as informações sobre seus testes, capacidades e configurações serão definidas. Vá para a seção Configuration File para ver como esse arquivo deve ser.
Com o assistente de configuração wdio, é super fácil gerar seu arquivo de configuração. Basta executar:
$ npx wdio config
...e ele iniciará o utilitário de ajuda.
Ele fará perguntas e gerará um arquivo de configuração para você em menos de um minuto.
Uma vez que você configurou seu arquivo de configuração, pode iniciar seus testes executando:
npx wdio run wdio.conf.js
Você também pode inicializar sua execução de teste sem o comando run:
npx wdio wdio.conf.js
É isso! Agora, você pode acessar a instância do selenium através da variável global browser.
Comandos
wdio config
O comando config executa o assistente de configuração do WebdriverIO. Este assistente fará algumas perguntas sobre seu projeto WebdriverIO e criará um arquivo wdio.conf.js com base em suas respostas.
Exemplo:
wdio config
Opções:
--help imprime o menu de ajuda do WebdriverIO [boolean]
--npm Se deve instalar os pacotes usando NPM em vez de yarn [boolean]
wdio run
Este é o comando padrão para executar sua configuração.
O comando run inicializa seu arquivo de configuração WebdriverIO e executa seus testes.
Exemplo:
wdio run ./wdio.conf.js --watch
Opções:
--help imprime o menu de ajuda do WebdriverIO [boolean]
--version imprime a versão do WebdriverIO [boolean]
--hostname, -h endereço do host do driver de automação [string]
--port, -p porta do driver de automação [number]
--user, -u nome de usuário ao usar um serviço em nuvem como backend
[string]
--key, -k chave de acesso correspondente ao usuário [string]
--watch observa especificações para alterações [boolean]
--logLevel, -l nível de detalhamento do registro
[choices: "trace", "debug", "info", "warn", "error", "silent"]
--bail interrompe o test runner após uma quantidade específica de testes
terem falhado [number]
--baseUrl encurta chamadas de comando de URL definindo uma URL base
[string]
--waitforTimeout, -w tempo limite para todos os comandos waitForXXX [number]
--framework, -f define o framework (Mocha, Jasmine ou Cucumber) para
executar as especificações [string]
--reporters, -r repórteres para imprimir os resultados no stdout [array]
--suite substitui o atributo specs e executa a suíte definida
[array]
--spec executa um arquivo de especificação específico ou curingas - substitui specs
canalizados de stdin [array]
--exclude exclui arquivo(s) de especificação de uma execução - substitui specs
canalizados de stdin [array]
--repeat Repete especificações e/ou suítes específicas N vezes [number]
--mochaOpts Opções do Mocha
--jasmineOpts Opções do Jasmine
--cucumberOpts Opções do Cucumber
--tsConfigPath Caminho personalizado para `tsconfig.json` ou use [configuração tsConfigPath](/docs/configurationfile) do wdio
Nota: A autocompilação pode ser facilmente controlada com variáveis de ambiente
tsx. Veja também a documentação do TypeScript.
wdio install
O comando install permite adicionar repórteres e serviços aos seus projetos WebdriverIO via CLI.
Exemplo:
wdio install service sauce # instala @wdio/sauce-service
wdio install reporter dot # instala @wdio/dot-reporter
wdio install framework mocha # instala @wdio/mocha-framework
Se você quiser instalar os pacotes usando yarn em vez disso, você pode passar a flag --yarn para o comando:
wdio install service sauce --yarn
Você também pode passar um caminho de configuração personalizado se seu arquivo de configuração WDIO não estiver na mesma pasta em que está trabalhando:
wdio install service sauce --config="./path/to/wdio.conf.js"
Lista de serviços suportados
sauce
testingbot
firefox-profile
devtools
browserstack
appium
intercept
zafira-listener
reportportal
docker
wiremock
lambdatest
vite
nuxt
Lista de repórteres suportados
dot
spec
junit
allure
sumologic
concise
reportportal
video
html
json
mochawesome
timeline
Lista de frameworks suportados
mocha
jasmine
cucumber
wdio repl
O comando repl permite iniciar uma interface de linha de comando interativa para executar comandos WebdriverIO. Pode ser usado para fins de teste ou simplesmente para iniciar rapidamente uma sessão WebdriverIO.
Execute testes no chrome local:
wdio repl chrome
ou execute testes no Sauce Labs:
wdio repl chrome -u $SAUCE_USERNAME -k $SAUCE_ACCESS_KEY
Você pode aplicar os mesmos argumentos que pode no comando run.
