Proxy-Einrichtung

Sie können zwei verschiedene Arten von Anfragen durch einen Proxy tunneln:

• Verbindung zwischen Ihrem Test-Skript und dem Browser-Treiber (oder WebDriver-Endpunkt)
• Verbindung zwischen dem Browser und dem Internet

Proxy zwischen Treiber und Test

Wenn Ihr Unternehmen einen Unternehmens-Proxy (z.B. auf http://my.corp.proxy.com:9090) für alle ausgehenden Anfragen hat, haben Sie zwei Möglichkeiten, WebdriverIO für die Verwendung des Proxys zu konfigurieren:

Option 1: Verwendung von Umgebungsvariablen (Empfohlen)

Ab WebdriverIO v9.12.0 können Sie einfach die Standard-Proxy-Umgebungsvariablen setzen:

export HTTP_PROXY=http://my.corp.proxy.com:9090
export HTTPS_PROXY=http://my.corp.proxy.com:9090
# Optional: Proxy für bestimmte Hosts umgehen
export NO_PROXY=localhost,127.0.0.1,.internal.domain

Führen Sie dann Ihre Tests wie gewohnt aus. WebdriverIO wird diese Umgebungsvariablen automatisch für die Proxy-Konfiguration verwenden.

Option 2: Verwendung von undici's setGlobalDispatcher

Für fortgeschrittenere Proxy-Konfigurationen oder wenn Sie programmatische Kontrolle benötigen, können Sie die setGlobalDispatcher-Methode von undici verwenden:

Installieren Sie undici

npm

npm install undici --save-dev

Yarn

yarn add undici --dev

pnpm

pnpm add undici --save-dev

Bun

bun add undici --dev

Fügen Sie undici setGlobalDispatcher zu Ihrer Konfigurationsdatei hinzu

Fügen Sie die folgende Require-Anweisung am Anfang Ihrer Konfigurationsdatei hinzu.

wdio.conf.js

import { setGlobalDispatcher, ProxyAgent } from 'undici';

const dispatcher = new ProxyAgent({ uri: new URL(process.env.https_proxy || 'http://my.corp.proxy.com:9090').toString() });
setGlobalDispatcher(dispatcher);

export const config = {
    // ...
}

Zusätzliche Informationen zur Konfiguration des Proxys finden Sie hier.

Welche Methode sollte ich verwenden?

• Verwenden Sie Umgebungsvariablen, wenn Sie einen einfachen, standardmäßigen Ansatz wünschen, der mit verschiedenen Tools funktioniert und keine Codeänderungen erfordert.
• Verwenden Sie setGlobalDispatcher, wenn Sie erweiterte Proxy-Funktionen wie benutzerdefinierte Authentifizierung, verschiedene Proxy-Konfigurationen pro Umgebung benötigen oder das Proxy-Verhalten programmatisch steuern möchten.

Beide Methoden werden vollständig unterstützt, und WebdriverIO prüft zuerst auf einen globalen Dispatcher, bevor es auf Umgebungsvariablen zurückgreift.

Sauce Connect Proxy

Wenn Sie Sauce Connect Proxy verwenden, starten Sie ihn über:

sc -u $SAUCE_USERNAME -k $SAUCE_ACCESS_KEY --no-autodetect -p http://my.corp.proxy.com:9090

Proxy zwischen Browser und Internet

Um die Verbindung zwischen dem Browser und dem Internet zu tunneln, können Sie einen Proxy einrichten, was nützlich sein kann, um (zum Beispiel) Netzwerkinformationen und andere Daten mit Tools wie BrowserMob Proxy zu erfassen.

Die proxy-Parameter können über die Standard-Capabilities wie folgt angewendet werden:

wdio.conf.js

export const config = {
    // ...
    capabilities: [{
        browserName: 'chrome',
        // ...
        proxy: {
            proxyType: "manual",
            httpProxy: "corporate.proxy:8080",
            socksUsername: "codeceptjs",
            socksPassword: "secret",
            noProxy: "127.0.0.1,localhost"
        },
        // ...
    }],
    // ...
}

Weitere Informationen finden Sie in der WebDriver-Spezifikation.