Sinon

Creating spies

fn = sinon.spy();

fn();
fn.calledOnce == true
fn.callCount == 1

Spying/stubbing

sinon.spy($, 'ajax')

$.ajax();
$.ajax.calledOnce == true

sinon.stub($, 'ajax', function () { ... }); // function optional

$.ajax.calledWithMatch({ url: '/x' });
$.ajax.restore();

Spy/stub properties

spy
  .args        //=> [ [..], [..] ] one per call
  .thisValues
  .returnValues

  .called      //=> true
  .notCalled
  .callCount
  .calledOnce
  .calledTwice
  .calledThrice

  .getCalls()   //=> Array
  .getCall(0)
  .firstCall

Anonymous stub

stub = sinon.stub().returns(42);
stub() == 42

stub
  .withArgs(42).returns(1);
  .withArgs(43).throws("TypeError");

stub
  .returns(1);
  .throws("TypeError");
  .returnsArg(0); // Return 1st argument
  .callsArg(0);

Fake date

sinon.useFakeTimers(+new Date(2011,9,1));

Fake server

server = sinon.fakeServer.create();

$.get('/file.json', ...);
server.requests[0].respond(
    200,
    { "Content-Type": "application/json" },
    JSON.stringify([{ id: 1, text: "Provide examples", done: true }])
);

server.restore();

Fake XHR

xhr = sinon.useFakeXMLHttpRequest();
xhr.restore();

Sandbox

beforeEach(function() {
  global.sinon = require('sinon').sandbox.create();
});

afterEach(function() {
  global.sinon.restore();
});