Chai Assertion Matchers for Backbone.js
CoffeeScript HTML JavaScript Shell
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
test
.gitignore Add Setup for browser testing Jan 6, 2013
.travis.yml Fix tests and keywords Nov 12, 2015
LICENSE extraction of Backbone matchers for Chai plugin and NPM Oct 13, 2012
README.md Convert examples to javascript Nov 12, 2015
chai-backbone.coffee Fix tests and keywords Nov 12, 2015
chai-backbone.js Fix tests and keywords Nov 12, 2015
develop.sh Release 0.8.4 Jan 9, 2013
package.json
test.sh Fix tests and keywords Nov 12, 2015

README.md

chai-backbone

Build Status NPM Version

chai-backbone is an extension to the chai assertion library that provides a set of backbone specific assertions.

Use the assertions with chai's expect or should assertions.

Dependencies

Assertions

trigger

model.should.trigger("change", { with: [model] }).when(function() {
  model.set({ attribute: "value" });
});

this can also be chained further:

model.should.trigger("change").and.trigger("change:attribute").when(function() {
  model.set({ attribute: "value" });
});

model.should.trigger("change").and.not.trigger("reset").when(function() {
  model.set({ attribute: "value" });
});

route.to

Tests if a route is delegated to the correct router and if the arguments are extracted in the expected manner.

"page/3".should.route.to(myRouter, "openPage", { arguments: ["3"] });
"pages/3".should.not.route.to(myRouter, "openPage");
"page/3".should.route.to(myRouter, "openPage", { considering: [conflictingRouter] });

call

This assertion is ideal for testing view callbacks it will rebind view events to test DOM events

view.should.call('startAuthentication').when(function() {
  view.$('a.login').trigger('click');
});

Installation and Setup

Node

Do an npm install chai-backbone to get up and running. Then:

var chai = require("chai");
var chaiBackbone = require("chai-backbone");

chai.use(chaiBackbone);

You can of course put this code in a common test fixture file; for an example using Mocha

AMD

Chai Backbone supports being used as an AMD module, registering itself anonymously (just like Chai). So, assuming you have configured your loader to map the Chai and Chai Backbone files to the respective module IDs "chai" and "chai-backbone", you can use them as follows:

define(function (require, exports, module) {
    var chai = require("chai");
    var chaiBackbone = require("chai-backbone");

    chai.use(chaiBackbone);
});

<script> tag

If you include Chai Backbone directly with a <script> tag, after the one for Chai itself, then it will automatically plug in to Chai and be ready for use:

<script src="chai.js"></script>
<script src="chai-backbone.js"></script>

License

Copyright (c) 2012-2015 Matthijs Groen

MIT License (see the LICENSE file)