Edit

API Docs

Welcome to the WebdriverIO docs page. These pages contain reference materials for all implemented selenium bindings and commands. WebdriverIO has all JSONWire protocol commands implemented and also supports special bindings for Appium.

Note: These are the docs for the latest version (v5.0.0) of WebdriverIO. If you are still using v4 or older please use the legacy docs website v4.webdriver.io!

Examples

Each command documentation usually comes with an example that demonstrates the usage of it using WebdriverIO's testrunner running its commands synchronously. If you run WebdriverIO in standalone mode you still can use all commands but need to make sure that the execution order is handled properly by chaining the commands and resolving the promise chain. So instead of assigning the value directly to a variable, as the wdio testrunner allows it:

it('can handle commands synchronously', () => {
    var value = $('#input').getValue();
    console.log(value); // outputs: some value
});

you need return the command promise so it gets resolved properly as well as access the value when the promise got resolve:

it('handles commands as promises', () => {
    return $('#input').getValue().then((value) => {
        console.log(value); // outputs: some value
    });
});

Of course you can use Node.JS latest async/await functionality to bring synchronous syntax into your testflow like:

it('can handle commands using async/await', async function () {
    var value = await $('#input').getValue();
    console.log(value); // outputs: some value
});

However it is recommended to use the testrunner to scale up your test suite as it comes with a lot of useful add ons like the Sauce Service that helps you to avoid writing a lot of boilerplate code by yourself.

Contribute

If you feel like you have a good example for a command, don't hesitate to open a PR and submit it. Just click on the orange button on the top right with the label "Improve this doc". Make sure you understand the way we write these docs by checking the Contribute section.