Saltar al contenido principal

Capacidades

Una capacidad es una definición para una interfaz remota. Ayuda a WebdriverIO a entender en qué navegador o entorno móvil deseas ejecutar tus pruebas. Las capacidades son menos cruciales cuando se desarrollan pruebas localmente, ya que se ejecutan en una interfaz remota la mayoría del tiempo, pero se vuelven más importantes cuando se ejecuta un gran conjunto de pruebas de integración en CI/CD.

información

El formato de un objeto de capacidad está bien definido por la especificación WebDriver. El ejecutor de pruebas de WebdriverIO fallará temprano si las capacidades definidas por el usuario no se adhieren a esa especificación.

Capacidades personalizadas​

Aunque la cantidad de capacidades definidas fijas es muy baja, cualquiera puede proporcionar y aceptar capacidades personalizadas que son específicas del controlador de automatización o interfaz remota:

Extensiones de capacidades específicas del navegador​

  • goog:chromeOptions: Extensiones de Chromedriver, solo aplicables para pruebas en Chrome
  • moz:firefoxOptions: Extensiones de Geckodriver, solo aplicables para pruebas en Firefox
  • ms:edgeOptions: EdgeOptions para especificar el entorno cuando se usa EdgeDriver para probar Chromium Edge

Extensiones de capacidades de proveedores en la nube​

Extensiones de capacidades del motor de automatización​

Capacidades de WebdriverIO para gestionar opciones de controladores de navegador​

WebdriverIO gestiona la instalación y ejecución del controlador del navegador por ti. WebdriverIO utiliza una capacidad personalizada que te permite pasar parámetros al controlador.

wdio:chromedriverOptions​

Opciones específicas pasadas a Chromedriver al iniciarlo.

wdio:geckodriverOptions​

Opciones específicas pasadas a Geckodriver al iniciarlo.

wdio:edgedriverOptions​

Opciones específicas pasadas a Edgedriver al iniciarlo.

wdio:safaridriverOptions​

Opciones específicas pasadas a Safari al iniciarlo.

wdio:maxInstances​

Número máximo de trabajadores paralelos en ejecución para el navegador/capacidad específica. Tiene prioridad sobre maxInstances y maxInstancesPerCapability.

Tipo: number

wdio:specs​

Define especificaciones para la ejecución de pruebas para ese navegador/capacidad. Igual que la opción de configuración regular specs, pero específica para el navegador/capacidad. Tiene prioridad sobre specs.

Tipo: (String | String[])[]

wdio:exclude​

Excluye especificaciones de la ejecución de pruebas para ese navegador/capacidad. Igual que la opción de configuración regular exclude, pero específica para el navegador/capacidad. Tiene prioridad sobre exclude.

Tipo: String[]

wdio:enforceWebDriverClassic​

Por defecto, WebdriverIO intenta establecer una sesión WebDriver Bidi. Si no prefieres eso, puedes establecer esta bandera para deshabilitar este comportamiento.

Tipo: boolean

Opciones comunes del controlador​

Aunque todos los controladores ofrecen diferentes parámetros para la configuración, hay algunos comunes que WebdriverIO entiende y utiliza para configurar tu controlador o navegador:

cacheDir​

La ruta a la raíz del directorio de caché. Este directorio se utiliza para almacenar todos los controladores que se descargan al intentar iniciar una sesión.

Tipo: string
Predeterminado: process.env.WEBDRIVER_CACHE_DIR || os.tmpdir()

binary​

Ruta a un binario de controlador personalizado. Si se establece, WebdriverIO no intentará descargar un controlador, sino que utilizará el proporcionado por esta ruta. Asegúrate de que el controlador sea compatible con el navegador que estás utilizando.

Puedes proporcionar esta ruta a través de las variables de entorno CHROMEDRIVER_PATH, GECKODRIVER_PATH o EDGEDRIVER_PATH.

Tipo: string

precaución

Si se establece el binary del controlador, WebdriverIO no intentará descargar un controlador, sino que utilizará el proporcionado por esta ruta. Asegúrate de que el controlador sea compatible con el navegador que estás utilizando.

Opciones de controlador específicas del navegador​

