EnvJasmine allows you to run headless JavaScript tests.

Add your Jasmine Spec files to the specs directory to be run.

IMPORTANT: Make sure to load the file you are planning to test as the first line of the spec file using the EnvJasmine.load("file.js"); function.

To run the JavaScript test suite, execute the following:

bin/run_all_tests.sh

To run an individual spec file, execute the following:

bin/run_test.sh specs/[your spec file].js

In Windows you do the same by running:

bin/run_all_tests.bat

bin/run_test.bat specs/[your spec file].js

Sometimes you will have libraries that you need to load for any of your JavaScript files to work. To make sure these are loaded before your tests are run, include them in the include/dependencies.js file using the EnvJasmine.load("file.js"); function.

You can alsodefine a custom config file location to replace include/dependencies.js by calling run_test or run_all_tests with the --configFile=<config js file> option.

• JavaScript BDD, with Jasmine, without a browser
• Rhino
• EnvJS
• Jasmine
• Jasmine Jquery

Originally created by Jeff Avallone and Trevor Lalish-Menagh. See LICENSE for lincensing information.

See CHANGELOG for changelog information.

Current version is found in the VERSION file.

How to set up EnvJasmine within a basic web project. Note that this tutorial assumes you’re working within a *nix environment.

Create a directory in which to house your project. Let’s call this demo. After creating the directory, enter it:

mkdir demo
cd demo

Create a js directory inside demo to house JavaScript files:

mkdir js

Create a directory in demo to house your tests. As is often customary, let’s call this directory tests:

mkdir tests

Clone EnvJasmine into your tests directory:

git clone https://github.com/trevmex/EnvJasmine.git tests/EnvJasmine

or

git clone git://github.com/trevmex/EnvJasmine.git tests/EnvJasmine

For the purposes of this example, let’s assume we need to create some JavaScript that adds two numbers and returns their sum. Let’s create a JavaScript file to house this code:

touch js/add-numbers.js

Create an EnvJasmine spec file, inside of which we’ll write a test against the functionality of js/add-numbers.js:

touch tests/EnvJasmine/specs/add-numbers.spec.js

Inside tests/EnvJasmine/specs/add-numbers.spec.js, let’s load the file containing the code we’re testing, in this case js/add-numbers.js. This can be done by adding the following line:

EnvJasmine.load(EnvJasmine.jsDir   "/add-numbers.js");

But what’s this EnvJasmine.jsDir business? It’s a configuration variable used to define the primary directory housing your JavaScript. It’s defined in tests/EnvJasmine/include/dependencies.js and defaults to a top-level directory of js. Change this if you’re using a different scheme:

mkdir -p tests/EnvJasmine/etc/conf

cp tests/EnvJasmine/include/dependencies.js tests/EnvJasmine/etc/conf/demo.conf.js

And edit the following line:

EnvJasmine.jsDir = EnvJasmine.rootDir   "/../../js";

in tests/EnvJasmine/etc/conf/demo.conf.js with your favourite text editor.

Please note the need for the leading slash.

In add-numbers.spec.js, sketch out the basic framework for a unit test against the functionality within js/add-numbers.js. Let’s assume this file contains a single function, addNumbers():

describe("addNumbers", function () {
    it("returns the sum of the two integers it's passed", function() {
        // test specifics will go here
    });
});

Utilizing Jasmine syntax and matchers, write the code testing the expected behavior of addNumbers():

describe("addNumbers", function () {
    it("returns the sum of the two integers it's passed", function() {
        expect(addNumbers(1, 2)).toEqual(3);
    });
});

Run the test from the command line:

./tests/EnvJasmine/bin/run_test.sh --configFile=</absolute/path/to/demo/tests/EnvJasmine/etc/conf/demo.conf.js> specs/add-numbers.spec.js

Note that the above command will run just the add-numbers.spec.js code.

Also note that at this stage, the test should fail as we have not yet written the addNumbers() function.

Write just enough code in js/add-numbers.js to make the test pass:

function addNumbers(a, b) {
    return a   b;
}

Run the test again and confirm that it passes:

./tests/EnvJasmine/bin/run_test.sh --configFile=</absolute/path/to/demo/tests/EnvJasmine/etc/conf/demo.conf.js> specs/add-numbers.spec.js

See lib/jscover/README.textile

EnvJasmine can also be compiled to a Ruby gem.

Note that, when used as a Ruby gem, EnvJasmine requires a few command line arguments be specified.

Here is a Ruby usage example:

That’s it! For more help on Jasmine docs at https://github.com/jasmine/jasmine/wiki

Please contact Trevor Lalish-Menagh through github (https://github.com/trevmex) with any defects or feature requests!