Zum Hauptinhalt springen

Konfiguration

Basierend auf dem Setup-Typ (z. B. bei Verwendung der reinen Protokollbindungen, WebdriverIO als eigenständiges Paket oder dem WDIO Testrunner) gibt es verschiedene Optionen, um die Umgebung zu steuern.

WebDriver-Optionen​

Die folgenden Optionen sind definiert, wenn das webdriver-Protokollpaket verwendet wird:

protocol​

Protokoll für die Kommunikation mit dem Treiber-Server.

Typ: String
Standard: http

hostname​

Host Ihres Treiber-Servers.

Typ: String
Standard: 0.0.0.0

port​

Port, auf dem Ihr Treiber-Server läuft.

Typ: Number
Standard: undefined

path​

Pfad zum Treiber-Server-Endpunkt.

Typ: String
Standard: /

queryParams​

Abfrageparameter, die an den Treiber-Server weitergeleitet werden.

Typ: Object
Standard: undefined

user​

Ihr Cloud-Service-Benutzername (funktioniert nur für Sauce Labs, Browserstack, TestingBot oder LambdaTest Konten). Wenn gesetzt, konfiguriert WebdriverIO automatisch die Verbindungsoptionen für Sie. Wenn Sie keinen Cloud-Anbieter verwenden, kann dies zur Authentifizierung eines anderen WebDriver-Backends verwendet werden.

Typ: String
Standard: undefined

key​

Ihr Cloud-Service-Zugriffsschlüssel oder geheimer Schlüssel (funktioniert nur für Sauce Labs, Browserstack, TestingBot oder LambdaTest Konten). Wenn gesetzt, konfiguriert WebdriverIO automatisch die Verbindungsoptionen für Sie. Wenn Sie keinen Cloud-Anbieter verwenden, kann dies zur Authentifizierung eines anderen WebDriver-Backends verwendet werden.

Typ: String
Standard: undefined

capabilities​

Definiert die Funktionen, die Sie in Ihrer WebDriver-Sitzung ausführen möchten. Weitere Details finden Sie im WebDriver-Protokoll. Wenn Sie einen älteren Treiber verwenden, der das WebDriver-Protokoll nicht unterstützt, müssen Sie die JSONWireProtocol-Funktionen verwenden, um eine Sitzung erfolgreich auszuführen.

Neben den WebDriver-basierten Funktionen können Sie browser- und anbieterspezifische Optionen anwenden, die eine tiefere Konfiguration des Remote-Browsers oder Geräts ermöglichen. Diese sind in den entsprechenden Anbieter-Dokumentationen dokumentiert, z. B.:

Zusätzlich ist ein nützliches Tool der Automated Test Configurator von Sauce Labs, der Ihnen hilft, dieses Objekt zu erstellen, indem Sie Ihre gewünschten Funktionen zusammenklicken.

Typ: Object
Standard: null

Beispiel:

{
    browserName: 'chrome', // Optionen: `chrome`, `edge`, `firefox`, `safari`
    browserVersion: '27.0', // Browser-Version
    platformName: 'Windows 10' // OS-Plattform
}

Wenn Sie Web- oder native Tests auf mobilen Geräten ausführen, unterscheiden sich die capabilities vom WebDriver-Protokoll. Weitere Details finden Sie in der Appium-Dokumentation.

logLevel​

Stufe der Protokollierungsausführlichkeit.

Typ: String
Standard: info
Optionen: trace | debug | info | warn | error | silent

outputDir​

Verzeichnis zum Speichern aller Testrunner-Protokolldateien (einschließlich Reporter-Protokolle und wdio-Protokolle). Wenn nicht festgelegt, werden alle Protokolle an stdout gestreamt. Da die meisten Reporter für die Ausgabe nach stdout konzipiert sind, wird empfohlen, diese Option nur für bestimmte Reporter zu verwenden, bei denen es sinnvoller ist, Berichte in eine Datei zu schreiben (wie z. B. beim junit-Reporter).