Para propagar opciones al controlador, puedes usar las siguientes capacidades personalizadas:

  • Chrome o Chromium: wdio:chromedriverOptions
  • Firefox: wdio:geckodriverOptions
  • Microsoft Edge: wdio:edgedriverOptions
  • Safari: wdio:safaridriverOptions
adbPort​

El puerto en el que debe ejecutarse el controlador ADB.

Ejemplo: 9515

Tipo: number

urlBase​

Prefijo de ruta URL base para comandos, por ejemplo, wd/url.

Ejemplo: /

Tipo: string

logPath​

Escribe el registro del servidor en un archivo en lugar de stderr, aumenta el nivel de registro a INFO

Tipo: string

logLevel​

Establece el nivel de registro. Opciones posibles ALL, DEBUG, INFO, WARNING, SEVERE, OFF.

Tipo: string

verbose​

Registra verbosamente (equivalente a --log-level=ALL)

Tipo: boolean

silent​

No registra nada (equivalente a --log-level=OFF)

Tipo: boolean

appendLog​

Añade al archivo de registro en lugar de reescribirlo.

Tipo: boolean

replayable​

Registra verbosamente y no trunca cadenas largas para que el registro pueda ser reproducido (experimental).

Tipo: boolean

readableTimestamp​

Añade marcas de tiempo legibles al registro.

Tipo: boolean

enableChromeLogs​

Muestra registros del navegador (anula otras opciones de registro).

Tipo: boolean

bidiMapperPath​

Ruta personalizada del mapeador bidi.

Tipo: string

allowedIps​

Lista de direcciones IP remotas permitidas separadas por comas que pueden conectarse a EdgeDriver.

Tipo: string[]
Predeterminado: ['']

allowedOrigins​

Lista de orígenes de solicitud permitidos separados por comas que pueden conectarse a EdgeDriver. ¡Usar * para permitir cualquier origen de host es peligroso!

Tipo: string[]
Predeterminado: ['*']

spawnOpts​

Opciones que se pasarán al proceso del controlador.

Tipo: SpawnOptionsWithoutStdio | SpawnOptionsWithStdioTuple<StdioOption, StdioOption, StdioOption>
Predeterminado: undefined

Capacidades especiales para casos de uso específicos​

Esta es una lista de ejemplos que muestran qué capacidades deben aplicarse para lograr un caso de uso determinado.

Ejecutar navegador sin interfaz gráfica (Headless)​

Ejecutar un navegador sin interfaz gráfica significa ejecutar una instancia del navegador sin ventana o interfaz de usuario. Esto se utiliza principalmente en entornos CI/CD donde no se utiliza pantalla. Para ejecutar un navegador en modo sin interfaz gráfica, aplica las siguientes capacidades:

{
    browserName: 'chrome',   // o 'chromium'
    'goog:chromeOptions': {
        args: ['headless', 'disable-gpu']
    }
}

Automatizar diferentes canales de navegador​

Si deseas probar una versión de navegador que aún no se ha lanzado como estable, por ejemplo, Chrome Canary, puedes hacerlo configurando capacidades y apuntando al navegador que deseas iniciar, por ejemplo:

Al probar en Chrome, WebdriverIO descargará automáticamente la versión del navegador y el controlador deseados según el browserVersion definido, por ejemplo:

{
    browserName: 'chrome', // o 'chromium'
    browserVersion: '116' // o '116.0.5845.96', 'stable', 'dev', 'canary', 'beta' o 'latest' (igual que 'canary')
}

Si deseas probar un navegador descargado manualmente, puedes proporcionar una ruta binaria al navegador a través de:

{
    browserName: 'chrome',  // o 'chromium'
    'goog:chromeOptions': {
        binary: '/Applications/Google\ Chrome\ Canary.app/Contents/MacOS/Google\ Chrome\ Canary'
    }
}

Además, si deseas usar un controlador descargado manualmente, puedes proporcionar una ruta binaria al controlador a través de:

{
    browserName: 'chrome', // o 'chromium'
    'wdio:chromedriverOptions': {
        binary: '/path/to/chromdriver'
    }
}

Extender capacidades personalizadas​

Si deseas definir tu propio conjunto de capacidades para, por ejemplo, almacenar datos arbitrarios que se utilizarán dentro de las pruebas para esa capacidad específica, puedes hac

Welcome! How can I help?

WebdriverIO AI Copilot