Vai al contenuto principale

Capacità

Una capacità è una definizione per un'interfaccia remota. Aiuta WebdriverIO a comprendere in quale ambiente browser o mobile desideri eseguire i tuoi test. Le capacità sono meno cruciali quando si sviluppano test localmente poiché li esegui su un'unica interfaccia remota la maggior parte del tempo, ma diventano più importanti quando si esegue un ampio set di test di integrazione in CI/CD.

info

Il formato di un oggetto capacità è ben definito dalla specifica WebDriver. Il test runner di WebdriverIO fallirà in anticipo se le capacità definite dall'utente non aderiscono a tale specifica.

Capacità Personalizzate​

Mentre la quantità di capacità fisse definite è molto bassa, chiunque può fornire e accettare capacità personalizzate specifiche per il driver di automazione o l'interfaccia remota:

Estensioni di Capacità Specifiche per Browser​

  • goog:chromeOptions: estensioni Chromedriver, applicabili solo per i test in Chrome
  • moz:firefoxOptions: estensioni Geckodriver, applicabili solo per i test in Firefox
  • ms:edgeOptions: EdgeOptions per specificare l'ambiente quando si utilizza EdgeDriver per testare Chromium Edge

Estensioni di Capacità dei Fornitori Cloud​

Estensioni di Capacità dei Motori di Automazione​

Capacità di WebdriverIO per gestire le opzioni del driver del browser​

WebdriverIO gestisce l'installazione e l'esecuzione del driver del browser per te. WebdriverIO utilizza una capacità personalizzata che ti consente di passare parametri al driver.

wdio:chromedriverOptions​

Opzioni specifiche passate a Chromedriver durante l'avvio.

wdio:geckodriverOptions​

Opzioni specifiche passate a Geckodriver durante l'avvio.

wdio:edgedriverOptions​

Opzioni specifiche passate a Edgedriver durante l'avvio.

wdio:safaridriverOptions​

Opzioni specifiche passate a Safari durante l'avvio.

wdio:maxInstances​

Numero massimo di lavoratori in esecuzione parallela totale per il browser/capacità specifici. Ha precedenza su maxInstances e maxInstancesPerCapability.

Tipo: number

wdio:specs​

Definisce le specifiche per l'esecuzione dei test per quel browser/capacità. Uguale all'opzione di configurazione regolare specs, ma specifica per il browser/capacità. Ha precedenza su specs.

Tipo: (String | String[])[]

wdio:exclude​

Esclude le specifiche dall'esecuzione dei test per quel browser/capacità. Uguale all'opzione di configurazione regolare exclude, ma specifica per il browser/capacità. Esclude dopo che l'opzione di configurazione globale exclude è stata applicata.

Tipo: String[]

wdio:enforceWebDriverClassic​

Per impostazione predefinita, WebdriverIO tenta di stabilire una sessione WebDriver Bidi. Se non preferisci questo comportamento, puoi impostare questo flag per disabilitarlo.

Tipo: boolean

Opzioni comuni del Driver​

Mentre tutti i driver offrono parametri diversi per la configurazione, ce ne sono alcuni comuni che WebdriverIO comprende e utilizza per configurare il driver o il browser:

cacheDir​

Il percorso alla radice della directory della cache. Questa directory viene utilizzata per memorizzare tutti i driver scaricati quando si tenta di avviare una sessione.

Tipo: string
Predefinito: process.env.WEBDRIVER_CACHE_DIR || os.tmpdir()

binary​

Percorso a un binario del driver personalizzato. Se impostato, WebdriverIO non tenterà di scaricare un driver ma utilizzerà quello fornito da questo percorso. Assicurati che il driver sia compatibile con il browser che stai utilizzando.

Puoi fornire questo percorso tramite le variabili d'ambiente CHROMEDRIVER_PATH, GECKODRIVER_PATH o EDGEDRIVER_PATH.

Tipo: string

attenzione

Se il binary del driver è impostato, WebdriverIO non tenterà di scaricare un driver ma utilizzerà quello fornito da questo percorso. Assicurati che il driver sia compatibile con il browser che stai utilizzando.

Opzioni del driver specifiche per browser​

Per propagare opzioni al driver, puoi utilizzare le seguenti capacità personalizzate:

  • Chrome o Chromium: wdio:chromedriverOptions
  • Firefox: wdio:geckodriverOptions
  • Microsoft Edge: wdio:edgedriverOptions
  • Safari: wdio:safaridriverOptions
adbPort​

La porta su cui dovrebbe essere eseguito il driver ADB.

Esempio: 9515

Tipo: number

urlBase​

