Configurazione del Proxy

Puoi instradare due diversi tipi di richieste attraverso un proxy:

• connessione tra il tuo script di test e il browser driver (o endpoint WebDriver)
• connessione tra il browser e internet

Proxy tra Driver e Test

Se la tua azienda ha un proxy aziendale (ad esempio su http://my.corp.proxy.com:9090) per tutte le richieste in uscita, hai due opzioni per configurare WebdriverIO per utilizzare il proxy:

Opzione 1: Utilizzare Variabili d'Ambiente (Consigliato)

A partire da WebdriverIO v9.12.0, puoi semplicemente impostare le variabili d'ambiente standard per il proxy:

export HTTP_PROXY=http://my.corp.proxy.com:9090
export HTTPS_PROXY=http://my.corp.proxy.com:9090
# Opzionale: bypass proxy per certi host
export NO_PROXY=localhost,127.0.0.1,.internal.domain

Quindi esegui i tuoi test come al solito. WebdriverIO utilizzerà automaticamente queste variabili d'ambiente per la configurazione del proxy.

Opzione 2: Utilizzare setGlobalDispatcher di undici

Per configurazioni proxy più avanzate o se hai bisogno di un controllo programmatico, puoi utilizzare il metodo setGlobalDispatcher di undici:

Installa undici

npm

npm install undici --save-dev

Yarn

yarn add undici --dev

pnpm

pnpm add undici --save-dev

Bun

bun add undici --dev

Aggiungi undici setGlobalDispatcher al tuo file di configurazione

Aggiungi la seguente istruzione require all'inizio del tuo file di configurazione.

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 = {
    // ...
}

Informazioni aggiuntive sulla configurazione del proxy possono essere trovate qui.

Quale Metodo Dovrei Usare?

• Usa le variabili d'ambiente se desideri un approccio semplice e standard che funzioni con diversi strumenti e non richieda modifiche al codice.
• Usa setGlobalDispatcher se hai bisogno di funzionalità proxy avanzate come autenticazione personalizzata, diverse configurazioni proxy per ambiente, o vuoi controllare programmaticamente il comportamento del proxy.

Entrambi i metodi sono completamente supportati e WebdriverIO controllerà prima la presenza di un dispatcher globale prima di ripiegare sulle variabili d'ambiente.

Sauce Connect Proxy

Se utilizzi Sauce Connect Proxy, avvialo tramite:

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

Proxy tra Browser e Internet

Per instradare la connessione tra il browser e internet, puoi configurare un proxy che può essere utile (ad esempio) per catturare informazioni di rete e altri dati con strumenti come BrowserMob Proxy.

I parametri proxy possono essere applicati tramite le capabilities standard nel seguente modo:

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"
        },
        // ...
    }],
    // ...
}

Per maggiori informazioni, consulta la specifica WebDriver.