Vai al contenuto principale

Funzionalità

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

informazione

Il formato di un oggetto capability è ben definito dalla specifica WebDriver. Il testrunner di WebdriverIO fallirà precocemente se le capabilities definite dall'utente non aderiscono a quella specifica.

Capabilities Personalizzate​

Mentre il numero di capabilities definite fisse è molto basso, chiunque può fornire e accettare capabilities personalizzate specifiche per il driver di automazione o l'interfaccia remota:

Estensioni di Capability 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 Capability per Fornitori Cloud​

Estensioni di Capability per Motori di Automazione​

Capabilities 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 capability 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/capability specifico. Ha precedenza su maxInstances e maxInstancesPerCapability.

Tipo: number

wdio:specs​

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

Tipo: (String | String[])[]

wdio:exclude​

Esclude specifiche dall'esecuzione del test per quel browser/capability. Uguale all'opzione di configurazione regolare exclude, ma specifica per il browser/capability. Ha precedenza su exclude.

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 tuo driver o 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 file 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 del Browser​

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

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

La porta su cui il driver ADB dovrebbe essere eseguito.

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 invece che 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 dettagliato (equivalente a --log-level=ALL)

Tipo: boolean

silent​

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

Tipo: boolean

appendLog​

Aggiunge al file di log invece di riscriverlo.

Tipo: boolean

replayable​

Log dettagliato e non tronca 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​

Lista di indirizzi IP remoti separati da virgole che sono autorizzati a connettersi a EdgeDriver.

Tipo: string[]
Predefinito: ['']

allowedOrigins​

Lista di origini di richieste separate da virgole che sono autorizzate a connettersi a EdgeDriver. Usare * 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

Capabilities Speciali per Casi d'Uso Specifici​

Questa è una lista di esempi che mostra quali capabilities devono essere applicate per raggiungere un certo caso d'uso.

Eseguire il Browser in Modalità 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 alcun display. Per eseguire un browser in modalità headless, applica le seguenti capabilities:

{
    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 rilasciata come stabile, ad esempio Chrome Canary, puoi farlo impostando le capabilities e indicando il browser che desideri avviare, ad esempio:

Quando si testa su Chrome, WebdriverIO scaricherà automaticamente la versione del browser e il driver desiderati in base a 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 Capabilities Personalizzate​

Se desideri definire il tuo set di capabilities, ad esempio per memorizzare dati arbitrari da utilizzare nei test per quella specifica capability, puoi farlo impostando:

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

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

browser.capabilities['custom:caps']

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

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

Welcome! How can I help?

WebdriverIO AI Copilot