Im Standalone-Modus ist das einzige von WebdriverIO generierte Protokoll das wdio-Protokoll.

Typ: String
Standard: null

connectionRetryTimeout​

Timeout für jede WebDriver-Anfrage an einen Treiber oder Grid.

Typ: Number
Standard: 120000

connectionRetryCount​

Maximale Anzahl von Wiederholungsversuchen für Anfragen an den Selenium-Server.

Typ: Number
Standard: 3

agent​

Ermöglicht die Verwendung eines benutzerdefinierten http/https/http2 Agents für Anfragen.

Typ: Object
Standard:

{
    http: new http.Agent({ keepAlive: true }),
    https: new https.Agent({ keepAlive: true })
}

headers​

Geben Sie benutzerdefinierte headers an, die in jede WebDriver-Anfrage übergeben werden sollen. Wenn Ihr Selenium-Grid eine Basic-Authentifizierung erfordert, empfehlen wir, einen Authorization-Header über diese Option zu übergeben, um Ihre WebDriver-Anfragen zu authentifizieren, z.B.:

import { Buffer } from 'buffer';
// Read the username and password from environment variables
const username = process.env.SELENIUM_GRID_USERNAME;
const password = process.env.SELENIUM_GRID_PASSWORD;

// Combine the username and password with a colon separator
const credentials = `${username}:${password}`;
// Encode the credentials using Base64
const encodedCredentials = Buffer.from(credentials).toString('base64');

export const config: WebdriverIO.Config = {
    // ...
    headers: {
        Authorization: `Basic ${encodedCredentials}`
    }
    // ...
}

Typ: Object
Standard: {}

transformRequest​

Funktion, die HTTP-Anforderungsoptionen abfängt, bevor eine WebDriver-Anfrage gestellt wird

Typ: (RequestOptions) => RequestOptions
Standard: keine

transformResponse​

Funktion, die HTTP-Antwortobjekte abfängt, nachdem eine WebDriver-Antwort eingetroffen ist. Der Funktion wird das ursprüngliche Antwortobjekt als erstes und die entsprechenden RequestOptions als zweites Argument übergeben.

Typ: (Response, RequestOptions) => Response
Standard: keine

strictSSL​

Ob es kein gültiges SSL-Zertifikat erfordert. Es kann über Umgebungsvariablen wie STRICT_SSL oder strict_ssl festgelegt werden.

Typ: Boolean
Standard: true

enableDirectConnect​

Ob die Appium-Direktverbindungsfunktion aktiviert werden soll. Es tut nichts, wenn die Antwort keine entsprechenden Schlüssel hatte, während das Flag aktiviert ist.

Typ: Boolean
Standard: true

cacheDir​

Der Pfad zum Stammverzeichnis des Cache-Verzeichnisses. Dieses Verzeichnis wird verwendet, um alle Treiber zu speichern, die heruntergeladen werden, wenn versucht wird, eine Sitzung zu starten.

Typ: String
Standard: process.env.WEBDRIVER_CACHE_DIR || os.tmpdir()

maskingPatterns​

Für eine sicherere Protokollierung können mit maskingPatterns festgelegte reguläre Ausdrücke sensible Informationen aus dem Protokoll verschleiern.

Typ: String
Standard: undefined

Beispiel:

{
    maskingPatterns: '/--key=([^ ]*)/i,/RESULT (.*)/'
}

WebdriverIO​

Die folgenden Optionen (einschließlich der oben aufgeführten) können mit WebdriverIO im Standalone-Modus verwendet werden:

automationProtocol​

Definieren Sie das Protokoll, das Sie für Ihre Browser-Automatisierung verwenden möchten. Derzeit wird nur webdriver unterstützt, da es die Hauptbrowser-Automatisierungstechnologie ist, die WebdriverIO verwendet.

