node package manager
Love JavaScript? Your insights can make it even better. Take the 2017 JavaScript Ecosystem Survey ยป



  • Run plain English test case as a test
  • Built-in chromedriver, firefox driver, and reporter
  • No need to run a selenium-server standalone jar file
  • Ability to control execution speed
  • Angular2-Friendly without Protractor


  • npm install webdriver-tt


  • node_modules/webdriver-tt/bin my-test-case.txt

Test Case File Example

My Test Scenario
  My Test Case
    open /login
    enter 'John' into 'username'
    enter 'secret' into 'password'
    see 'successful'

Selenuim WebDriver is great! .......... But, it's not that easy for a beginner who does not understand full concept of Promise used in there.

For example, the following test code does make sense, but it will only work if you are super lucky;

var webdriver = require('selenium-webdriver'),
    until = webdriver.until;

var driver = new webdriver.Builder().forBrowser('firefox').build();

driver.findElement({css:'input'}).then(function(element) {
  element.getAttribute('value').then(function(str) {
    console.log('str', str); 


You may get this error very easily, NoSuchElementError: Unable to locate element.

    throw error;

NoSuchElementError: Unable to locate element: {"method":"css selector","selector":"input"}

The reason is not only about timeout, but also every about implicit wait instruction is not executed insequence.

This pain grows when we deal with Angular, especially Angular2. That might be the reason protractor is invented. However, even with protractor, timeout error, implicit and explicit wait still comes time to time, makes successful tests very inconsistent.

WebDriver has very nice feature of wait/until to resolve things before to go further tests. We can change it to use explicit wait by using driver.wait and webdriver.until, but almost all hates to deal with chainging these properly, and even properly chained code is not so maintainable.

wait syntax

driver.wait(CONDITION, MS);

We can combine this syntax with driver.until. conditions. For example,

driver.until.elementIsVisible({css: '.my-class'})

The problem is that we can do only once. The following code is not guranteed to run in sequence

driver.wait(CONDITION1, 2000).then(function() { console.log(1) });
driver.wait(CONDITION2, 2000).then(function() { console.log(2) });
driver.wait(CONDITION3, 2000).then(function() { console.log(3) });

To make it really sequenctial, we need to code like the following


driver.wait(until.elementLocated({css:"h3.first"}), 20000).then(function() {
}).then(function() {
  driver.wait(until.elementLocated({css:"div"}), 20000).then(function() {
}).then(function() {
  driver.wait(until.elementLocated({css:"body"}), 20000).then(function() {

Although the above code works, the repeativive function(), then, and { ..} makes people not to focus on test, but the Javascript promise syntax.

webdriver-tt is designed to focus on test cases, not Javascript syntax by genrating promise-chained then..then..then..then..then.. code from clean test cases.

These are pattern of commands

  • open browser {{URL}}
  • visit {{URL}}
  • find {{ELEMENT}}
  • enter {{STRING}} into {{ELEMENT}}
  • click {{ELEMENT}}
  • wait until alert is present
  • wait until {{ELEMENT}} present
  • wait until {{ELEMENT}} is (not) visible
  • wait until {{ELEMENT}} is (en|dis)abled
  • wait until {{ELEMENT}} is (not) selected