Cucumber-js and BDD are not new. Still, many developers are fairly unfamiliar with them; the two together can be very powerful tools for both non-tech people and developers. What Is BDD? BDD is short for Business-Driven-Development; it's a way to close the gap between business people and technical people. Basically, BDD has evolved from TDD; there's a high chance that you might even be doing BDD without knowing it, as sometimes the lines between them aren't clear. So what's the difference between them, both are ? Well, the difference is that we use the language of our end-users, i.e., the business or domain language such as , to capture a story in an executable format. For example, automated tests right Given-When-Then GIVEN User is on Wordpress Registration Page.
WHEN he enters all the required information.
THEN his account is created. The “given” part is where we declare preconditions. In our example above, we had a user. Next, the “when” part contains the action you want to test. And finally, you verify the outcome in the “then” part. Now, If you have more than one or you require more information than this, you can add them with . For example, AND GIVEN User is on Wordpress Registration Page.
WHEN he enters all the required information.
AND he hits ‘create account’
THEN his account is created.
AND his confirmation email is sent. Introducing Cucumber Cucumber-js is . The tests are written in the Gherkin language, which is human-readable and is stored in feature files that have the feature extension. This allows your tests to be a point of communication and collaboration with business people and can even serve as documentation that is automatically up-to-date. a test framework that supports BDD A test in the Gherkin language is called a scenario. And scenarios are organized into features. Feature: Automatic discounts for premium customers
    Premium customers should automatically get a
    discount of 25% on purchases over $500.

    Scenario: Purchase over $700
        Given a premium customer
        And an order containing
            | item   | amount | price |
            | pencil | 100    | 2     |
            | paper  | 10     | 35    |
        When the customer checks out
        Then the total price should be 412.5 In the above example, there are many , and every keyword has its own meaning and purpose. keywords Let’s explain each keyword with respect to the above example. : The feature file starts with the keyword Feature**.** Under feature, you can mention the feature name that is to be tested, as seen above. Feature Keyword : Each scenario must start with the keyword Scenario**,** followed by the scenario name. And under each feature file, there can be more than one scenario. Scenario Keyword : Given keyword is used when we have to give some pre-condition in our test case. Given Keyword : When the keyword is used to perform some action. When Keyword : It is used to two statements with the logical condition between any two statements. It can be used in combination with , and statements. And Keyword connect AND GIVEN WHEN, THEN : Then Keyword is used for the final outcome or for validation. Then Keyword Other than these, there are two more keywords, : This keyword is used to represent negative assertions in addition to the previous statement. But Keyword : Steps kept under Background would be run before every test case. Background Keyword Although, Initially, Cucumber was created for ' ' as a support for BDD framework for testing, Cucumber-js has evolved to support a variety of different programming languages such as Java, JavaScript, PHP, Net, Python, Perl, etc... Ruby Language RSpec Writing simple BDD test with Cucumber-js We will create a few tests to see how cucumber works, for this we will first define our scenario and feature before starting to write our code. Let's get started!! First, let's create our work directory and create our file: - package*.json mkdir bdd & cd bdd
npm init -y Now, it's time to install our dependencies. npm i chai @cucumber/cucumber @cucumber/cucumber-expressions cucumber-html-reporter Let's move towards writing the tests and setting up folder structures for cucumber-js; this is how the folder structure should look like: - ├── Features
│   ├── Support
│   │   ├── steps.js
│   │   ├── world.js
│   ├── simple_math.feature
├── utils
│   ├── report.js
├── cucumber.js
├── node_modules
├── package.json
├── package-lock.json
└── .gitignore Create a folder structure similar to the above before moving forward. Once we have our folder structure ready, let's start with file: - steps.js const { Given, When, Then } = require("@cucumber/cucumber");
const { expect } = require("chai");

Given("a variable set to {int}", function(number) {
  this.setTo(number);
});

When("I increment the variable by {int}", function(number) {
  this.incrementBy(number);
});