Wenn Sie den Browser mit einer anderen Automatisierungstechnologie steuern möchten, stellen Sie sicher, dass Sie diese Eigenschaft auf einen Pfad setzen, der zu einem Modul führt, das der folgenden Schnittstelle entspricht:

import type { Capabilities } from '@wdio/types';
import type { Client, AttachOptions } from 'webdriver';

export default class YourAutomationLibrary {
    /**
     * Start a automation session and return a WebdriverIO [monad](https://github.com/webdriverio/webdriverio/blob/940cd30939864bdbdacb2e94ee6e8ada9b1cc74c/packages/wdio-utils/src/monad.ts)
     * with respective automation commands. See the [webdriver](https://www.npmjs.com/package/webdriver) package
     * as a reference implementation
     *
     * @param {Capabilities.RemoteConfig} options WebdriverIO options
     * @param {Function} hook that allows to modify the client before it gets released from the function
     * @param {PropertyDescriptorMap} userPrototype allows user to add custom protocol commands
     * @param {Function} customCommandWrapper allows to modify the command execution
     * @returns a WebdriverIO compatible client instance
     */
    static newSession(
        options: Capabilities.RemoteConfig,
        modifier?: (...args: any[]) => any,
        userPrototype?: PropertyDescriptorMap,
        customCommandWrapper?: (...args: any[]) => any
    ): Promise<Client>;

    /**
     * allows user to attach to existing sessions
     * @optional
     */
    static attachToSession(
        options?: AttachOptions,
        modifier?: (...args: any[]) => any, userPrototype?: {},
        commandWrapper?: (...args: any[]) => any
    ): Client;

    /**
     * Changes The instance session id and browser capabilities for the new session
     * directly into the passed in browser object
     *
     * @optional
     * @param   {object} instance  the object we get from a new browser session.
     * @returns {string}           the new session id of the browser
     */
    static reloadSession(
        instance: Client,
        newCapabilities?: WebdriverIO.Capabilitie
    ): Promise<string>;
}

Typ: String
Standard: webdriver

baseUrl​

Verkürzen Sie url-Befehlsaufrufe, indem Sie eine Basis-URL festlegen.

  • Wenn Ihr url-Parameter mit / beginnt, wird baseUrl vorangestellt (mit Ausnahme des baseUrl-Pfades, falls vorhanden).
  • Wenn Ihr url-Parameter ohne Schema oder / beginnt (wie some/path), wird die vollständige baseUrl direkt vorangestellt.

Typ: String
Standard: null

waitforTimeout​

Standardzeitlimit für alle waitFor*-Befehle. (Beachten Sie das Kleinbuchstaben f im Optionsnamen.) Dieses Zeitlimit betrifft nur Befehle, die mit waitFor* beginnen, und ihre Standardwartezeit.

Um das Zeitlimit für einen Test zu erhöhen, beachten Sie bitte die Framework-Dokumentation.

Typ: Number
Standard: 5000

waitforInterval​

Standardintervall für alle waitFor*-Befehle, um zu überprüfen, ob ein erwarteter Zustand (z. B. Sichtbarkeit) geändert wurde.

Typ: Number
Standard: 100

region​

Bei der Ausführung auf Sauce Labs können Sie wählen, Tests zwischen verschiedenen Rechenzentren auszuführen: US oder EU. Um Ihre Region auf EU zu ändern, fügen Sie region: 'eu' zu Ihrer Konfiguration hinzu.

Hinweis: Dies wirkt sich nur aus, wenn Sie user und key-Optionen angeben, die mit Ihrem Sauce Labs-Konto verbunden sind.

Typ: String
Standard: us

(nur für VMs und/oder Emulatoren/Simulatoren)

Testrunner-Optionen​

Die folgenden Optionen (einschließlich der oben aufgeführten) sind nur für die Ausführung von WebdriverIO mit dem WDIO-Testrunner definiert:

specs​

