Skip to content

Latest commit

 

History

History
62 lines (45 loc) · 1.82 KB

README.md

File metadata and controls

62 lines (45 loc) · 1.82 KB
Raw

steel

steel is a small Javascript library that adds a QUnit-like testing interface for various JavaScript runtimes.

Motivation

JavaScript is primarily a browser-based scripting language, but is commonly used for server-side applications. Your app might even run the exact same JavaScript code on the server and client. Wouldn't it be nice if you could easily run the exacty same unit tests in your server runtime as your traditional QUnit browser tests?

Supported JavaScript Runtimes

Example

Add the following preamble and postamble to your QUnit tests.

// preamble
if (typeof require !== 'undefined') {
  var QUnit = require('../lib/steel'); // commonjs
} else if (typeof(load) !== 'undefined') {
  var QUnit = load('lib/steel.js'); // jsc
}

with (QUnit) {
  // your tests here
}

// postamble
if (QUnit.run) QUnit.run(typeof exports !== 'undefined' ? exports : undefined);

Demo

You can run all tests.

$ node demo/all.js
+ Running
  + Running test test addition
  + Running test test multiplication
Passes: 2, Fails: 0, Errors: 0
+ Running
  + Running test test concatenation
  + Running test test substring
Passes: 2, Fails: 0, Errors: 0

Or just one test.

$ node demo/math.js 
+ Running
  + Running test test addition
  + Running test test multiplication
Passes: 2, Fails: 0, Errors: 0

Narwhal has a special syntax for running a single test.

$ narwhal -m test demo/math.js 
+ Running /Users/john/Sites/steel/demo/math.js
  + Running test addition
  + Running test multiplication
Passes: 2, Fails: 0, Errors: 0