Skip to content
master
Go to file
Code

Latest commit

 

Git stats

Files

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

README.md

Namespaced Jasmine Suites

Overview

This extends Jasmine 1.4.x by making it easy to create nested, reusable namespaces for test suites.

Typically, a large codebase using Jasmine will split tests into multiple files, each with a describe() call wrapping the file's tests. This works fine for small sets of tests, but on a larger codebase, it leaves much to be desired. There's no way to organize tests across files under a common suite, or to limit the test run to those tests.

Namespaced suites solve this by taking a namespaced path (something like projectname/mysuite/component) and automatically generating test suites for each component of the namespace. It will also merge any tests in that refer to the same parts of the namespace from other files.

Usage

Switching to namespaced suites is really easy. Instead of doing this:

describe('projectname/mysuite/component', function() {
    ...
});

or:

describe('projectname', function() {
    describe('mysuite', function() {
        describe('component', function() {
           ...
        });
    });
});

You can instead do:

suite('projectname/mysuite/component', function() {
   ...
});

You can reuse any part of that namespace in as many files as you like. Their tests will be combined into the suites.

For example, say you have the following:

// tests1.js
suite('projectname/models/MyModel', function() {
   ...
});

suite('projectname/views/MyView', function() {
   ...
});


// tests2.js
suite('projectname/views/AnotherView', function() {
   ...
});

Jasmine will end up laying out the tests like:

projectname

    models

    views

        MyView

        AnotherView

Where is this used?

We use jasmine-suites at Beanbag for our Review Board and RBCommons products.

If you use jasmine-suites, let us know and we'll add you to a shiny new list on this page.

License

Jasmine Suites is under the MIT license.

About

Namespaced, reusable test suites for Jasmine

Resources

Releases

No releases published

Packages

No packages published
You can’t perform that action at this time.