Definieren Sie Specs für die Testausführung. Sie können entweder ein Glob-Muster angeben, um mehrere Dateien auf einmal abzugleichen, oder ein Glob oder eine Reihe von Pfaden in ein Array einschließen, um sie innerhalb eines einzelnen Arbeitsprozesses auszuführen. Alle Pfade werden relativ zum Konfigurationsdateipfad betrachtet.

Typ: (String | String[])[]
Standard: []

exclude​

Schließen Sie Specs von der Testausführung aus. Alle Pfade werden relativ zum Konfigurationsdateipfad betrachtet.

Typ: String[]
Standard: []

suites​

Ein Objekt, das verschiedene Suiten beschreibt, die Sie dann mit der Option --suite auf der wdio-CLI angeben können.

Typ: Object
Standard: {}

capabilities​

Gleich wie der oben beschriebene Abschnitt capabilities, mit der Option, entweder ein multiremote-Objekt anzugeben oder mehrere WebDriver-Sitzungen in einem Array für die parallele Ausführung.

Sie können die gleichen anbieter- und browserspezifischen Funktionen wie oben definiert anwenden.

Typ: Object|Object[]
Standard: [{ 'wdio:maxInstances': 5, browserName: 'firefox' }]

maxInstances​

Maximale Anzahl der insgesamt parallel laufenden Worker.

Hinweis: Diese Zahl kann bis zu 100 betragen, wenn die Tests auf externen Anbietern wie Sauce Labs' Maschinen durchgeführt werden. Dort werden die Tests nicht auf einer einzigen Maschine getestet, sondern auf mehreren VMs. Wenn die Tests auf einem lokalen Entwicklungsrechner ausgeführt werden sollen, verwenden Sie eine angemessenere Zahl wie 3, 4 oder 5. Im Wesentlichen ist dies die Anzahl der Browser, die gleichzeitig gestartet werden und Ihre Tests gleichzeitig ausführen, daher hängt es davon ab, wie viel RAM auf Ihrem Computer verfügbar ist und wie viele andere Anwendungen auf Ihrem Computer laufen.

Sie können auch maxInstances innerhalb Ihrer Capability-Objekte mit der wdio:maxInstances-Capability anwenden. Dies begrenzt die Anzahl der parallelen Sitzungen für diese spezifische Capability.

Typ: Number
Standard: 100

maxInstancesPerCapability​

Maximale Anzahl der insgesamt parallel laufenden Worker pro Capability.

Typ: Number
Standard: 100

injectGlobals​

Fügt WebdriverIOs Globals (z.B. browser, $ und $$) in die globale Umgebung ein. Wenn Sie auf false setzen, sollten Sie aus @wdio/globals importieren, z.B.:

import { browser, $, $$, expect } from '@wdio/globals'

Hinweis: WebdriverIO behandelt nicht die Injektion von testframework-spezifischen Globals.

Typ: Boolean
Standard: true

bail​

Wenn Sie möchten, dass Ihr Testlauf nach einer bestimmten Anzahl von Testfehlern stoppt, verwenden Sie bail. (Standardmäßig ist es 0, was bedeutet, dass alle Tests unabhängig vom Ergebnis ausgeführt werden.) Hinweis: Ein Test in diesem Zusammenhang sind alle Tests innerhalb einer einzelnen Spec-Datei (bei Verwendung von Mocha oder Jasmine) oder alle Schritte innerhalb einer Feature-Datei (bei Verwendung von Cucumber). Wenn Sie das Bail-Verhalten innerhalb von Tests einer einzelnen Testdatei steuern möchten, schauen Sie sich die verfügbaren Framework-Optionen an.

Typ: Number
Standard: 0 (kein Bail; alle Tests ausführen)

specFileRetries​

Die Anzahl der Versuche, eine gesamte Spec-Datei zu wiederholen, wenn sie als Ganzes fehlschlägt.

Typ: Number
Standard: 0

specFileRetriesDelay​

Verzögerung in Sekunden zwischen den Spec-Datei-Wiederholungsversuchen

