Påstående

WDIO testrunner kommer med ett inbyggt påståendebibliotek som låter dig göra kraftfulla påståenden om olika aspekter av webbläsaren eller element inom din (webb) applikation. Det utökar Jests Matchers funktionalitet med ytterligare, för e2e-testning optimerade, matchers, t.ex.:

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

eller

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

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

För hela listan, se expect API-dokumentationen.

Migrering från Chai

Chai och expect-webdriverio kan samexistera, och med några mindre justeringar kan en smidig övergång till expect-webdriverio uppnås. Om du har uppgraderat till WebdriverIO v6 så har du som standard tillgång till alla påståenden från expect-webdriverio direkt. Detta innebär att globalt var du än använder expect skulle du anropa ett expect-webdriverio-påstående. Det vill säga, såvida du inte ställer in injectGlobals till false eller uttryckligen har åsidosatt den globala expect för att använda Chai. I det här fallet skulle du inte ha tillgång till några av expect-webdriverio-påståendena utan att uttryckligen importera expect-webdriverio-paketet där du behöver det.

Denna guide visar exempel på hur man migrerar från Chai om det har åsidosatts lokalt och hur man migrerar från Chai om det har åsidosatts globalt.

Lokalt

Anta att Chai importerades uttryckligen i en fil, t.ex.:

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

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

För att migrera denna kod, ta bort Chai-importen och använd den nya expect-webdriverio-påståendemetoden toHaveUrl istället:

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

Om du ville använda både Chai och expect-webdriverio i samma fil skulle du behålla Chai-importen och expect skulle som standard vara expect-webdriverio-påståendet, t.ex.:

// 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); // Chai assertion
    })
});

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

Globalt

Anta att expect globalt har åsidosatts för att använda Chai. För att använda expect-webdriverio-påståenden behöver vi ställa in en global variabel i "before"-kroken, t.ex.:

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

Nu kan Chai och expect-webdriverio användas sida vid sida. I din kod skulle du använda Chai och expect-webdriverio-påståenden enligt följande, t.ex.:

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

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

För att migrera skulle du långsamt flytta varje Chai-påstående till expect-webdriverio. När alla Chai-påståenden har ersatts i hela kodbasen kan "before"-kroken tas bort. En global sök och ersätt för att ersätta alla instanser av wdioExpect till expect kommer sedan att avsluta migreringen.