README.md

demo-bdd-test-workshop

A workshop for bdd test coding by Node.js

Coding environment: Node.js

Usage

1. fast download & install, skip this if you have installed

2. git clone [email protected]:AfterShip/demo-bdd-test-workshop.git

3. npm install

4. npm test

Feature: BDD practices

	Scenario: Launching demo workshop

		Given I am a cool coder trying to glance more about "BDD"

		When my computer have installed "Node.js"

		And I try to do the demo on "my local environment"

		Then clone this repo by running: "git clone [email protected]:AfterShip/demo-bdd-test-workshop.git"

		Then run "npm install"


	Scenario: Run the test

		Given the project has several branches represent to deferent scenarios
			| AvailableBranchesOfScenarios |
			| aftership-login-success      |
			| aftership-login-error        |

		When I want to switch to a scenario

		Then just checkout the target branch to see the example by "git checkout <target-branch>":

About step definitions

These workshop will implement the step definitions by an E2E test tool call Cypress

You can refer following codes to implement the step:

Gherkin:

Given I am a cool coder

Correspond to:

Given('I am a cool coder', ()=>{
	// code something if needed
})

Examples of step definitions that may be used in this workshop

Visit a page

Gherkin:

When I visit the "https://www.aftership.com"

correspond to:

When("I visit the {string}", url => {
	cy.visit(url)
})

Click a button

Gherkin:

When I click the "Sign In" button

correspond to:

When("I click the {string} button", buttonText => {
	cy.get('button:visible').contains(buttonText).click();
})

Assert the page contains some text

Gherkin:

Then I can see the "Welcome!"

correspond to:

Then("I can see the {string}", text => {
	cy.contains(':visible', text);
})

Select something by a css selector

get a visible element

cy.get('button:visible');

get an input field name "email"

cy.get('input[name="email"]');

Type some text in a input field

cy.get(`input[name="email"]`).type('[email protected]');