Typ: Number
Standard: 0

specFileRetriesDeferred​

Ob wiederholte Spec-Dateien sofort wiederholt werden sollen oder ans Ende der Warteschlange verschoben werden sollen.

Typ: Boolean
Standard: true

groupLogsByTestSpec​

Wählen Sie die Protokollausgabeansicht.

Wenn auf false gesetzt, werden Protokolle aus verschiedenen Testdateien in Echtzeit ausgegeben. Bitte beachten Sie, dass dies bei paralleler Ausführung zur Vermischung von Protokollausgaben aus verschiedenen Dateien führen kann.

Wenn auf true gesetzt, werden Protokollausgaben nach Test-Spec gruppiert und erst ausgegeben, wenn die Test-Spec abgeschlossen ist.

Standardmäßig ist es auf false gesetzt, sodass Protokolle in Echtzeit ausgegeben werden.

Typ: Boolean
Standard: false

autoAssertOnTestEnd​

Steuert, ob WebdriverIO am Ende jedes Tests automatisch alle Soft-Assertions überprüft. Wenn auf true gesetzt, werden alle gesammelten Soft-Assertions automatisch überprüft und der Test schlägt fehl, falls Assertions fehlgeschlagen sind. Bei false müssen Sie die Assert-Methode manuell aufrufen, um Soft-Assertions zu überprüfen.

Typ: Boolean
Standard: true

services​

Services übernehmen eine bestimmte Aufgabe, um die Sie sich nicht kümmern möchten. Sie erweitern Ihr Test-Setup mit fast keinem Aufwand.

Typ: String[]|Object[]
Standard: []

framework​

Definiert das zu verwendende Test-Framework für den WDIO-Testrunner.

Typ: String
Standard: mocha
Optionen: mocha | jasmine

mochaOpts, jasmineOpts und cucumberOpts​

Spezifische Framework-bezogene Optionen. In der Framework-Adapter-Dokumentation finden Sie Informationen zu den verfügbaren Optionen. Lesen Sie mehr dazu in Frameworks.

Typ: Object
Standard: { timeout: 10000 }

cucumberFeaturesWithLineNumbers​

Liste von Cucumber-Features mit Zeilennummern (bei Verwendung des Cucumber-Frameworks).

Typ: String[] Standard: []

reporters​

Liste der zu verwendenden Reporter. Ein Reporter kann entweder ein String oder ein Array von ['reporterName', { /* reporter options */}] sein, wobei das erste Element ein String mit dem Reporter-Namen und das zweite Element ein Objekt mit Reporter-Optionen ist.

Typ: String[]|Object[]
Standard: []

Beispiel:

reporters: [
    'dot',
    'spec'
    ['junit', {
        outputDir: `${__dirname}/reports`,
        otherOption: 'foobar'
    }]
]

reporterSyncInterval​

Bestimmt, in welchem Intervall der Reporter überprüfen soll, ob sie synchronisiert sind, wenn sie ihre Protokolle asynchron melden (z. B. wenn Protokolle an einen Drittanbieter gestreamt werden).

Typ: Number
Standard: 100 (ms)

reporterSyncTimeout​

Bestimmt die maximale Zeit, die Reporter haben, um das Hochladen aller ihrer Protokolle abzuschließen, bevor ein Fehler vom Testrunner geworfen wird.

Typ: Number
Standard: 5000 (ms)

execArgv​

Node-Argumente, die beim Starten von Kindprozessen angegeben werden sollen.

Typ: String[]
Standard: null

filesToWatch​

Eine Liste von Glob-unterstützenden String-Mustern, die dem Testrunner mitteilen, dass er zusätzlich andere Dateien überwachen soll, z. B. Anwendungsdateien, wenn er mit dem Flag --watch ausgeführt wird. Standardmäßig überwacht der Testrunner bereits alle Spec-Dateien.

Typ: String[]
Standard: []

