Primeros pasos
Bienvenido a la página de documentación para WebdriverIO. Te ayudará a comenzar rápidamente. Si encuentras problemas puedes encontrar ayuda y respuestas en nuestro Servidor de soporte de Discord o puedes pulsarme en Twitter.
Estos son los documentos de la última versión (>=8.x) de WebdriverIO. Si todavía está utilizando una versión anterior, por favor visite los antiguos sitios web de documentación!
:::
Puede encontrar más videos sobre WebdriverIO en el canal oficial de YouTube. ¡Asegúrate de suscribirte!
Iniciar una configuración de WebdriverIO
Para añadir una configuración completa de WebdriverIO a un proyecto existente o nuevo usando el WebdriverIO Starter Toolkit, ejecute:
Si se encuentra en el directorio raíz de un proyecto existente, ejecute:
- NPM
- Yarn
- pnpm
npm init wdio .
o si desea crear un nuevo proyecto:
npm init wdio ./path/to/new/project
yarn create wdio .
o si desea crear un nuevo proyecto:
npm init wdio ./path/to/new/project
pnpm create wdio .
```sh
pnpm create wdio .
</TabItem>
</Tabs>
Este único comando descarga la herramienta CLI WebdriverIO y ejecuta un asistente de configuración que le ayuda a configurar su suite de pruebas.
<CreateProjectAnimation />
El asistente le preguntará a una serie de preguntas que le guiarán a través de la configuración. Puedes pasar un parámetro `--yes` para elegir una configuración predeterminada que usará Mocha con Chrome usando el patrón \[Page Object\](https://martinfowler.com/bliki/PageObject.html).
<Tabs
defaultValue="npm"
values={[
{label: 'NPM', value: 'npm'},
{label: 'Yarn', value: 'yarn'},
{label: 'pnpm', value: 'pnpm'},
]
}>
<TabItem value="npm">
```sh
npm init wdio . -- --yes
yarn create wdio . --yes
pnpm create wdio . --yes
Install CLI Manually
You can also add the CLI package to your project manually via:
npm i --save-dev @wdio/cli
npx wdio --version # prints e.g. `8.13.10`
# run configuration wizard
npx wdio config
Ejecutar Prueba
Puede iniciar su suite de pruebas usando el comando run
y apuntando a la configuración WebdriverIO que acaba de crear:
npx wdio run ./wdio.conf.js
Si quieres ejecutar archivos de prueba específicos puedes añadir un parámetro --spec
:
npx wdio run ./wdio.conf.js --spec example.e2e.js
o definir suites en su archivo de configuración y ejecutar sólo los archivos de prueba definidos por una suite:
npx wdio run ./wdio.conf.js --suite exampleSuiteName
Ejecutar en un script
Si desea utilizar WebdriverIO como un motor de automatización en Modo independiente dentro de un Nodo. Script S también puede instalar directamente WebdriverIO y usarlo como un paquete, por ejemplo, para generar una captura de pantalla de un sitio web:
loading...
Nota: todos los comandos WebdriverIO son asíncronos y necesitan ser manejados correctamente usando async/await
.
Registrar pruebas
WebdriverIO proporciona herramientas para ayudarle a comenzar grabando sus acciones de prueba en pantalla y generar scripts de prueba WebdriverIO automáticamente. Ver Grabadoras con Chrome DevTools Recorder para más información.
Requerimientos del sistema
Necesitará Node.js instalado.
- Instalar al menos v16.x o superior, ya que esta es la versión LTS más antigua
- Solo los lanzamientos que se conviertan o se convertirán en una versión de LTS están oficialmente soportados
Si el nodo no está instalado en su sistema, sugerimos utilizar una herramienta como NVM o Volta para ayudar a gestionar múltiples nodos activos. s versiones. NVM es una elección popular, mientras que Volta es también una buena alternativa.