JavaScript HTML
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
doc @ 8c56912 Simplify README Dec 9, 2015
example Update DuckDuckGo example Oct 28, 2015
src Add semi linting rule Nov 23, 2015
test Improve tests reliability Dec 9, 2015
.editorconfig Order editorconfig properties alphabetically Jul 10, 2014
.gitignore Replace dist and publish go tasks by NPM commands Sep 20, 2015
.gitmodules Switching to a Gollum-supported wiki for doc. Jul 5, 2012
.jsdoc Ensure unrecognized doc tags raise an error Jul 30, 2014 Bump version number Nov 10, 2015 Simplify README Dec 9, 2015
circle.yml Lint continuously Nov 23, 2015
license.AGPL.txt Change license from LGPL to AGPL Sep 9, 2013
package.json Update Should Dec 9, 2015


Watai (Web Application Testing Automation Infrastructure) is a declarative web integration testing framework.

Latest version Code Climate Inline docs

It is both a test runner engine and a set of architectural patterns that help front-end ops-conscious developers write maintainable and solid end-to-end tests. These tests automate web application navigation through actual browsers, checking whether such interactions present the expected information to the end users along the way, including through asynchronous operations.

This allows to automate demonstration of features, to detect regressions when updating code and, since the same tests can be run in almost any browser, to easily check cross-browser functional support.

➥ Read more about what is Watai.

➥ Or watch a 4-minutes introduction: We're bad at web integration testing

What a test looks like

Have a look at a simple example or an advanced example… or look at real-world users!

Our 10-minutes tutorial walks you through an example to introduce all concepts. You don't even need to install the software to do it.


npm install --global selenium-server watai

If you're not familiar with npm install, read the full installation guide :)

Let’s make sure you’re fully ready to use Watai by typing:

watai --installed

Then, get started with Watai!


  • Enforcement of a highly decoupled, component-based architecture for maintainable tests.
  • Out-of-the-box support for async operations (AJAX…), as well as much more resilience than WebDriver, whose failures are wrapped.
  • Simple cascading configuration makes sharing tests across environments (dev, CI, prod) very easy.
  • Aiming for helpful error messages.
  • High quality code and developer documentation, so that you can actually fix things or add functionality without depending on the original developer.

➥ Read more about how Watai is different from other integration testing tools.


The code for this software is distributed under an AGPL license. That means you may use it to test any type of software, be it free or proprietary. But if you make any changes to the test engine itself (i.e. this library), even if it is not redistributed and provided only as a webservice, you have to share them back with the community. Sounds fair? :)

Contact the author if you have any specific need or question regarding licensing.