Skip to content

bumbu/website-spec

master
Switch branches/tags
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

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.

Syntax

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

About

A DSL for functional and E2E website testing

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published