Home

Ecballium

Fully client-side BDD framework for testing and tutoring

Getting started

This framework is intended for two main tasks:

• To test if you web application works as expected.
• To make animated guide or screencast for your web application.

How it works

1 step Describe your test in human readable form It is easy even if you are non-programmer persons.

    Feature: Demo
    
    Scenario: Press button
      Find button with text "Big Button"
      Click found item
      Check if there is caption "Big Button pressed"

2 step Save you scenario to folder where ecballium is deployed (for example as simple.feature). 3 step Open URL http://www.yoursite.com/test/launcher#simple
Important For the first time your browser will ask you to allow popup from this site.
You should get something like this:

If you use steps only from standard library then it is enough.

4 step (optional) If you want to do something special (something out of standard library scope). You may need to describe your own steps using Javascript or Coffeescript (e.g. file simple.js).

  ecballiumbot.register_handlers([
    [ /^Some special step (.*)/, 
      function(par) {
        do_something(par)
        this.done('success');
      }]);
  
  ecballiumbot.register_aliases({
    'special element link': '#special_element a',
  });

Another useful things here are aliases. They allow to define CSS selectors for test sentences.

How to install

Just download and place ecballium to any folder containing static files for your site. Feature files and step description files should be deployed in the same folder.

How to try

There is developer console for test development in window. You can open it using URL http://www.yoursite.com/test/launcher#console or just launching any feature for testing.
You can try it here.
Just edit scenario and press "Run" button.

See also

Step library
Step implementation
Best practices
Comparison-with-other-frameworks

---

License: LGPL v.3