Then("the variable should contain {int}", function(number) {
  expect(this.variable).to.eql(number);
}); In Cucumber-js, “ ” is an isolated scope for each scenario. That means all the steps, hooks, etc., for a scenario are a part of a world, and this data can be accessed within the world anytime. Let's define our file world world.js const { setWorldConstructor } = require("@cucumber/cucumber");

class CustomWorld {
  constructor() {
    this.variable = 0;
  }
  setTo(number) {
    this.variable = number;
  }
  incrementBy(number) {
    this.variable += number;
  }
}
setWorldConstructor(CustomWorld); Finally, we have both steps and world ready. Now it's time to create our file. .feature Feature: Simple maths
  In order to do maths
  As a developer
  I want to increment variables

  Scenario: easy maths
    Given a variable set to 1
    When I increment the variable by 1
    Then the variable should contain 2

  Scenario Outline: much more complex stuff
    Given a variable set to <var>
    When I increment the variable by <increment>
    Then the variable should contain <result>
    Examples:
      | var | increment | result |
      | 100 |         5 |    105 |
      |  99 |      1234 |   1333 |
      |  12 |         5 |     17 | Above, we have defined our feature, and, in correspondence, created two different scenarios. Let's run to see if the test pass/fail : npx cucumber-js The output we get would be similar to below: Test Report File Now, to make it more understandable, let's add functionality to create the test report for each run. In file, we will add: - cucumber.js var _default = [
    '--format usage:reports/usage.txt',
    '--format json:reports/cucumber_report.json',
    '--format html:reports/cucumber_report.html'
  ].join(' ')
  
  module.exports = {
    default: _default,
  } This will create a JSON and HTML report to visualize and append in the same files each time we run our tests. Now, let's define what will be there in the report file. In , we will add a few lines to provide some more ideas about test environments in the form of metadata. report.js var reporter = require('cucumber-html-reporter');

var options = {
        theme: 'bootstrap',
        jsonFile: 'reports/cucumber_report.json',
        output: 'reports/cucumber_report.html',
        reportSuiteAsScenarios: true,
        scenarioTimestamp: true,
        launchReport: true,
        metadata: {
            "App Version":"0.3.2",
            "Test Environment": "STAGING",
            "Browser": "Edge  54.0.2840.98",
            "Platform": "MacOS",
            "Parallel": "Scenarios",
            "Executed": "Remote"
        }
    };

reporter.generate(options); Now run your tests once again, and you can see that under folder there are two files with name. Open the to see your test report HTML file would look something like below: - reports/ cucumber_report.* HTML Conclusion Cucumber-js focuses mainly on making the collaboration between tech people and business people easy. But it doesn’t eliminate the coding part and still has a lot of code involved. When dealing with the main thing we have to keep in mind is how to properly use keywords GIVEN, WHEN, and THEN. behavior-driven automation, there are a lot of rules that you have to use as a guide; The testing industry has gone to the next step now with codeless testing integrated with AI and smart logic. Frameworks like allow you to create tests without using a single line of code using record and playback testing. But if you still need to use code for some reason, it also allows you to integrate your code into the test project. Keploy The bottom line is that you have three options to choose from for testing: Traditional testing. Code testing that’s easy for business people to understand. Codeless, AI-powered testing. What suits you best depends on your use case. But it’s important to know about all these options to decide what suits you best. So good luck exploring! Also published . here

Walkthroughs, tutorials, guides, and tips. This story will teach you how to do something new or how to do something better.

Too Long; Didn't Read

Make resilience your competitive advantage

BDD with Cucumber-js: Bridging the Gap between Developers and Business

About Author

Comments

TOPICS

THIS ARTICLE WAS FEATURED IN

Related Stories

Untitled Story

BDD in 3 Minutes

BDD is bigger than I thought

BDD: Writing an Automated Test Suite isn’t Rocket Science

Examining Behavior-Driven Development

Front-end (React) Snapshot Testing with Jest: What is it for?

BDD in 3 Minutes

BDD is bigger than I thought

BDD: Writing an Automated Test Suite isn’t Rocket Science

Examining Behavior-Driven Development

Front-end (React) Snapshot Testing with Jest: What is it for?

Light-Mode

Classic

Newspaper

Dark-Mode

Neon Noir

Minty

HN StartUps