L'objet Browser
Comprend : EventEmitter
L'objet "browser" est l'instance de session que vous utilisez pour contrôler le navigateur ou périphérique mobile. Si vous utilisez l'exécuteur de test WDIO, vous pouvez accéder à l'instance WebDriver via l'objet global browser ou driver ou l'importer à l'aide de @wdio/globals. Si vous utilisez WebdriverIO en mode autonome, l'objet browser est renvoyé par la méthode remote.
La session est initialisée par l'exécuteur de test. Il en va de même pour la clôture de la session. Cela est également fait par le processus d'exécuteur de test.
Attributs
Un objet browser possède les propriétés suivantes :
| Nom | Type | Détails |
|---|---|---|
capacités | Objet | Capacité assignée par le serveur distant. Exemple : { |
capacités demandées | Objet | Capacités demandées au serveur distant. Exemple : { browserName: 'chrome' } |
sessionId | String | Id de session attribué à partir du serveur distant. |
options | Object | WebdriverIO options selon la façon dont l'objet navigateur a été créé. Voir plus types de configuration. |
commandList | String[] | Une liste de commandes enregistrées dans l'instance du navigateur |
isMobile | Boolean | Indique une session mobile. Voir plus sous Mobile Flags. |
isIOS | Boolean | Indique une session iOS. Voir plus sous Mobile Flags. |
isAndroid | Boolean | Indique une session Android. Voir plus sous Mobile Flags. |
Méthodes
Basé sur le backend d'automatisation utilisé pour votre session, WebdriverIO identifie quelles commandes du protocole seront attachées à l'objet browser. Par exemple, si vous lancez une session automatisée dans Chrome, vous aurez accès aux commandes spécifiques à Chromium telles que elementHover mais aucune des commandes Appium.
De plus, WebdriverIO fournit un ensemble de méthodes pratiques qu'il est recommandé d'utiliser pour interagir avec le navigateur ou les éléments sur la page.
En plus de cela, les commandes suivantes sont disponibles :
| Nom | Paramètres | Détails |
|---|---|---|
addCommand | - commandName (Type: String)- fn (Type: Function)- attachToElement (Type: boolean) | Permet de définir des commandes personnalisées pouvant être appelées depuis l'objet browser à des fins de composition. Pour en savoir plus, consultez le guide Commande personnalisée. |
overwriteCommand | - commandName (Type: String)- fn (Type: Function)- attachToElement (Type: boolean) | Permet d'écraser n'importe quelle commande de navigateur avec des fonctionnalités personnalisées. Utilisez-le avec précaution car cela peut perturber les utilisateurs du framework . Pour en savoir plus, consultez le guide Commande personnalisée. |
addLocatorStrategy | - strategyName (Type: String)- fn (Type: Function) | Permet de définir une stratégie de sélection personnalisée, Pour en savoir plus consultez le guide de Sélections. |
Remarques
Drapeaux mobiles
Si vous devez modifier votre test selon que votre session s'exécute ou non sur un appareil mobile, vous pouvez accéder aux indicateurs mobiles à vérifier.
Par exemple, compte tenu de cette configuration :
// wdio.conf.js
export const config = {
// ...
capabilities: {
platformName: 'iOS',
app: 'net.company.SafariLauncher',
udid: '123123123123abc',
deviceName: 'iPhone',
// ...
}
// ...
}
Vous pouvez accéder à ces drapeaux dans votre test comme suit :
// 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
Cela peut être utile si, par exemple, vous souhaitez définir des sélecteurs dans vos objets de page en fonction du type d'appareil, comme ceci :
// 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}`)
}
// ...
}
Vous pouvez également utiliser ces indicateurs pour exécuter uniquement certains tests pour certains types d'appareils :
// mytest.e2e.js
describe('my test', () => {
// ...
// only run test with Android devices
if (driver.isAndroid) {
it('tests something only for Android', () => {
// ...
})
}
// ...
})
Événements
L'objet browser est un EventEmitter et quelques événements sont émis pour vos cas d'utilisation.
Voici une liste d'événements. Gardez à l'esprit qu'il ne s'agit pas de la liste complète des événements disponibles. N'hésitez pas à contribuer en mettant à jour le document et en ajoutant des descriptions des autres événements ici.
request.performance
Il s'agit d'un événement pour mesurer les opérations au niveau WebDriver. Chaque fois que WebdriverIO envoie une requête au backend WebDriver, cet événement sera émis avec quelques informations utiles :
durationMillisecond: Durée de la requête en milliseconde.error: objet d'erreur si la requête a échoué.request: Objet de la requête. Vous pouvez trouver l'Url, la méthode, les en-têtes, etc.retryCount: Si c'est0, la requête était la première tentative. Il augmentera lorsque WebDriverIO réessaiera par la suite.success: Booléen pour représenter si la requête a été réussi ou non. Si c'estfalse, la propriétéerrorsera également fournie.
Un exemple d'événement :
Object {
"durationMillisecond": 0.01770925521850586,
"error": [Error: Timeout],
"request": Object { ... },
"retryCount": 0,
"success": false,
},
Commandes personnalisées
Vous pouvez définir des commandes personnalisées sur la portée du navigateur pour abstraire les workflows qui sont couramment utilisés. Consultez notre guide sur Commandes personnalisées pour plus d'informations.
