Tests parametrisieren

Sie können Tests auf Testebene einfach parametrisieren, z.B. über einfache for-Schleifen:

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

oder durch Extrahieren von Tests in dynamische Funktionen, z.B.:

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' })
})

Übergeben von Umgebungsvariablen

Sie können Umgebungsvariablen verwenden, um Tests über die Befehlszeile zu konfigurieren.

Betrachten Sie zum Beispiel die folgende Testdatei, die einen Benutzernamen und ein Passwort benötigt. Es ist in der Regel eine gute Idee, Ihre Geheimnisse nicht im Quellcode zu speichern, daher benötigen wir eine Möglichkeit, Geheimnisse von außen zu übergeben.

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

Sie können diesen Test mit Ihrem geheimen Benutzernamen und Passwort ausführen, die in der Befehlszeile festgelegt sind.

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

Ebenso kann die Konfigurationsdatei auch Umgebungsvariablen lesen, die über die Befehlszeile übergeben werden.

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

Jetzt können Sie Tests gegen eine Staging- oder Produktionsumgebung ausführen:

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

.env-Dateien

Um Umgebungsvariablen einfacher zu verwalten, sollten Sie .env-Dateien in Betracht ziehen. WebdriverIO lädt .env-Dateien automatisch in Ihre Umgebung. Anstatt die Umgebungsvariable als Teil des Befehlsaufrufs zu definieren, können Sie die folgende .env definieren:

.env

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

Führen Sie Tests wie gewohnt aus, Ihre Umgebungsvariablen sollten erkannt werden.

npx wdio run wdio.conf.js

Tests über eine CSV-Datei erstellen

Der WebdriverIO-Testrunner läuft in Node.js, das bedeutet, Sie können Dateien direkt aus dem Dateisystem lesen und mit Ihrer bevorzugten CSV-Bibliothek parsen.

Sehen Sie zum Beispiel diese CSV-Datei, in unserem Beispiel 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"

Darauf basierend generieren wir einige Tests mit der csv-parse-Bibliothek von 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)
        })
    }
})