updateSnapshots​

Setzen Sie auf true, wenn Sie Ihre Snapshots aktualisieren möchten. Idealerweise als Teil eines CLI-Parameters verwendet, z.B. wdio run wdio.conf.js --s.

Typ: 'new' | 'all' | 'none'
Standard: none, wenn nicht angegeben und Tests in CI laufen, new, wenn nicht angegeben, andernfalls was angegeben wurde

resolveSnapshotPath​

Überschreibt den Standard-Snapshot-Pfad. Zum Beispiel, um Snapshots neben Testdateien zu speichern.

wdio.conf.ts
export const config: WebdriverIO.Config = {
    resolveSnapshotPath: (testPath, snapExtension) => testPath + snapExtension,
}

Typ: (testPath: string, snapExtension: string) => string
Standard: speichert Snapshot-Dateien im Verzeichnis __snapshots__ neben der Testdatei

tsConfigPath​

WDIO verwendet tsx zum Kompilieren von TypeScript-Dateien. Ihre TSConfig wird automatisch aus dem aktuellen Arbeitsverzeichnis erkannt, aber Sie können hier einen benutzerdefinierten Pfad angeben oder die Umgebungsvariable TSX_TSCONFIG_PATH setzen.

Siehe die tsx-Dokumentation: https://tsx.is/dev-api/node-cli#custom-tsconfig-json-path

Typ: String
Standard: null

Hooks​

Der WDIO-Testrunner ermöglicht es Ihnen, Hooks zu setzen, die zu bestimmten Zeitpunkten im Testlebenszyklus ausgelöst werden. Dies ermöglicht benutzerdefinierte Aktionen (z. B. Screenshot aufnehmen, wenn ein Test fehlschlägt).

Jeder Hook hat als Parameter spezifische Informationen über den Lebenszyklus (z. B. Informationen über die Testsuite oder den Test). Lesen Sie mehr über alle Hook-Eigenschaften in unserer Beispielkonfiguration.

Hinweis: Einige Hooks (onPrepare, onWorkerStart, onWorkerEnd und onComplete) werden in einem anderen Prozess ausgeführt und können daher keine globalen Daten mit den anderen Hooks teilen, die im Worker-Prozess leben.

onPrepare​

Wird einmal ausgeführt, bevor alle Worker gestartet werden.

Parameter:

  • config (object): WebdriverIO-Konfigurationsobjekt
  • param (object[]): Liste der Capabilities-Details

onWorkerStart​

Wird ausgeführt, bevor ein Worker-Prozess gestartet wird, und kann verwendet werden, um bestimmte Services für diesen Worker zu initialisieren sowie Laufzeitumgebungen asynchron zu modifizieren.

Parameter:

  • cid (string): Capability-ID (z.B. 0-0)
  • caps (object): enthält Capabilities für die Sitzung, die im Worker gestartet wird
  • specs (string[]): Specs, die im Worker-Prozess ausgeführt werden sollen
  • args (object): Objekt, das mit der Hauptkonfiguration zusammengeführt wird, sobald der Worker initialisiert ist
  • execArgv (string[]): Liste von String-Argumenten, die an den Worker-Prozess übergeben werden

onWorkerEnd​

Wird ausgeführt, kurz nachdem ein Worker-Prozess beendet wurde.

Parameter:

  • cid (string): Capability-ID (z.B. 0-0)
  • exitCode (number): 0 - Erfolg, 1 - Fehler
  • specs (string[]): Specs, die im Worker-Prozess ausgeführt wurden
  • retries (number): Anzahl der verwendeten Spec-Level-Wiederholungen, wie in "Wiederholungen auf Spec-Datei-Basis hinzufügen" definiert

beforeSession​

Wird kurz vor der Initialisierung der WebDriver-Sitzung und des Test-Frameworks ausgeführt. Ermöglicht die Manipulation von Konfigurationen je nach Capability oder Spec.