Prefisso del percorso URL di base per i comandi, ad es. wd/url.

Esempio: /

Tipo: string

logPath​

Scrive il log del server su file anziché su stderr, aumenta il livello di log a INFO

Tipo: string

logLevel​

Imposta il livello di log. Opzioni possibili ALL, DEBUG, INFO, WARNING, SEVERE, OFF.

Tipo: string

verbose​

Log verboso (equivalente a --log-level=ALL)

Tipo: boolean

silent​

Non registra nulla (equivalente a --log-level=OFF)

Tipo: boolean

appendLog​

Aggiunge al file di log anziché riscriverlo.

Tipo: boolean

replayable​

Registra in modo dettagliato e non tronca le stringhe lunghe in modo che il log possa essere riprodotto (sperimentale).

Tipo: boolean

readableTimestamp​

Aggiunge timestamp leggibili al log.

Tipo: boolean

enableChromeLogs​

Mostra i log dal browser (sovrascrive altre opzioni di logging).

Tipo: boolean

bidiMapperPath​

Percorso personalizzato del mapper bidi.

Tipo: string

allowedIps​

Elenco di indirizzi IP remoti consentiti, separati da virgola, che sono autorizzati a connettersi a EdgeDriver.

Tipo: string[]
Predefinito: ['']

allowedOrigins​

Elenco di origini di richieste consentite, separate da virgola, che sono autorizzate a connettersi a EdgeDriver. L'uso di * per consentire qualsiasi origine host è pericoloso!

Tipo: string[]
Predefinito: ['*']

spawnOpts​

Opzioni da passare al processo del driver.

Tipo: SpawnOptionsWithoutStdio | SpawnOptionsWithStdioTuple<StdioOption, StdioOption, StdioOption>
Predefinito: undefined

Capacità Speciali per Casi d'Uso Specifici​

Questa è una lista di esempi che mostrano quali capacità devono essere applicate per raggiungere un determinato caso d'uso.

Eseguire Browser Headless​

Eseguire un browser headless significa eseguire un'istanza del browser senza finestra o UI. Questo viene utilizzato principalmente in ambienti CI/CD dove non viene utilizzato un display. Per eseguire un browser in modalità headless, applica le seguenti capacità:

{
    browserName: 'chrome',   // o 'chromium'
    'goog:chromeOptions': {
        args: ['headless', 'disable-gpu']
    }
}

Automatizzare Diversi Canali di Browser​

Se desideri testare una versione del browser che non è ancora stata rilasciata come stabile, ad esempio Chrome Canary, puoi farlo impostando le capacità e puntando al browser che desideri avviare, ad esempio:

Quando si eseguono test su Chrome, WebdriverIO scaricherà automaticamente la versione del browser e il driver desiderati in base al browserVersion definito, ad esempio:

{
    browserName: 'chrome', // o 'chromium'
    browserVersion: '116' // o '116.0.5845.96', 'stable', 'dev', 'canary', 'beta' o 'latest' (uguale a 'canary')
}

Se desideri testare un browser scaricato manualmente, puoi fornire un percorso binario al browser tramite:

{
    browserName: 'chrome',  // o 'chromium'
    'goog:chromeOptions': {
        binary: '/Applications/Google\ Chrome\ Canary.app/Contents/MacOS/Google\ Chrome\ Canary'
    }
}

Inoltre, se desideri utilizzare un driver scaricato manualmente, puoi fornire un percorso binario al driver tramite:

{
    browserName: 'chrome', // o 'chromium'
    'wdio:chromedriverOptions': {
        binary: '/path/to/chromdriver'
    }
}

Estendere Capacità Personalizzate​

Se desideri definire il tuo insieme di capacità per ad esempio memorizzare dati arbitrari da utilizzare nei test per quella capacità specifica, puoi farlo ad esempio impostando:

export const config = {
    // ...
    capabilities: [{
        browserName: 'chrome',
        'custom:caps': {
            // configurazioni personalizzate
        }
    }]
}

Si consiglia di seguire il protocollo W3C quando si tratta di denominazione delle capacità, che richiede un carattere : (due punti), che denota uno spazio dei nomi specifico dell'implementazione. All'interno dei tuoi test puoi accedere alla tua capacità personalizzata tramite, ad esempio:

browser.capabilities['custom:caps']

Per garantire la sicurezza dei tipi, puoi estendere l'interfaccia delle capacità di WebdriverIO tramite:

declare global {
    namespace WebdriverIO {
        interface Capabilities {
            'custom:caps': {
                // ...
            }
        }
    }
}

Welcome! How can I help?

WebdriverIO AI Copilot