Zum Hauptinhalt springen

Multiremote

WebdriverIO ermöglicht es Ihnen, mehrere automatisierte Sitzungen in einem einzigen Test auszuführen. Dies ist praktisch, wenn Sie Funktionen testen, die mehrere Benutzer erfordern (zum Beispiel Chat- oder WebRTC-Anwendungen).

Anstatt mehrere Remote-Instanzen zu erstellen, bei denen Sie allgemeine Befehle wie newSession oder url für jede Instanz ausführen müssen, können Sie einfach eine multiremote-Instanz erstellen und alle Browser gleichzeitig steuern.

Verwenden Sie dazu einfach die Funktion multiremote() und übergeben Sie ein Objekt mit Namen, die als Schlüssel für capabilities als Werte dienen. Indem Sie jeder Capability einen Namen geben, können Sie diese einzelne Instanz leicht auswählen und darauf zugreifen, wenn Sie Befehle auf einer einzelnen Instanz ausführen.

Info

Multiremote ist nicht dafür gedacht, alle Ihre Tests parallel auszuführen. Es soll helfen, mehrere Browser und/oder mobile Geräte für spezielle Integrationstests (z.B. Chat-Anwendungen) zu koordinieren.

Alle Multiremote-Instanzen geben ein Array von Ergebnissen zurück. Das erste Ergebnis repräsentiert die zuerst definierte Capability im Capability-Objekt, das zweite Ergebnis die zweite Capability und so weiter.

Verwendung im Standalone-Modus​

Hier ist ein Beispiel, wie man eine Multiremote-Instanz im Standalone-Modus erstellt:

import { multiremote } from 'webdriverio'

(async () => {
    const browser = await multiremote({
        myChromeBrowser: {
            capabilities: {
                browserName: 'chrome'
            }
        },
        myFirefoxBrowser: {
            capabilities: {
                browserName: 'firefox'
            }
        }
    })

    // URL mit beiden Browsern gleichzeitig öffnen
    await browser.url('http://json.org')

    // Befehle gleichzeitig aufrufen
    const title = await browser.getTitle()
    expect(title).toEqual(['JSON', 'JSON'])

    // Auf ein Element gleichzeitig klicken
    const elem = await browser.$('#someElem')
    await elem.click()

    // Nur mit einem Browser klicken (Firefox)
    await elem.getInstance('myFirefoxBrowser').click()
})()

Verwendung mit dem WDIO Testrunner​

Um Multiremote im WDIO-Testrunner zu verwenden, definieren Sie einfach das capabilities-Objekt in Ihrer wdio.conf.js als Objekt mit den Browsernamen als Schlüssel (anstelle einer Liste von Capabilities):

export const config = {
    // ...
    capabilities: {
        myChromeBrowser: {
            capabilities: {
                browserName: 'chrome'
            }
        },
        myFirefoxBrowser: {
            capabilities: {
                browserName: 'firefox'
            }
        }
    }
    // ...
}

Dies erstellt zwei WebDriver-Sitzungen mit Chrome und Firefox. Anstelle von Chrome und Firefox können Sie auch zwei mobile Geräte mit Appium oder ein mobiles Gerät und einen Browser starten.

Sie können Multiremote auch parallel ausführen, indem Sie das Browser-Capabilities-Objekt in ein Array setzen. Bitte stellen Sie sicher, dass das Feld capabilities in jedem Browser enthalten ist, da wir so die verschiedenen Modi unterscheiden.

export const config = {
    // ...
    capabilities: [{
        myChromeBrowser0: {
            capabilities: {
                browserName: 'chrome'
            }
        },
        myFirefoxBrowser0: {
            capabilities: {
                browserName: 'firefox'
            }
        }
    }, {
        myChromeBrowser1: {
            capabilities: {
                browserName: 'chrome'
            }
        },
        myFirefoxBrowser1: {
            capabilities: {
                browserName: 'firefox'
            }
        }
    }]
    // ...
}

Sie können sogar einen der Cloud-Service-Backends zusammen mit lokalen Webdriver/Appium- oder Selenium-Standalone-Instanzen starten. WebdriverIO erkennt automatisch Cloud-Backend-Capabilities, wenn Sie entweder bstack:options (Browserstack), sauce:options (SauceLabs) oder tb:options (TestingBot) in den Browser-Capabilities angegeben haben.

export const config = {
    // ...
    user: process.env.BROWSERSTACK_USERNAME,
    key: process.env.BROWSERSTACK_ACCESS_KEY,
    capabilities: {
        myChromeBrowser: {
            capabilities: {
                browserName: 'chrome'
            }
        },
        myBrowserStackFirefoxBrowser: {
            capabilities: {
                browserName: 'firefox',
                'bstack:options': {
                    // ...
                }
            }
        }
    },
    services: [
        ['browserstack', 'selenium-standalone']
    ],
    // ...
}

