A DSL for functional and E2E website testing
JavaScript Ruby Python
Switch branches/tags
Nothing to show
Clone or download
Alexandr (bumbu) Truhin
Alexandr (bumbu) Truhin Bump
Latest commit da6d2ce Oct 24, 2016
Failed to load latest commit information.
build Init Oct 22, 2016
editors Add syntax highlighting for Sublime Oct 22, 2016
frameworks/intern Pass an settings object to intern DSL Oct 24, 2016
grammar Init Oct 22, 2016
tests Init Oct 22, 2016
.gitignore Init Oct 22, 2016
README.md Add docs for intern tests Oct 22, 2016
index.js Export grammar Oct 22, 2016
package.json Bump Oct 24, 2016


Website spec

A domain specific language (DSL) for functional/E2E web testing.

Spec DSL language example

Supported frameworks

As the DSL is compiled into an intermediary representation, that representations has to be transformed into actual test code.

You can write your own compiler for your preferate test framework, or use one of those that are bundled in:

If you're interested only in the grammar, then you can check grammar.test.js file for examples.

Parsing is done by:

const nearley = require('nearley')
const grammar = require('website-spec').grammar

const p = new nearley.Parser(grammar.ParserRules, grammar.ParserStart)
p.feed('Click on button `.red`') // Pass only single-line text

console.log(p.results) // parsed tree

Syntax highlighting in IDE

Following IDEs syntax highlightings are available:

  • SublimeText 3 - you'll have to install it manually into editor packages' User folder (Preferences -> Browse Packages opens the packages folder).

Build and test

  • Install deps npm install
  • Build npm run build - that will build ant test the grammar

If you want to build or test only then check package.json file for those instructions separately.

Modify the language

The language tries to be fairly simple. Unsuported functionality is expected to be covered with custom instructions (see custom instructions below).

Grammar is written, generated and parsed using nearley.


The DSL supports one instruction per line. Grammar parser expects non-indented lines. So indentation has to be handled in each framework compiler separately. Grammar parser generates a simple flat syntax tree.

Check grammar tests for examples of supported commands and generated trees.

For supported instructions see Intern example