tapestry v0.0.0

A minimal JavaScript testing framework for frontends and backends.

Goals

0. Easy to test with.
1. Easy to extend.
2. Handle sync/async tests.
3. Group tests into suites.
4. Enable nesting test suites.
5. Skippable tests / suites. Conditionally skip tests (For example, if network is unavailable).
6. 'Todo' tests / suites. Write tests before the tested feature is ready, and mark the test as 'todo'. The test may fail, but it won't count until the feature is actually implemented.
7. Suites are runnable scripts.
8. Run both in browser and node.
9. Have an optional TAP reporter.

Demo

See demo.js for current functionalities.

Run it with different reporters:

• node demo/demo --tree
• node demo/demo --TAP

Output of demo script on Node:

Output of demo script on the browser (using browserify);

Usage & API

0. Tests are grouped into suites.

1. Suites are defined with suite( ... ).

   suite("suite's description", function(test, suite){
       // ...
   });

2. Suites can be nested.

   suite("suite's description", function(test, suite){
   
       suite("nested suite", function(test, suite){
           // ...
       });
   
       suite("another nested suite", function(test, suite){
           // ...
       });
   
   });

3. Tests can be synchronous.

   suite("suite's description", function(test, suite){
   
       test("a sync test", function(){
           throw Error("This test will fail!");
       });
   
   });

4. Tests can be asynchronous.

   suite("suite's description", function(test, suite){
   
       test("a sync test", function(t){
           setTimout(function(){
               t.notOK("This test will fail!");
           }, 100);
       });
   
   });

5. Async tests may throw exceptions to indicate failure.

   suite("suite's description", function(test, suite){
   
       test("a sync test", function(t){
           setTimout(function(){
               throw Error("This test will fail!");
           }, 100);
       });
   
   });

   But remember to indicate the test is async by passing the t parameter.