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á tempranamente 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 Chromedriver, solo aplicables para pruebas en Chrome
  • moz:firefoxOptions: Extensiones 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 controlador 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 specs 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 specs 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. Se excluye después de que se aplica la opción de configuración global 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 de controlador comunes​

Aunque todos los controladores ofrecen diferentes parámetros para 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
Por defecto: process.env.WEBDRIVER_CACHE_DIR || os.tmpdir()

binary​

Ruta a un binario de controlador personalizado. Si se establece, WebdriverIO no intentará descargar un controlador pero usará 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 usará 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 de URL base para comandos, por ejemplo wd/url.

Ejemplo: /

Tipo: string

logPath​

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

Tipo: string

logLevel​

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

Tipo: string

verbose​

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

Tipo: boolean

silent​

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

Tipo: boolean

appendLog​

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

Tipo: boolean

replayable​

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

Tipo: boolean

readableTimestamp​

Añadir marcas de tiempo legibles al registro.

Tipo: boolean

enableChromeLogs​

Mostrar registros desde el navegador (anula otras opciones de registro).

Tipo: boolean

bidiMapperPath​

Ruta de mapeador bidi personalizado.

Tipo: string

allowedIps​

Lista blanca separada por comas de direcciones IP remotas que pueden conectarse a EdgeDriver.

Tipo: string[]
Por defecto: ['']

allowedOrigins​

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

Tipo: string[]
Por defecto: ['*']

spawnOpts​

Opciones que se pasarán al proceso del controlador.

Tipo: SpawnOptionsWithoutStdio | SpawnOptionsWithStdioTuple<StdioOption, StdioOption, StdioOption>
Por defecto: 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 una 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:

Cuando se realizan pruebas en Chrome, WebdriverIO descargará automáticamente la versión de navegador y controlador deseada 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 mediante:

{
    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 mediante:

{
    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 en las pruebas para esa capacidad específica, puedes hacerlo configurando:

export const config = {
    // ...
    capabilities: [{
        browserName: 'chrome',
        'custom:caps': {
            // configuraciones personalizadas
        }
    }]
}

Se recomienda seguir el protocolo W3C cuando se trata de nombrar capacidades, que requiere un carácter : (dos puntos), que denota un espacio de nombres específico de implementación. Dentro de tus pruebas puedes acceder a tu capacidad personalizada a través de, por ejemplo:

browser.capabilities['custom:caps']

Para garantizar la seguridad de tipos, puedes extender la interfaz de capacidades de WebdriverIO mediante:

declare global {
    namespace WebdriverIO {
        interface Capabilities {
            'custom:caps': {
                // ...
            }
        }
    }
}

Welcome! How can I help?

WebdriverIO AI Copilot