Nightwatch.js

End-to-end testing, the easy way.

End-to-End Automation

Nightwatch.js is an integrated, easy to use End-to-End testing solution for web applications and websites, written in Node.js. It uses the W3C WebDriver API to drive browsers and perform commands and assertions on DOM elements.

  • Clean Syntax

    Simple but powerful syntax which enables you to write tests very quickly, using Javascript (Node.js) and CSS or Xpath selectors. Typescript is supported as well.

  • Cloud Testing Support

    Works with BrowserStack out of the box. Other cloud testing providers, such as SauceLabs or LambdaTest are easy to add.

  • Page Objects Support

    Fluent and easy to work with Page Object Model support to better organise elements and sections, with support for both CSS or Xpath selectors.

  • Plugin API

    Flexible command and assertion framework which makes it easy to implement your own plugins and extend the built-in commands and assertions APIs.

  • Test Runner

    Built-in command-line test runner which runs the tests either sequentially or in parallel, with retries and implicit waits. Also supports grouping of test suites and tags.

  • WebDriver Service

    Manages automatically Selenium or WebDriver services (ChromeDriver, GeckoDriver, Edge, Safari) in a separate child process.

  • Continuous Integration

    JUnit XML reporting is built-in so you can integrate your tests in your build process with systems such as Teamcity, Jenkins, CircleCI etc.

Demo Test

The test below opens the search engine Ecosia.org and searches for "nightwatch", then verifies if the term first result is the Nightwatch.js website.


describe('Demo test Ecosia.org', function() {
  test('search for nightwatch', function(browser) {
    browser
      .url('https://www.ecosia.org/')
      .waitForElementVisible('body')
      .assert.titleContains('Ecosia')
      .assert.visible('input[type=search]')
      .sendKeys('input[type=search]', 'nightwatch')
      .assert.visible('button[type=submit]')
      .click('button[type=submit]')
      .assert.textContains('.layout__content', 'Nightwatch.js')
      .end();
  })
});

Get started in 60 seconds

Follow this video and run your first Nightwatch test in your selected browsers within a minute (assuming Node.js and NPM are installed)

npm init nightwatch /path/to/new-project