Parameter:

  • config (object): WebdriverIO-Konfigurationsobjekt
  • caps (object): enthält Capabilities für die Sitzung, die im Worker gestartet wird
  • specs (string[]): Specs, die im Worker-Prozess ausgeführt werden sollen

before​

Wird vor Beginn der Testausführung ausgeführt. Zu diesem Zeitpunkt können Sie auf alle globalen Variablen wie browser zugreifen. Es ist der perfekte Ort, um benutzerdefinierte Befehle zu definieren.

Parameter:

  • caps (object): enthält Capabilities für die Sitzung, die im Worker gestartet wird
  • specs (string[]): Specs, die im Worker-Prozess ausgeführt werden sollen
  • browser (object): Instanz der erstellten Browser-/Gerätesitzung

beforeSuite​

Hook, der ausgeführt wird, bevor die Suite startet (nur in Mocha/Jasmine)

Parameter:

  • suite (object): Suite-Details

beforeHook​

Hook, der vor einem Hook innerhalb der Suite ausgeführt wird (wird z.B. vor dem Aufruf von beforeEach in Mocha ausgeführt)

Parameter:

  • test (object): Test-Details
  • context (object): Testkontext (repräsentiert das World-Objekt in Cucumber)

afterHook​

Hook, der nach einem Hook innerhalb der Suite ausgeführt wird (wird z.B. nach dem Aufruf von afterEach in Mocha ausgeführt)

Parameter:

  • test (object): Test-Details
  • context (object): Testkontext (repräsentiert das World-Objekt in Cucumber)
  • result (object): Hook-Ergebnis (enthält die Eigenschaften error, result, duration, passed, retries)

beforeTest​

Funktion, die vor einem Test ausgeführt wird (nur in Mocha/Jasmine).

Parameter:

  • test (object): Test-Details
  • context (object): Scope-Objekt, mit dem der Test ausgeführt wurde

beforeCommand​

Wird ausgeführt, bevor ein WebdriverIO-Befehl ausgeführt wird.

Parameter:

  • commandName (string): Befehlsname
  • args (*): Argumente, die der Befehl erhalten würde

afterCommand​

Wird ausgeführt, nachdem ein WebdriverIO-Befehl ausgeführt wurde.

Parameter:

  • commandName (string): Befehlsname
  • args (*): Argumente, die der Befehl erhalten würde
  • result (*): Ergebnis des Befehls
  • error (Error): Fehlerobjekt, falls vorhanden

afterTest​

Funktion, die nach dem Ende eines Tests (in Mocha/Jasmine) ausgeführt wird.

Parameter:

  • test (object): Test-Details
  • context (object): Scope-Objekt, mit dem der Test ausgeführt wurde
  • result.error (Error): Fehlerobjekt, falls der Test fehlschlägt, sonst undefined
  • result.result (Any): Rückgabeobjekt der Testfunktion
  • result.duration (Number): Dauer des Tests
  • result.passed (Boolean): true, wenn der Test bestanden wurde, sonst false
  • result.retries (Object): Informationen über einzelne testbezogene Wiederholungen wie für Mocha und Jasmine sowie Cucumber definiert, z.B. { attempts: 0, limit: 0 }, siehe
  • result (object): Hook-Ergebnis (enthält die Eigenschaften error, result, duration, passed, retries)

afterSuite​

Hook, der ausgeführt wird, nachdem die Suite beendet wurde (nur in Mocha/Jasmine)

Parameter:

  • suite (object): Suite-Details

after​

Wird ausgeführt, nachdem alle Tests abgeschlossen sind. Sie haben immer noch Zugriff auf alle globalen Variablen des Tests.

Parameter:

  • result (number): 0 - Test bestanden, 1 - Test fehlgeschlagen
  • caps (object): enthält Capabilities für die Sitzung, die im Worker gestartet wird
  • specs (string[]): Specs, die im Worker-Prozess ausgeführt werden sollen

afterSession​

