webdriver.io

Appium Server Side + Webdriver.io

This directory contains simple test scenario using Appium + Webdriver.io + Mocha.

Structure

.
├── package.json
├── package-lock.json
├── run-tests.sh
├── test
│   └── specs
│       ├─── android.js
│       └─── ios.js
├─── android.conf.js
└─── ios.conf.js

• package.json and package-lock.json is obvious for everyone familiar with Node.js. Shortly for those who doesn't know: it contains information about project and what's more important - dependenencies.
• run-tests.sh - starting point for Bitbar Cloud executor
• test/specs/android.js or test/specs/ios.js - Test itself
• android.conf.js - Config for android Webdriver.io Testrunner
• ios.conf.js - Config for ios Webdriver.io Testrunner

Dependencies

• @wdio/appium-service - Appium Service
• @wdio/cli - Webdriver.io (and Testrunner)
• @wdio/junit-reporter - JUnit reporter, because Bitbar Cloud reads JUnit reports to fetch information about i.a. test cases
• @wdio/local-runner - To run test "locally" (because from server perspective it's locally)
• @wdio/mocha-framework - Mocha support
• @wdio/spec-reporter - Default spec reporter
• @wdio/sync - To be able to enable sync mode
• chai - Chai for Mocha (because I wanted to use should [BDD style])

Usage

Prepare package

As always for server side execution you need to create zip package. Zip all files mentioned in Structure section above.

You can do in either manually (with your OS file explorer) or by command line. Linux example:

zip sample-test.zip \
    package.json \
    package-lock.json \
    run-tests.sh \
    test/specs/android.js \
    test/specs/ios.js \.
    android.conf.js
    ios.conf.js

Upload Test and Create Test Run

The simplest way to do that would be using Bitbar Cloud UI. Especially if you don't know your API key. Click here to check out documentation.

This test is using for Android bitbar-sample-app.apk and for iOS bitbar-ios-sample.ipa. Download it and use it with prepared test package.

FAQ

To use Chai's should you need to run proper code. Where it's done?

It's in *.conf.js's before hook.

There is global function takeScreenshot in test - where it came from?

It's in *.conf.js's before hook.

Links

• Webdriver.io Testrunner Configuration (helpful if you want to understand and modify *.conf.js)
• Webdriver.io Appium API
• Chai BDD API