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.

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​

• sauce:options: Sauce Labs
• bstack:options: BrowserStack
• tb:options: TestingBot
• LT:Options: LambdaTest
• e molti altri...

Estensioni di Capacità dei Motori di Automazione​

• appium:xxx: Appium
• selenoid:xxx: Selenoid
• e molti altri...

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

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

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']
    }
}

    browserName: 'firefox',
    'moz:firefoxOptions': {
        args: ['-headless']
    }

    browserName: 'msedge',
    'ms:edgeOptions': {
        args: ['--headless']
    }

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:

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

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

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

{
    browserName: 'firefox',
    browserVersion: '119.0a1' // o 'latest'
}

{
    browserName: 'firefox',
    'moz:firefoxOptions': {
        binary: '/Applications/Firefox\ Nightly.app/Contents/MacOS/firefox'
    }
}

{
    browserName: 'firefox',
    'wdio:geckodriverOptions': {
        binary: '/path/to/geckodriver'
    }
}

{
    browserName: 'msedge',
    'ms:edgeOptions': {
        binary: '/Applications/Microsoft\ Edge\ Canary.app/Contents/MacOS/Microsoft\ Edge\ Canary'
    }
}

{
    browserName: 'msedge',
    browserVersion: '109' // o '109.0.1467.0', 'stable', 'dev', 'canary', 'beta'
}

{
    browserName: 'msedge',
    'wdio:edgedriverOptions': {
        binary: '/path/to/msedgedriver'
    }
}

{
    browserName: 'safari technology preview'
}

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