webdriverio-bdd-boilerplate-project

This project would manage template for WebdriverIO with Cucumber frameworks for behavior-driven development (BDD) tests using JavaScript binding

Getting Started

1. Install required dependencies

npm install

2. Run the whole test

npm test

3. Run tests with a tag

npm run e2e --tags=@sanity (sanity)

4. Generate the allure report

npm run allure

Command Line Arguments

`browser=[chrome|firefox|edge|android_chrome|ios_safari] (optional)`: specify what browser to run on. Mobile browsers such as android_chrome or ios_safari will run tests on Perfecto. Default value is chrome.

`env=[local|dev|uat|prod] (optional)`: specify what environment to run against. Default value is uat.

`headless=[true|false] (optional)`: run the browsers in headless mode if browser supports it. Default value is false.

`tags=@tag (optional)`: run tests using Cucumber tag options, such as tagExpression.

`--spec`: specify which test to run.

Command Example

• Below command will run home.feature only.

npm test -- --spec .\src\features\home.feature

• Below command will run tests on chrome in headless mode against local environment.

npm test -- headless browser=chrome env=local

• Below command will run tests with @smoke tag only on firefox in headless mode against qa environment.

//Both commands work the same
npm run e2e -- headless browser=firefox env=qa tag=@smoke

• Below command will run tests on Chrome mobile on Perfecto against uat environment.

npm test -- browser=android_chrome env=uat

Perfecto Connect

To run tests against Manulife's internal web sites from devices on Perfecto, you need to,

1. Make sure to provide a security token
2. Set the value of "enablePerfectoConnect" to true

Note: Perfecto Connect currently does not support Mac machines.

How to generate code snippets for Step Definitions

Run below commands to get code snippets

npx cucumber-js path_to_feature\feature_file_name.feature

NextGen WebdriverIO BDD Framework Wiki

Changelog

Setting up

• Getting Started with WebdriverIO

Scripting Tips

• JavaScript Best Practices & Coding Conventions
• WebdriverIO BDD Best Practices

Debugging Tips

• Frequent Error Messages and Solutions for WebdriverIO

Other Tips

• Jenkins Integration: WebdriverIO & WebdriverIO BDD
• Xray Integration: WebdriverIO & WebdriverIO BDD
• WebdriverIO Boilerplate Project Structure Outline
• Getting Started with ESLint
• Running Mobile Browser Tests on Perfecto
• Bypassing SSO using Chrome extension
• Masking sensitive information using crypto

API Documentation: WebdriverIO Libraries

• Class DataReader
• Class pdfUtil

WebdriverIO Official Documentation

• Getting Started
• Assertion
• Expect
• Allure Reporter
• Junit Reporter
• HTML Reporter