Applies to CrossBrowserTesting SaaS, last modified on January 10, 2023

Get started with CucumberJS and CrossBrowserTesting

For this document, we provide an example test located in our CucumberJS GitHub Repository.

Want a powerful and easy to use command line tool for running Selenium tests? Cucumber might be the option for you. Cucumber provides language-bindings for the powerful browser-driving tool Selenium. Its Gherkin language allows you to write your tests in a way that can be easily read by anyone on your team. Cucumber Java integrates easily with the CrossBrowserTesting platform, so you can perform tests on a wide variety of OS/Device/Browser combinations, all from one test.

Let's walk through getting setup.

First we need to create a new folder, initialize your project, and get Cucumber and Selenium installed. You can do this through NPM:

npm init --yes
npm install cucumber --save-dev
npm install selenium-webdriver --save-dev

We are also going to install JavaScript's Request module, so we can make Restful API calls to set the score for our test once we are finished. We can also do this with NPM:

npm install request --save-dev

Before starting any tests, you can configure Cucumber to use testing frameworks like Chai or Mocha, and you can read more on that here. For the purpose of this introduction, we'll dive right into getting connected with CrossBrowserTesting. We will need to create a new file step_definitions/world.js that defines our connection to the remote hub:

var webdriver = require('selenium-webdriver');
var{setWorldConstructor} = require('cucumber');

global.username = 'YOUR_USERNAME';
global.authkey = 'YOUR_AUTHKEY';
function CBTWorld() {
  var remoteHub = '';
  var caps = {
    name : 'Basic Example',
    build : '1.0',
    browserName : 'Chrome', // Pulls latest version of Chrome by default
    platform : 'Windows 10', // To specify version, add version : 'desired version'
    screen_resolution : '1366x768',
    record_video : 'true',
    username : global.username,
    password : global.authkey

  this.driver = new webdriver.Builder()

  setDefaultTimeout(60 * 1000);

Be certain to change the username and authorization key above to those associated with your account. Now that we have that out of the way, we can put together our first script. We will first need to create a feature file where our test steps are defined in the Gherkin language. Save the following as features/todo.feature:

Feature: CBT Feature

  Scenario: Adding ToDos
    Given I go to my ToDo app
    When I add a new ToDo
    Then I should have 6 ToDos

Lastly, we need to define the procedural code. This will be the JavaScript that works with the Selenium language bindings to create the logic of our test. Save the following as step_definitions/browser_steps.js:

var webdriver = require('selenium-webdriver');
var {Given, When, Then } = require('cucumber');
var assert = require('assert');

  Given('I go to my ToDo app', function() {
    return this.driver.get('');

  When('I add a new ToDo', function () {
    this.driver.findElement("todotext")).sendKeys("Run your first Selenium Test");
    return this.driver.findElement("addbutton")).click();

  Then('I should have 6 ToDos', function() {
    return this.driver.findElements(webdriver.By.className('ng-pristine ng-untouched ng-valid'))
      .then(function(elems) {
        assert.equal(elems.length, 6);

Save the following as step_definitions/hooks.js:

var {After} = require('cucumber');

  After(function() {
    if(this.driver !=null){
      return this.driver.quit();

Run your test using the command:

node_modules/.bin/cucumber-js ./features -r ./step_definitions

As you can probably make out from our test, we visit a small ToDo App example, interact with our page, and use assertions to verify that the changes we’ve made are actually reflected in our app.

We kept it short and sweet for our purposes, but there is so much more you can do with CucumberJS! Being built on top of Selenium means the sky is the limit as far as what you can do. If you have any questions or concerns, feel free to get in touch.

See Also

Test Frameworks and Tools
About Selenium Testing
Selenium and JavaScript
WebDriverIO and CrossBrowserTesting

Highlight search results