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.

info

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!

:::

Official YouTube Channel 🎥

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

npm init wdio .

o si desea crear un nuevo proyecto:

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

Yarn

yarn create wdio .

o si desea crear un nuevo proyecto:

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

pnpm

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:

getting-started/run-in-script.js

loading...

View on GitHub

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.