Jede Art von Betriebssystem/Browser-Kombination ist hier möglich (einschließlich mobiler und Desktop-Browser). Alle Befehle, die Ihre Tests über die Variable browser aufrufen, werden parallel mit jeder Instanz ausgeführt. Dies hilft, Ihre Integrationstests zu optimieren und deren Ausführung zu beschleunigen.

Wenn Sie beispielsweise eine URL öffnen:

browser.url('https://socketio-chat-h9jt.herokuapp.com/')

Das Ergebnis jedes Befehls wird ein Objekt sein, mit den Browsernamen als Schlüssel und dem Befehlsergebnis als Wert, wie folgt:

// wdio testrunner Beispiel
await browser.url('https://www.whatismybrowser.com')

const elem = await $('.string-major')
const result = await elem.getText()

console.log(result[0]) // gibt zurück: 'Chrome 40 on Mac OS X (Yosemite)'
console.log(result[1]) // gibt zurück: 'Firefox 35 on Mac OS X (Yosemite)'

Beachten Sie, dass jeder Befehl nacheinander ausgeführt wird. Das bedeutet, dass der Befehl erst abgeschlossen ist, wenn alle Browser ihn ausgeführt haben. Dies ist hilfreich, da es die Browseraktionen synchronisiert, was das Verständnis des aktuellen Geschehens erleichtert.

Manchmal ist es notwendig, in jedem Browser unterschiedliche Dinge zu tun, um etwas zu testen. Wenn wir beispielsweise eine Chat-Anwendung testen wollen, muss ein Browser eine Textnachricht senden, während ein anderer Browser darauf wartet, sie zu empfangen, und dann eine Assertion darauf ausführt.

Bei Verwendung des WDIO-Testrunners werden die Browsernamen mit ihren Instanzen im globalen Bereich registriert:

const myChromeBrowser = browser.getInstance('myChromeBrowser')
await myChromeBrowser.$('#message').setValue('Hi, I am Chrome')
await myChromeBrowser.$('#send').click()

// warten bis Nachrichten ankommen
await $('.messages').waitForExist()
// prüfen, ob eine der Nachrichten die Chrome-Nachricht enthält
assert.true(
    (
        await $$('.messages').map((m) => m.getText())
    ).includes('Hi, I am Chrome')
)

In diesem Beispiel beginnt die Instanz myFirefoxBrowser auf eine Nachricht zu warten, sobald die Instanz myChromeBrowser auf die Schaltfläche #send geklickt hat.

Multiremote macht es einfach und bequem, mehrere Browser zu steuern, egal ob Sie möchten, dass sie dasselbe parallel tun oder verschiedene Dinge im Zusammenspiel.

Zugriff auf Browser-Instanzen über Strings über das Browser-Objekt​

Zusätzlich zum Zugriff auf die Browser-Instanz über ihre globalen Variablen (z.B. myChromeBrowser, myFirefoxBrowser) können Sie auch über das browser-Objekt darauf zugreifen, z.B. browser["myChromeBrowser"] oder browser["myFirefoxBrowser"]. Sie können eine Liste aller Ihrer Instanzen über browser.instances erhalten. Dies ist besonders nützlich, wenn Sie wiederverwendbare Testschritte schreiben, die in beiden Browsern ausgeführt werden können, z.B.:

wdio.conf.js:

    capabilities: {
        userA: {
            capabilities: {
                browserName: 'chrome'
            }
        },
        userB: {
            capabilities: {
                browserName: 'chrome'
            }
        }
    }

Cucumber-Datei:

When User A types a message into the chat

Step-Definition-Datei:

When(/^User (.) types a message into the chat/, async (userId) => {
    await browser.getInstance(`user${userId}`).$('#message').setValue('Hi, I am Chrome')
    await browser.getInstance(`user${userId}`).$('#send').click()
})

Erweiterung der TypeScript-Typen​

Wenn Sie TypeScript verwenden und direkt auf die Treiberinstanz vom Multiremote-Objekt zugreifen möchten, können Sie auch die Multiremote-Typen entsprechend erweitern. Zum Beispiel, bei folgenden Capabilities:

export const config: WebdriverIO.MultiremoteConfig = {
    // ...
    capabilities: {
        myAppiumDriver: {
            // ...
        },
        myChromeDriver: {
            // ...
        }
    }
    // ...
}

Sie können die Multiremote-Instanz erweitern, indem Sie Ihre benutzerdefinierten Treibernamen hinzufügen, z.B.:

declare namespace WebdriverIO {
    interface MultiRemoteBrowser {
        myAppiumDriver: WebdriverIO.Browser
        myChromeDriver: WebdriverIO.Browser
    }
}

Jetzt können Sie direkt auf die Treiber zugreifen, z.B.:

multiremotebrowser.myAppiumDriver.$$(...)
multiremotebrowser.myChromeDriver.$(...)

Welcome! How can I help?

WebdriverIO AI Copilot