Primeros Pasos

Bienvenido a la documentación de WebdriverIO. Te ayudará a comenzar rápidamente. Si encuentras problemas, puedes obtener ayuda y respuestas en nuestro Servidor de Soporte en Discord o puedes contactarme en Twitter.

información

Esta es la documentación para la última versión (>=9.x) de WebdriverIO. Si todavía estás utilizando una versión anterior, ¡visita los sitios web de documentación antiguos!

Canal Oficial de YouTube 🎥

Puedes encontrar más videos sobre WebdriverIO en el canal oficial de YouTube. ¡Asegúrate de suscribirte!

Iniciar una Configuración de WebdriverIO

Para agregar una configuración completa de WebdriverIO a un proyecto existente o nuevo utilizando el Kit de Inicio de WebdriverIO, ejecuta:

Si estás en el directorio raíz de un proyecto existente, ejecuta:

NPM

npm init wdio@latest .

o si quieres crear un nuevo proyecto:

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

Yarn

yarn create wdio .

o si quieres crear un nuevo proyecto:

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

pnpm

pnpm create wdio@latest .

o si quieres crear un nuevo proyecto:

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

bun

bun create wdio@latest .

o si quieres crear un nuevo proyecto:

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

Este único comando descarga la herramienta CLI de WebdriverIO y ejecuta un asistente de configuración que te ayuda a configurar tu suite de pruebas.

El asistente te hará una serie de preguntas que te guiarán a través de la configuración. Puedes pasar un parámetro --yes para elegir una configuración predeterminada que utilizará Mocha con Chrome usando el patrón 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

También puedes agregar el paquete CLI a tu proyecto manualmente mediante:

npm i --save-dev @wdio/cli
npx wdio --version # imprime p.ej. `8.13.10`

# ejecutar el asistente de configuración
npx wdio config

Ejecutar Prueba

Puedes iniciar tu suite de pruebas utilizando el comando run y apuntando a la configuración de WebdriverIO que acabas de crear:

npx wdio run ./wdio.conf.js

Si deseas ejecutar archivos de prueba específicos, puedes agregar un parámetro --spec:

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

o definir suites en tu archivo de configuración y ejecutar solo los archivos de prueba definidos en una suite:

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

Ejecutar en un script

Si deseas utilizar WebdriverIO como un motor de automatización en Modo Independiente dentro de un script Node.JS, también puedes instalar WebdriverIO directamente y usarlo como un paquete, por ejemplo, para generar una captura de pantalla de un sitio web:

getting-started/run-in-script.js

loading...

View on GitHub

Nota: todos los comandos de WebdriverIO son asincrónicos y deben manejarse adecuadamente usando async/await.

Grabar pruebas

WebdriverIO proporciona herramientas para ayudarte a comenzar grabando tus acciones de prueba en pantalla y generando scripts de prueba de WebdriverIO automáticamente. Consulta Grabar pruebas con Chrome DevTools Recorder para obtener más información.

Requisitos del Sistema

Necesitarás tener instalado Node.js.

• Instala al menos la versión v18.20.0 o superior, ya que esta es la versión LTS activa más antigua
• Solo se admiten oficialmente las versiones que son o serán una versión LTS

Si Node no está instalado actualmente en tu sistema, sugerimos utilizar una herramienta como NVM o Volta para ayudar a gestionar múltiples versiones activas de Node.js. NVM es una opción popular, mientras que Volta también es una buena alternativa.