El objeto navegador
Extensión: EventEmitter
El objeto navegador es la instancia de sesión con la que se controla el navegador o el dispositivo móvil. Si utiliza el ejecutor de pruebas WDIO, puede acceder a la instancia WebDriver a través del objeto global browser o driver o importarlo utilizando @wdio/globals. Si utiliza WebdriverIO en modo autónomo, el objeto navegador es devuelto por el método remoto.
La sesión es inicializada por el sistema de pruebas. Lo mismo ocurre para finalizar la sesión. Esto también lo hace el proceso de ejecución de pruebas.
Propiedades
Un objeto navegador tiene las siguientes propiedades:
| Nombre | Tipo | Información |
|---|---|---|
capacidades | Objeto | Capacidad asignada desde el servidor remoto. Ejemplo: { |
capacidadesSolicitadas | Objeto | Capacidades solicitadas al servidor remoto. Ejemplo: { browserName: 'chrome' } |
sessionId | String | Id de sesión asignado desde el servidor remoto. |
opciones | Object | Se crearon opciones WebdriverIO, dependiendo de cómo se creó el objeto del navegador. Ver más tipos de configuración. |
commandList | String[] | Una lista de comandos registrados a la instancia del navegador |
isMobile | Boolean | Indica una sesión móvil. Vea más en Banderas móviles. |
isIOS | Boolean | Indica una sesión de iOS. Vea más en Banderas móviles. |
isAndroid | Boolean | Indica una sesión Android. Vea más en Banderas móviles. |
Métodos
En función del backend de automatización utilizado para su sesión, WebdriverIO identifica qué comandos de protocolo se adjuntarán al objeto navegador. Por ejemplo, si ejecuta una sesión automatizada en Chrome, tendrá acceso a comandos específicos de Chromium como elementHover pero no a ninguno de los comandos de Appium.
Además WebdriverIO proporciona un conjunto de métodos convenientes que se recomienda utilizar, para interactuar con los navegador o loselementos en la página.
Además, dispone de los siguientes comandos:
| Nombre | Parámetros | Detalles |
|---|---|---|
addCommand | - commandName (Type: String)- fn (Type: Function)- attachToElement (Type: boolean) | Permite definir comandos personalizados que pueden ser llamados desde el objeto navegador con fines de composición. Más información en la guía Comandos personalizados. |
overwriteCommand | - commandName (Type: String)- fn (Type: Function)- attachToElement (Type: boolean) | Allows to overwrite any browser command with custom functionality. Utilícelo con cuidado, ya que puede confundir a los usuarios del marco. Más información en la guía Comandos personalizados. |
addLocatorStrategy | - strategyName (Type: String)- fn (Type: Function) | Allows to define a custom selector strategy, read more in the Selectors guide. |
Avisos
Banderas móviles
Si necesita modificar su prueba basada en si su sesión se ejecuta o no en un dispositivo móvil, puede acceder a las banderas móviles para comprobar.
Por ejemplo, dado los dos archivos:
// wdio.conf.js
export const config = {
// ...
capabilities: {
platformName: 'iOS',
app: 'net.company.SafariLauncher',
udid: '123123123123abc',
deviceName: 'iPhone',
// ...
}
// ...
}
Puedes acceder a estas banderas en tu prueba así:
// Note: `driver` is the equivalent to the `browser` object but semantically more correct
// you can choose which global variable you want to use
console.log(driver.isMobile) // outputs: true
console.log(driver.isIOS) // outputs: true
console.log(driver.isAndroid) // outputs: false
Esto puede ser útil si, por ejemplo, quiere definir selectores en sus objetos de página basados en el tipo de dispositivo, de la siguiente manera:
// mypageobject.page.js
import Page from './page'
class LoginPage extends Page {
// ...
get username() {
const selectorAndroid = 'new UiSelector().text("Cancel").className("android.widget.Button")'
const selectorIOS = 'UIATarget.localTarget().frontMostApp().mainWindow().buttons()[0]'
const selectorType = driver.isAndroid ? 'android' : 'ios'
const selector = driver.isAndroid ? selectorAndroid : selectorIOS
return $(`${selectorType}=${selector}`)
}
// ...
}
También puede utilizar estas banderas para ejecutar sólo ciertas pruebas para ciertos tipos de dispositivos:
// mytest.e2e.js
describe('mi test', () => {
// ...
// sólo ejecutar pruebas con dispositivos Android
if (driver.isAndroid) {
it('prueba algo sólo para Android', () => {
// ...
})
}
// ...
})
Eventos
El objeto del navegador es un EventEmitter y se emiten un par de eventos para sus casos de uso.
He aquí una lista de eventos. Tenga en cuenta que esta no es la lista completa de eventos disponibles todavía. Siéntase libre de contribuir a actualizar el documento añadiendo descripciones de más eventos aquí.
request.performance
Este es un evento para medir las operaciones de nivel de WebDriver. Cada vez que WebdriverIO envíe una solicitud al backend de WebDriver, este evento se emitirá con alguna información útil:
durationMilisegundo: Duración del tiempo de la solicitud en milisegundo.error: Objeto de error si la solicitud falló.request: Solicitar objeto. Puede encontrar el url, método, cabezas, etc.retryCount: Si es0, la solicitud fue el primer intento. Se incrementará cuando WebDriverIO vuelva a intentarlo bajo el capó.success: Booleano para representar la solicitud fue exitoso o no. Si esfalse,errorpropiedad también será proporcionada.
Un ejemplo de evento:
Object {
"durationMillisecond": 0.01770925521850586,
"error": [Error: Timeout],
"request": Object { ... },
"retryCount": 0,
"success": false,
},
Comandos personalizados
Puede configurar comandos personalizados en el ámbito del navegador para abstruir los flujos de trabajo que se utilizan comúnmente. Consulte nuestra guía en Comandos personalizados para más información.
