Wdio-perfectotest-service NPM

WDIO Perfecto Labs Service

A WebdriverIO service that provides execution on real mobile devices & desktop browsers with the Perfecto Lab, and DigitalZoom Reports.

This service supports these versions of WDIO and Cucumber:

"cucumber": "3.0.0",
"wdio-cucumber-framework": "0.3.1",
"webdriverio": "^4.14.1"

Installation

The easiest way is to keep wdio-perfecto-service as a devDependency in your package.json.

{
  "devDependencies": {
    "wdio-perfecto-service": "~1.0.1"
  }
}

You can simple do it by:

npm install wdio-perfecto-service --save-dev

Instructions on how to install WebdriverIO can be found here.

Configuration

In order to use the service you need to set securityToken in your wdio.conf.js file. It will automatically use Perfecto Lab to run your integration tests. To obtain your security token - click here

// wdio.conf.js
export.config = {
  // ...
  services: [
    [
      'perfecto',
      {
        securityToken: process.env.PERFECTO_SECURITY_TOKEN
      }
    ]
  ],

  // ...
};

Config Options

securityToken

Your securityToken

Type: String

perfectoOpts

Add tags & custom fields to optimize the reports - enables filtering and analysis options. See here for info on the concept. The syntax required is below.

// wdio.conf.js
export.config = {
  // ...
  
  perfectoOpts:{
      executionTags:['Tag1','Tag2'],
      customFields:{
          customField1: example,
          customField2: true
      },
      failureReasons: failureReasons
  },

  // ...
};

executionTags

Type: Array

customFields

Type: Array of CustomField object

failureReasons

Type: failureReasons

Type: Boolean default false

Commands

The below commands have been modified to work with the Perfecto platform. The complete list of Perfecto commands, proprietary extensions to Selenium/Appium see here

`waitUntil` Command

Override WDIO waitUntil command. It will make sure that the command is properly synchronous. For original command use browser._waitUntil

`waitForVisible` Command

Override WDIO waitForVisible command. Takes the first element that matches the selector and wait for it to be visible. For original command use browser._waitForVisible

`waitForEnabled` Command

Override WDIO waitForEnabled command. Takes the first element that matches the selector and wait for it to be enabled. For original command use browser._waitForEnabled

`waitForSelected` Command

Override WDIO waitForSelected command. Takes the first element that matches the selector and wait for it to be selected. For original command use browser._waitForSelected

`waitForText` Command

Override WDIO waitForText command. Takes the first element that matches the selector and wait for it to have text. For original command use browser._waitForText

`waitForValue` Command

Override WDIO waitForValue command. Takes the first element that matches the selector and wait for it to have value. For original command use browser._waitForValue