Assertion

Le testrunner WDIO est livré avec une bibliothèque d'assertions intégrée qui vous permet de faire des assertions puissantes sur divers aspects du navigateur ou des éléments au sein de votre application (web). Il étend la fonctionnalité Matchers de Jest avec des matchers supplémentaires, optimisés pour les tests e2e, par exemple:

const $button = await $('button')
await expect($button).toBeDisplayed()

ou

const selectOptions = await $$('form select>option')

// make sure there is at least one option in select
await expect(selectOptions).toHaveChildren({ gte: 1 })

Pour la liste complète, consultez la documentation de l'API expect.

Assertions souples

WebdriverIO inclut des assertions souples par défaut à partir d'expect-webdriver(5.2.0). Les assertions souples permettent à vos tests de continuer l'exécution même lorsqu'une assertion échoue. Tous les échecs sont collectés et signalés à la fin du test.

Utilisation

// Ces assertions ne lanceront pas d'erreur immédiatement en cas d'échec
await expect.soft(await $('h1').getText()).toEqual('Basketball Shoes');
await expect.soft(await $('#price').getText()).toMatch(/€\d+/);

// Les assertions régulières continuent de lancer des erreurs immédiatement
await expect(await $('.add-to-cart').isClickable()).toBe(true);

Migration depuis Chai

Chai et expect-webdriverio peuvent coexister, et avec quelques ajustements mineurs, une transition en douceur vers expect-webdriverio peut être réalisée. Si vous avez effectué une mise à niveau vers WebdriverIO v6, vous aurez par défaut accès à toutes les assertions de expect-webdriverio dès le départ. Cela signifie que globalement, partout où vous utilisez expect, vous appelleriez une assertion expect-webdriverio. Cela, sauf si vous avez défini injectGlobals sur false ou si vous avez explicitement remplacé le expect global pour utiliser Chai. Dans ce cas, vous n'auriez pas accès aux assertions expect-webdriverio sans importer explicitement le package expect-webdriverio là où vous en avez besoin.

Ce guide montrera des exemples de migration depuis Chai s'il a été remplacé localement et comment migrer depuis Chai s'il a été remplacé globalement.

Local

Supposons que Chai ait été importé explicitement dans un fichier, par exemple:

// myfile.js - code original
import { expect as expectChai } from 'chai'

describe('Homepage', () => {
    it('should assert', async () => {
        await browser.url('./')
        expectChai(await browser.getUrl()).to.include('/login')
    })
})

Pour migrer ce code, supprimez l'import de Chai et utilisez la nouvelle méthode d'assertion expect-webdriverio toHaveUrl à la place:

// myfile.js - code migré
describe('Homepage', () => {
    it('should assert', async () => {
        await browser.url('./')
        await expect(browser).toHaveUrl('/login') // nouvelle méthode API expect-webdriverio https://webdriver.io/docs/api/expect-webdriverio.html#tohaveurl
    });
});

Si vous souhaitez utiliser à la fois Chai et expect-webdriverio dans le même fichier, vous conserveriez l'import de Chai et expect serait par défaut l'assertion expect-webdriverio, par exemple:

// myfile.js
import { expect as expectChai } from 'chai'
import { expect as expectWDIO } from '@wdio/globals'

describe('Element', () => {
    it('should be displayed', async () => {
        const isDisplayed = await $("#element").isDisplayed()
        expectChai(isDisplayed).to.equal(true); // Assertion Chai
    })
});

describe('Other element', () => {
    it('should not be displayed', async () => {
        await expectWDIO($("#element")).not.toBeDisplayed(); // assertion expect-webdriverio
    })
})

Global

Supposons que expect ait été globalement remplacé pour utiliser Chai. Pour utiliser les assertions expect-webdriverio, nous devons définir globalement une variable dans le hook "before", par exemple:

// wdio.conf.js
before: async () => {
    await import('expect-webdriverio');
    global.wdioExpect = global.expect;
    const chai = await import('chai');
    global.expect = chai.expect;
}

Maintenant, Chai et expect-webdriverio peuvent être utilisés côte à côte. Dans votre code, vous utiliseriez les assertions Chai et expect-webdriverio comme suit, par exemple:

// myfile.js
describe('Element', () => {
    it('should be displayed', async () => {
        const isDisplayed = await $("#element").isDisplayed()
        expect(isDisplayed).to.equal(true); // Assertion Chai
    });
});

describe('Other element', () => {
    it('should not be displayed', async () => {
        await expectWdio($("#element")).not.toBeDisplayed(); // assertion expect-webdriverio
    });
});

Pour migrer, vous déplaceriez progressivement chaque assertion Chai vers expect-webdriverio. Une fois que toutes les assertions Chai ont été remplacées dans toute la base de code, le hook "before" peut être supprimé. Une recherche et un remplacement global pour remplacer toutes les instances de wdioExpect par expect termineront ensuite la migration.