Zum Hauptinhalt springen

Capabilities

Eine Capability ist eine Definition für eine entfernte Software. Es hilft WebdriverIO zu verstehen, in welchem Browser oder in welcher mobilen Umgebung Sie Ihre Tests ausführen möchten. Capabilities sind weniger wichtig, wenn Sie Tests lokal entwickeln, da Sie sie die meiste Zeit auf einer Remote-Schnittstelle ausführen, werden aber wichtiger, wenn Sie eine große Anzahl von Integrationstests in CI/CD ausführen.

info

Das Format eines Capability-Objekts ist durch die WebDriver-Spezifikationgenau definiert. Der WebdriverIO-Testrunner schlägt vorzeitig fehl, wenn benutzerdefinierte Funktionen diese Spezifikation nicht einhalten.

Benutzerdefinierte Capabilities​

While the amount of fixed defined capabilities is very low, everyone can provide and accept custom capabilities that are specific to the automation driver or remote interface:

Browserspezifische Capability-Erweiterungen​

  • goog:chromeOptions: Chromedriver Erweiterungen, nur zum Testen in Chrome anwendbar
  • moz:firefoxOptions: Geckodriver Erweiterungen, nur anwendbar zum Testen in Firefox
  • ms:edgeOptions: EdgeOptions zum Angeben der Umgebung bei Verwendung von EdgeDriver zum Testen von Chromium Edge

Capability Erweiterungen von Cloud-Anbietern​

Erweiterungen der Automation Engine-Capabilities​

WebdriverIO Capabilities to manage browser driver options​

WebdriverIO manages installing and running browser driver for you. WebdriverIO uses a custom capability that allows you to pass in parameters to the driver.

wdio:chromedriverOptions​

Specific options passed into Chromedriver when starting it.

wdio:geckodriverOptions​

Specific options passed into Geckodriver when starting it.

wdio:edgedriverOptions​

Specific options passed into Edgedriver when starting it.

wdio:safaridriverOptions​

Specific options passed into Safari when starting it.

wdio:maxInstances​

Maximum number of total parallel running workers for the specific browser/capability. Takes precedence over maxInstances and maxInstancesPerCapability.

Type: number

wdio:specs​

Define specs for test execution for that browser/capability. Same as the regular specs configuration option, but specific to the browser/capability. Takes precedence over specs.

Type: (String | String[])[]

wdio:exclude​

Exclude specs from test execution for that browser/capability. Same as the regular exclude configuration option, but specific to the browser/capability. Takes precedence over exclude.

Type: String[]

wdio:enforceWebDriverClassic​

By default, WebdriverIO attempts to establish a WebDriver Bidi session. If you don't prefer that, you can set this flag to disable this behavior.

Type: boolean

Common Driver Options​

While all driver offer different parameters for configuration, there are some common ones that WebdriverIO understand and uses for setting up your driver or browser:

cacheDir​

The path to the root of the cache directory. This directory is used to store all drivers that are downloaded when attempting to start a session.

Type: string
Default: process.env.WEBDRIVER_CACHE_DIR || os.tmpdir()

binary​

Path to a custom driver binary. If set WebdriverIO won't attempt to download a driver but will use the one provided by this path. Make sure the driver is compatible with the browser you are using.

You can provide this path via CHROMEDRIVER_PATH, GECKODRIVER_PATH or EDGEDRIVER_PATH environment variables.

Type: string

caution

If the driver binary is set, WebdriverIO won't attempt to download a driver but will use the one provided by this path. Make sure the driver is compatible with the browser you are using.

Browser Specific Driver Options​

In order to propagate options to the driver you can use the following custom capabilities:

  • Chrome or Chromium: wdio:chromedriverOptions
  • Firefox: wdio:geckodriverOptions
  • Microsoft Egde: wdio:edgedriverOptions
  • Safari: wdio:safaridriverOptions
adbPort​

The port on which the ADB driver should run.

Example: 9515

Type: number

urlBase​

Base URL path prefix for commands, e.g. wd/url.

Example: /

Type: string

logPath​

Write server log to file instead of stderr, increases log level to INFO

Type: string

logLevel​

Set log level. Possible options ALL, DEBUG, INFO, WARNING, SEVERE, OFF.

Type: string

verbose​

Log verbosely (equivalent to --log-level=ALL)

Type: boolean

silent​

Log nothing (equivalent to --log-level=OFF)

Type: boolean

appendLog​

Append log file instead of rewriting.

Type: boolean

replayable​

Log verbosely and don't truncate long strings so that the log can be replayed (experimental).

Type: boolean

readableTimestamp​

Add readable timestamps to log.

Type: boolean

enableChromeLogs​

Show logs from the browser (overrides other logging options).

Type: boolean

bidiMapperPath​

Custom bidi mapper path.

Type: string

allowedIps​

Comma-separated allowlist of remote IP addresses which are allowed to connect to EdgeDriver.

Type: string[]
Default: ['']

allowedOrigins​

Comma-separated allowlist of request origins which are allowed to connect to EdgeDriver. Using * to allow any host origin is dangerous!

Type: string[]
Default: ['*']

spawnOpts​

Options to be passed into the driver process.

Type: SpawnOptionsWithoutStdio | SpawnOptionsWithStdioTuple<StdioOption, StdioOption, StdioOption>
Default: undefined

Spezielle Capabilities für spezielle Anwendungsfälle​

Dies ist eine Liste von Beispielen, die zeigen, welche Fähigkeiten angewendet werden müssen, um einen bestimmten Anwendungsfall zu erreichen.

Führen Sie den Browser Headless aus​

Das Ausführen eines Headless-Browsers bedeutet, eine Browserinstanz ohne Fenster oder Benutzeroberfläche auszuführen. Dies wird hauptsächlich in CI/CD-Umgebungen verwendet, in denen kein Display verwendet wird. Wenden Sie die folgenden Funktionen an, um einen Browser im Headless-Modus auszuführen:

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

Automate Different Browser Channels​

If you like to test a browser version that is not yet released as stable, e.g. Chrome Canary, you can do so by setting capabilities and pointing to the browser you like to start, e.g.:

When testing on Chrome, WebdriverIO will automatically download the desired browser version and driver for you based on the defined browserVersion, e.g.:

{
    browserName: 'chrome', // or 'chromium'
    browserVersion: '116' // or '116.0.5845.96', 'stable', 'dev', 'canary', 'beta' or 'latest' (same as 'canary')
}

If you like to test a manually downloaded browser, you can provide a binary path to the browser via:

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

Additionally, if you like to use a manually downloaded driver, you can provide a binary path to the driver via:

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

Extend Custom Capabilities​

If you like to define your own set of capabilities in order to e.g. store arbitrary data to be used within the tests for that specific capability, you can do so by e.g. setting:

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

It is advised to follow the W3C protocol when it comes to capability naming which requires a : (colon) character, denoting an implementation specific namespace. Within your tests you can access your custom capability through, e.g.:

browser.capabilities['custom:caps']

In order to ensure type safety you can extend WebdriverIOs capability interface via:

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

Welcome! How can I help?

WebdriverIO AI Copilot