/sinon

Test spies, stubs and mocks for JavaScript.

Primary LanguageJavaScriptOtherNOASSERTION

Sinon.JS

Join the chat at https://gitter.im/sinonjs/sinon

Build status bitHound Score

Standalone and test framework agnostic JavaScript test spies, stubs and mocks (pronounced "sigh-non").

Installation

via npm (node package manager)

$ npm install sinon

or via sinon's browser builds available for download on the homepage.

Usage

See the sinon project homepage for documentation on usage.

If you have questions that are not covered by the documentation, please post them to the Sinon.JS mailing list or drop by #sinon.js on irc.freenode.net:6667 or the Gitter channel.

Important: AMD needs pre-built version

Sinon.JS as source doesn't work with AMD loaders (when they're asynchronous, like loading via script tags in the browser). For that you will have to use a pre-built version. You can either build it yourself or get a numbered version from http://sinonjs.org.

This might or might not change in future versions, depending of outcome of investigations. Please don't report this as a bug, just use pre-built versions.

Goals

  • No global pollution
  • Easy to use
  • Require minimal “integration”
  • Easy to embed seamlessly with any testing framework
  • Easily fake any interface
  • Ship with ready-to-use fakes for XMLHttpRequest, timers and more

Contribute?

See CONTRIBUTING.md for details on how you can contribute to Sinon.JS