Parametrizzare i Test

Puoi parametrizzare facilmente i test a livello di test, tramite semplici cicli for, ad esempio:

const people = ['Alice', 'Bob']
describe('my tests', () => {
    for (const name of people) {
        it(`testing with ${name}`, async () => {
            // ...
        })
    }
})

o estraendo i test in funzioni dinamiche, ad esempio:

import { browser } from '@wdio/globals'

function testComponent(componentName, options) {
  it(`should test my ${componentName}`, async () => {
    await browser.url(`/${componentName}`)
    await expect($('input')).toHaveValue(options.expectedValue)
  })
}

describe('page components', () => {
    testComponent('component-a', { expectedValue: 'some expected value' })
    testComponent('component-b', { expectedValue: 'some other expected value' })
})

Passaggio di Variabili d'Ambiente

Puoi utilizzare le variabili d'ambiente per configurare i test dalla riga di comando.

Ad esempio, considera il seguente file di test che necessita di un nome utente e una password. Di solito è una buona idea non memorizzare i tuoi segreti nel codice sorgente, quindi avremo bisogno di un modo per passare i segreti dall'esterno.

it(`example test`, async () => {
  // ...
  await $('#username').setValue(process.env.USERNAME)
  await $('#password').setValue(process.env.PASSWORD)
})

Puoi eseguire questo test con il tuo nome utente e password segreti impostati nella riga di comando.

Bash

USERNAME=me PASSWORD=secret npx wdio run wdio.conf.js

Powershell

$env:USERNAME=me
$env:PASSWORD=secret
npx wdio run wdio.conf.js

Batch

set USERNAME=me
set PASSWORD=secret
npx wdio run wdio.conf.js

Allo stesso modo, il file di configurazione può anche leggere le variabili d'ambiente passate tramite la riga di comando.

export const config = {
  // ...
  baseURL: process.env.STAGING === '1'
    ? 'http://staging.example.test/'
    : 'http://example.test/',
  // ...
}

Ora, puoi eseguire test su un ambiente di staging o di produzione:

Bash

STAGING=1 npx wdio run wdio.conf.js

Powershell

$env:STAGING=1
npx wdio run wdio.conf.js

Batch

set STAGING=1
npx wdio run wdio.conf.js

File .env

Per rendere più facile la gestione delle variabili d'ambiente, considera l'utilizzo di file .env. WebdriverIO carica automaticamente i file .env nel tuo ambiente. Invece di definire la variabile d'ambiente come parte della chiamata del comando, puoi definire il seguente .env:

.env

# .env file
STAGING=0
USERNAME=me
PASSWORD=secret

Esegui i test come al solito, le tue variabili d'ambiente dovrebbero essere rilevate.

npx wdio run wdio.conf.js

Creare test tramite un file CSV

Il test-runner di WebdriverIO viene eseguito in Node.js, questo significa che puoi leggere direttamente i file dal file system e analizzarli con la tua libreria CSV preferita.

Vedi ad esempio questo file CSV, nel nostro esempio input.csv:

"test_case","some_value","some_other_value"
"value 1","value 11","foobar1"
"value 2","value 22","foobar21"
"value 3","value 33","foobar321"
"value 4","value 44","foobar4321"

Basandoci su questo genereremo alcuni test utilizzando la libreria csv-parse da NPM:

import fs from 'node:fs'
import path from 'node:path'
import { parse } from 'csv-parse/sync'

const records = parse(fs.readFileSync(path.join(__dirname, 'input.csv')), {
  columns: true,
  skip_empty_lines: true
})

describe('my test suite', () => {
    for (const record of records) {
        it(`foo: ${record.test_case}`, async () => {
            console.log(record.test_case, record.some_value, record.some_other_value)
        })
    }
})