A minimalist AMD stubbing library for use in testing.

This requires ES5 support. Therefore IE8 and prior are not supported.

The main way to use sutabu is to generate stub functions. Generating a new stub function looks like this:

define([ 'sutabu/stub' ], function (stub) {
	var stubFunc = stub();
	var result = stubFunc();

	console.log(stubFunc.callCount); // outputs: 1
});

Each generated stub function contains 3 non-emurable properties that dictate how the stub behaves. If any of these are set, they will be processed when the function is invoked and returned:

When a new stub function is created, you can pass a single argument that will define how the stub behaves when called. If you pass an instance of Error it will assigned to .throws, if you pass a function, it will be assigned to .calls and if you pass any other type of argument, it is assigned to .returns.

If you want to specifically stub a function, you can call stub.func(). Basic usage is something like this:

define([ 'sutabu/stub' ], function (stub) {
	var obj = {};

	var handle = stub.func(obj, 'foo', function () {
		return 'bar';
	});

	console.log(obj.foo()); // outputs: 'bar'
	console.log(obj.foo.callCount); // outputs: 1

	handle.remove(); // removes the stub
});

Testing is done via The Intern and uses Grunt for task automation. To run the unit tests, first install the prerequisites via npm:

npm install

To run the unit tests locally, against Node:

grunt test:node

To run the tests using SauceLabs, assuming you have your SauceLabs credentials available in the environment:

grunt test