Wird direkt nach Beendigung der WebDriver-Sitzung ausgeführt.

Parameter:

  • config (object): WebdriverIO-Konfigurationsobjekt
  • caps (object): enthält Capabilities für die Sitzung, die im Worker gestartet wird
  • specs (string[]): Specs, die im Worker-Prozess ausgeführt werden sollen

onComplete​

Wird ausgeführt, nachdem alle Worker heruntergefahren wurden und der Prozess kurz vor dem Beenden steht. Ein Fehler, der im onComplete-Hook geworfen wird, führt dazu, dass der Testlauf fehlschlägt.

Parameter:

  • exitCode (number): 0 - Erfolg, 1 - Fehler
  • config (object): WebdriverIO-Konfigurationsobjekt
  • caps (object): enthält Capabilities für die Sitzung, die im Worker gestartet wird
  • result (object): Ergebnisobjekt mit Testergebnissen

onReload​

Wird ausgeführt, wenn eine Aktualisierung stattfindet.

Parameter:

  • oldSessionId (string): Sitzungs-ID der alten Sitzung
  • newSessionId (string): Sitzungs-ID der neuen Sitzung

beforeFeature​

Wird vor einer Cucumber-Feature ausgeführt.

Parameter:

afterFeature​

Wird nach einer Cucumber-Feature ausgeführt.

Parameter:

beforeScenario​

Wird vor einem Cucumber-Szenario ausgeführt.

Parameter:

  • world (ITestCaseHookParameter): World-Objekt, das Informationen zu Pickle und Testschritt enthält
  • context (object): Cucumber-World-Objekt

afterScenario​

Wird nach einem Cucumber-Szenario ausgeführt.

Parameter:

  • world (ITestCaseHookParameter): World-Objekt, das Informationen zu Pickle und Testschritt enthält
  • result (object): Ergebnisobjekt mit Szenario-Ergebnissen
  • result.passed (boolean): true, wenn das Szenario bestanden wurde
  • result.error (string): Fehler-Stack, wenn das Szenario fehlgeschlagen ist
  • result.duration (number): Dauer des Szenarios in Millisekunden
  • context (object): Cucumber-World-Objekt

beforeStep​

Wird vor einem Cucumber-Schritt ausgeführt.

Parameter:

  • step (Pickle.IPickleStep): Cucumber-Schritt-Objekt
  • scenario (IPickle): Cucumber-Szenario-Objekt
  • context (object): Cucumber-World-Objekt

afterStep​

Wird nach einem Cucumber-Schritt ausgeführt.

Parameter:

  • step (Pickle.IPickleStep): Cucumber-Schritt-Objekt
  • scenario (IPickle): Cucumber-Szenario-Objekt
  • result: (object): Ergebnisobjekt mit Schritt-Ergebnissen
  • result.passed (boolean): true, wenn das Szenario bestanden wurde
  • result.error (string): Fehler-Stack, wenn das Szenario fehlgeschlagen ist
  • result.duration (number): Dauer des Szenarios in Millisekunden
  • context (object): Cucumber-World-Objekt

beforeAssertion​

Hook, der ausgeführt wird, bevor eine WebdriverIO-Assertion durchgeführt wird.

Parameter:

  • params: Assertions-Informationen
  • params.matcherName (string): Name des Matchers (z.B. toHaveTitle)
  • params.expectedValue: Wert, der in den Matcher übergeben wird
  • params.options: Assertions-Optionen

afterAssertion​

Hook, der ausgeführt wird, nachdem eine WebdriverIO-Assertion durchgeführt wurde.

Parameter:

  • params: Assertions-Informationen
  • params.matcherName (string): Name des Matchers (z.B. toHaveTitle)
  • params.expectedValue: Wert, der in den Matcher übergeben wird
  • params.options: Assertions-Optionen
  • params.result: Assertions-Ergebnisse

Welcome! How can I help?

WebdriverIO AI Copilot