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 tagName (smoke/sanity/regression)

4. Generate the allure report

npm run allure

Command Line Arguments

`--browser | -b`: 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 | -e`: specify what environment to run against. Default value is dev.

`--headless | -h`: run the browsers in headless mode if browser supports it. Default value is false.

`--cucumberOpts`: run tests using various Cucumber 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 -- -h -b chrome -e 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 smoke -- -h -b firefox -e qa
npm test -- --cucumberOpts.tagExpression='@smoke' -h -b firefox -e qa

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

npm test -- -b android_chrome -e qa

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