Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Run your jasmine runner.html headless using node.js. Output the results in several formats including JSON and JUnit XML (good for integration with Jenkins CI).

branch: master

Fetching latest commit…

Octocat-spinner-32-eaf2f5

Cannot retrieve the latest commit at this time

Octocat-spinner-32 bin
Octocat-spinner-32 examples
Octocat-spinner-32 lib
Octocat-spinner-32 node_modules
Octocat-spinner-32 .gitignore
Octocat-spinner-32 .npmignore
Octocat-spinner-32 README.md
Octocat-spinner-32 package.json bumped dependencies to be compatable with node > 0.6.0 March 09, 2012
README.md

node-jasmine-dom

Run your browser-based jasmine specs headless with node.js. Then output in one of many formats such as JSON or JUnit XML (perfect for integration with CI servers like Jenkins).

installation

  1. you've got npm, right?
  2. Groovy. npm install jasmine-dom, and you're away laughing.

usage

Construct your SpecRunner.html as shown in the jasmine examples, then run:

jasmine-dom --runner path/to/SpecRunner.html

or

jasmine-dom --config path/to/config.yaml

You can optionally provide the following arguments:

  • --help, provides usage information
  • --format simple|detailed|nice|json|html|junit, displays the result in the specified format
  • --output path, writes the output to the specified file
  • --server [port], serves a simple (but effective) page showing the current state of the tests. You can also specify an optional --refresh intervalInMS argument to specify the wait between running the tests (because the server is constantly running 'em).
  • --routeconsole, calls to window.console.log (or error, warn, info) within the tests / tested code will be displayed in the terminal output

server

jasmine-dom --runner examples/runner.html --server 8090 --refresh 3000

will run a server on http://localhost:8090/. Here a simple green or red page will reflect the current state of your tests. The tests will run every 3000ms, and the page ajaximatically updates with the result.

If you'd like to see the default jasmine html, visit http://localhost:8090/jasmine. Note, the result is still obtained via the nodejs runner (i.e. it wasn't run in your browser).

specifying runners

A single runner file can be provided via the --runner command. To specify more than one runner, use the --config argument and a yaml config file in the format:

---
  test_one:
    name: This is the name of the first set of tests
    runner: path/to/runner_1.html
  test_two:
    name: This is the name of the second set of tests
    runner: path/to/another/runner.html

The config file allows you to provide names for your runners. These names will be used when identifying failing tests.

example 1

jasmine-dom --runner examples/runner.html

will output:

Failed.

example 2

jasmine-dom --runner examples/runner.html --format junit --output javascript_results.xml

will write to javascript_results.xml:

<testsuite>
    <testcase classname="/Users/andrew/development/node-jasmine-dom/examples/runner.html.Example_functions_that_update_the_DOM.Should_add_two_numbers" name="expect toEqual 7" time="undefined"/>
    <testcase classname="/Users/andrew/development/node-jasmine-dom/examples/runner.html.Example_functions.Should_multiply_two_numbers" name="expect toEqual 40" time="undefined"/>
    <testcase classname="/Users/andrew/development/node-jasmine-dom/examples/runner.html.Example_functions.Should_fail!!" name="expect toEqual 8">
        <failure>
            <![CDATA[
                FAILURE in spec "Should fail!!": Expected 3 to equal 8.
                Error: Expected 3 to equal 8.
                    at new <anonymous> (/Users/andrew/development/node-jasmine-dom/examples/tests/lib/jasmine.js:94:50)
                    at [object Object].toEqual (/Users/andrew/development/node-jasmine-dom/examples/tests/lib/jasmine.js:1138:29)
                    at [object Object].<anonymous> (/Users/andrew/development/node-jasmine-dom/examples/tests/spec/example-functions_spec.js:10:13)
                    at [object Object].execute (/Users/andrew/development/node-jasmine-dom/examples/tests/lib/jasmine.js:968:15)
                    at [object Object].next_ (/Users/andrew/development/node-jasmine-dom/examples/tests/lib/jasmine.js:1739:31)
                    at [object Object].start (/Users/andrew/development/node-jasmine-dom/examples/tests/lib/jasmine.js:1692:8)
                    at [object Object].execute (/Users/andrew/development/node-jasmine-dom/examples/tests/lib/jasmine.js:2018:14)
                    at [object Object].next_ (/Users/andrew/development/node-jasmine-dom/examples/tests/lib/jasmine.js:1739:31)
                    at [object Object].start (/Users/andrew/development/node-jasmine-dom/examples/tests/lib/jasmine.js:1692:8)
                    at [object Object].execute (/Users/andrew/development/node-jasmine-dom/examples/tests/lib/jasmine.js:2163:14)
            ]]>
        </failure>
    </testcase>
</testsuite>

example 3

jasmine-dom --config ./examples/config.yaml --format nice

with ./examples/config.yaml:

---
  test_one:
    name: Example test one
    runner: ./runner.html
  test_two:
    name: Example test two
    runner: ./runner2.html

will output:

====== FAILED ====== 
 - In A suite that fails >> Example functions (should fail) >> Should fail!! :: Expected 3 to equal 8.

example 4

jasmine-dom --config ./examples/config.yaml --format detailed

will output:

====== FAILED ====== 

Example functions (should fail) - 2 tests 
  PASSES 
    - Should multiply two numbers 
  FAILURES 
    - Should fail!! 
        [Expected 3 to equal 8.] 
Example functions that update the DOM - 2 tests 
  PASSES 
    - Should add two numbers 
    - Should divide two numbers 
  FAILURES 
    (none) 

====== FAILED ====== 

changelog

0.3.0 - 22-12-2012 - Added 'detailed' report format. Made examples a bit clearer.

have you seen jasmine-node?

It's provided a lot of inspiration for this project, and may be just what you're looking for. If you're not reliant on a DOM, then it's worth checking out.

Something went wrong with that request. Please try again.