diff --git a/build/minify.js b/build/minify.js index c435f0c532..88acedb21d 100755 --- a/build/minify.js +++ b/build/minify.js @@ -26,7 +26,7 @@ var closureId = 'a95a8007892aa824ce90c6aa3d3abb0489bf0fff'; /** The Git object ID of `uglifyjs.tar.gz` */ - var uglifyId = '548bf495606eb4046c4573b1107f0225e274e1e1'; + var uglifyId = '41308bd569db41a32d4f08af115875d0342e8bfb'; /** The path of the directory that is the base of the repository */ var basePath = fs.realpathSync(path.join(__dirname, '..')); @@ -455,6 +455,7 @@ toplevel.figure_out_scope(); toplevel = toplevel.transform(uglifyJS.Compressor({ 'comparisons': false, + 'unsafe': true, 'unsafe_comps': true, 'warnings': false })); diff --git a/vendor/backbone/LICENSE b/vendor/backbone/LICENSE index f79bb00587..dda0a5809d 100644 --- a/vendor/backbone/LICENSE +++ b/vendor/backbone/LICENSE @@ -1,4 +1,4 @@ -Copyright (c) 2010-2012 Jeremy Ashkenas, DocumentCloud +Copyright (c) 2010-2013 Jeremy Ashkenas, DocumentCloud Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation @@ -19,4 +19,4 @@ NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -OTHER DEALINGS IN THE SOFTWARE. \ No newline at end of file +OTHER DEALINGS IN THE SOFTWARE. diff --git a/vendor/backbone/backbone.js b/vendor/backbone/backbone.js index 9682be585c..3512d42fb4 100644 --- a/vendor/backbone/backbone.js +++ b/vendor/backbone/backbone.js @@ -1,6 +1,6 @@ -// Backbone.js 0.9.10 +// Backbone.js 1.0.0 -// (c) 2010-2012 Jeremy Ashkenas, DocumentCloud Inc. +// (c) 2010-2013 Jeremy Ashkenas, DocumentCloud Inc. // Backbone may be freely distributed under the MIT license. // For all details and documentation: // http://backbonejs.org @@ -18,14 +18,14 @@ // restored later on, if `noConflict` is used. var previousBackbone = root.Backbone; - // Create a local reference to array methods. + // Create local references to array methods we'll want to use later. var array = []; var push = array.push; var slice = array.slice; var splice = array.splice; // The top-level namespace. All public Backbone classes and modules will - // be attached to this. Exported for both CommonJS and the browser. + // be attached to this. Exported for both the browser and the server. var Backbone; if (typeof exports !== 'undefined') { Backbone = exports; @@ -34,14 +34,15 @@ } // Current version of the library. Keep in sync with `package.json`. - Backbone.VERSION = '0.9.10'; + Backbone.VERSION = '1.0.0'; // Require Underscore, if we're on the server, and it's not already present. var _ = root._; if (!_ && (typeof require !== 'undefined')) _ = require('underscore'); - // For Backbone's purposes, jQuery, Zepto, or Ender owns the `$` variable. - Backbone.$ = root.jQuery || root.Zepto || root.ender; + // For Backbone's purposes, jQuery, Zepto, Ender, or My Library (kidding) owns + // the `$` variable. + Backbone.$ = root.jQuery || root.Zepto || root.ender || root.$; // Runs Backbone.js in *noConflict* mode, returning the `Backbone` variable // to its previous owner. Returns a reference to this Backbone object. @@ -64,45 +65,6 @@ // Backbone.Events // --------------- - // Regular expression used to split event strings. - var eventSplitter = /\s+/; - - // Implement fancy features of the Events API such as multiple event - // names `"change blur"` and jQuery-style event maps `{change: action}` - // in terms of the existing API. - var eventsApi = function(obj, action, name, rest) { - if (!name) return true; - if (typeof name === 'object') { - for (var key in name) { - obj[action].apply(obj, [key, name[key]].concat(rest)); - } - } else if (eventSplitter.test(name)) { - var names = name.split(eventSplitter); - for (var i = 0, l = names.length; i < l; i++) { - obj[action].apply(obj, [names[i]].concat(rest)); - } - } else { - return true; - } - }; - - // Optimized internal dispatch function for triggering events. Tries to - // keep the usual cases speedy (most Backbone events have 3 arguments). - var triggerEvents = function(events, args) { - var ev, i = -1, l = events.length; - switch (args.length) { - case 0: while (++i < l) (ev = events[i]).callback.call(ev.ctx); - return; - case 1: while (++i < l) (ev = events[i]).callback.call(ev.ctx, args[0]); - return; - case 2: while (++i < l) (ev = events[i]).callback.call(ev.ctx, args[0], args[1]); - return; - case 3: while (++i < l) (ev = events[i]).callback.call(ev.ctx, args[0], args[1], args[2]); - return; - default: while (++i < l) (ev = events[i]).callback.apply(ev.ctx, args); - } - }; - // A module that can be mixed in to *any object* in order to provide it with // custom events. You may bind with `on` or remove with `off` callback // functions to an event; `trigger`-ing an event fires all callbacks in @@ -115,29 +77,27 @@ // var Events = Backbone.Events = { - // Bind one or more space separated events, or an events map, - // to a `callback` function. Passing `"all"` will bind the callback to - // all events fired. + // Bind an event to a `callback` function. Passing `"all"` will bind + // the callback to all events fired. on: function(name, callback, context) { - if (!(eventsApi(this, 'on', name, [callback, context]) && callback)) return this; + if (!eventsApi(this, 'on', name, [callback, context]) || !callback) return this; this._events || (this._events = {}); - var list = this._events[name] || (this._events[name] = []); - list.push({callback: callback, context: context, ctx: context || this}); + var events = this._events[name] || (this._events[name] = []); + events.push({callback: callback, context: context, ctx: context || this}); return this; }, - // Bind events to only be triggered a single time. After the first time + // Bind an event to only be triggered a single time. After the first time // the callback is invoked, it will be removed. once: function(name, callback, context) { - if (!(eventsApi(this, 'once', name, [callback, context]) && callback)) return this; + if (!eventsApi(this, 'once', name, [callback, context]) || !callback) return this; var self = this; var once = _.once(function() { self.off(name, once); callback.apply(this, arguments); }); once._callback = callback; - this.on(name, once, context); - return this; + return this.on(name, once, context); }, // Remove one or many callbacks. If `context` is null, removes all @@ -145,7 +105,7 @@ // callbacks for the event. If `name` is null, removes all bound // callbacks for all events. off: function(name, callback, context) { - var list, ev, events, names, i, l, j, k; + var retain, ev, events, names, i, l, j, k; if (!this._events || !eventsApi(this, 'off', name, [callback, context])) return this; if (!name && !callback && !context) { this._events = {}; @@ -155,19 +115,18 @@ names = name ? [name] : _.keys(this._events); for (i = 0, l = names.length; i < l; i++) { name = names[i]; - if (list = this._events[name]) { - events = []; + if (events = this._events[name]) { + this._events[name] = retain = []; if (callback || context) { - for (j = 0, k = list.length; j < k; j++) { - ev = list[j]; - if ((callback && callback !== ev.callback && - callback !== ev.callback._callback) || + for (j = 0, k = events.length; j < k; j++) { + ev = events[j]; + if ((callback && callback !== ev.callback && callback !== ev.callback._callback) || (context && context !== ev.context)) { - events.push(ev); + retain.push(ev); } } } - this._events[name] = events; + if (!retain.length) delete this._events[name]; } } @@ -189,35 +148,82 @@ return this; }, - // An inversion-of-control version of `on`. Tell *this* object to listen to - // an event in another object ... keeping track of what it's listening to. - listenTo: function(obj, name, callback) { - var listeners = this._listeners || (this._listeners = {}); - var id = obj._listenerId || (obj._listenerId = _.uniqueId('l')); - listeners[id] = obj; - obj.on(name, typeof name === 'object' ? this : callback, this); - return this; - }, - // Tell this object to stop listening to either specific events ... or // to every object it's currently listening to. stopListening: function(obj, name, callback) { var listeners = this._listeners; - if (!listeners) return; - if (obj) { - obj.off(name, typeof name === 'object' ? this : callback, this); - if (!name && !callback) delete listeners[obj._listenerId]; - } else { - if (typeof name === 'object') callback = this; - for (var id in listeners) { - listeners[id].off(name, callback, this); - } - this._listeners = {}; + if (!listeners) return this; + var deleteListener = !name && !callback; + if (typeof name === 'object') callback = this; + if (obj) (listeners = {})[obj._listenerId] = obj; + for (var id in listeners) { + listeners[id].off(name, callback, this); + if (deleteListener) delete this._listeners[id]; } return this; } + + }; + + // Regular expression used to split event strings. + var eventSplitter = /\s+/; + + // Implement fancy features of the Events API such as multiple event + // names `"change blur"` and jQuery-style event maps `{change: action}` + // in terms of the existing API. + var eventsApi = function(obj, action, name, rest) { + if (!name) return true; + + // Handle event maps. + if (typeof name === 'object') { + for (var key in name) { + obj[action].apply(obj, [key, name[key]].concat(rest)); + } + return false; + } + + // Handle space separated event names. + if (eventSplitter.test(name)) { + var names = name.split(eventSplitter); + for (var i = 0, l = names.length; i < l; i++) { + obj[action].apply(obj, [names[i]].concat(rest)); + } + return false; + } + + return true; + }; + + // A difficult-to-believe, but optimized internal dispatch function for + // triggering events. Tries to keep the usual cases speedy (most internal + // Backbone events have 3 arguments). + var triggerEvents = function(events, args) { + var ev, i = -1, l = events.length, a1 = args[0], a2 = args[1], a3 = args[2]; + switch (args.length) { + case 0: while (++i < l) (ev = events[i]).callback.call(ev.ctx); return; + case 1: while (++i < l) (ev = events[i]).callback.call(ev.ctx, a1); return; + case 2: while (++i < l) (ev = events[i]).callback.call(ev.ctx, a1, a2); return; + case 3: while (++i < l) (ev = events[i]).callback.call(ev.ctx, a1, a2, a3); return; + default: while (++i < l) (ev = events[i]).callback.apply(ev.ctx, args); + } }; + var listenMethods = {listenTo: 'on', listenToOnce: 'once'}; + + // Inversion-of-control versions of `on` and `once`. Tell *this* object to + // listen to an event in another object ... keeping track of what it's + // listening to. + _.each(listenMethods, function(implementation, method) { + Events[method] = function(obj, name, callback) { + var listeners = this._listeners || (this._listeners = {}); + var id = obj._listenerId || (obj._listenerId = _.uniqueId('l')); + listeners[id] = obj; + if (typeof name === 'object') callback = this; + obj[implementation](name, callback, this); + return this; + }; + }); + // Aliases for backwards compatibility. Events.bind = Events.on; Events.unbind = Events.off; @@ -229,15 +235,21 @@ // Backbone.Model // -------------- - // Create a new model, with defined attributes. A client id (`cid`) + // Backbone **Models** are the basic data object in the framework -- + // frequently representing a row in a table in a database on your server. + // A discrete chunk of data and a bunch of useful, related methods for + // performing computations and transformations on that data. + + // Create a new model with the specified attributes. A client id (`cid`) // is automatically generated and assigned for you. var Model = Backbone.Model = function(attributes, options) { var defaults; var attrs = attributes || {}; + options || (options = {}); this.cid = _.uniqueId('c'); this.attributes = {}; - if (options && options.collection) this.collection = options.collection; - if (options && options.parse) attrs = this.parse(attrs, options) || {}; + _.extend(this, _.pick(options, modelOptions)); + if (options.parse) attrs = this.parse(attrs, options) || {}; if (defaults = _.result(this, 'defaults')) { attrs = _.defaults({}, attrs, defaults); } @@ -246,12 +258,18 @@ this.initialize.apply(this, arguments); }; + // A list of options to be attached directly to the model, if provided. + var modelOptions = ['url', 'urlRoot', 'collection']; + // Attach all inheritable methods to the Model prototype. _.extend(Model.prototype, Events, { // A hash of attributes whose current and previous value differ. changed: null, + // The value returned during the last failed validation. + validationError: null, + // The default name for the JSON `id` attribute is `"id"`. MongoDB and // CouchDB users may want to set this to `"_id"`. idAttribute: 'id', @@ -265,7 +283,8 @@ return _.clone(this.attributes); }, - // Proxy `Backbone.sync` by default. + // Proxy `Backbone.sync` by default -- but override this if you need + // custom syncing semantics for *this* particular model. sync: function() { return Backbone.sync.apply(this, arguments); }, @@ -286,10 +305,9 @@ return this.get(attr) != null; }, - // ---------------------------------------------------------------------- - - // Set a hash of model attributes on the object, firing `"change"` unless - // you choose to silence it. + // Set a hash of model attributes on the object, firing `"change"`. This is + // the core primitive operation of a model, updating the data and notifying + // anyone who needs to know about the change in state. The heart of the beast. set: function(key, val, options) { var attr, attrs, unset, changes, silent, changing, prev, current; if (key == null) return this; @@ -343,6 +361,8 @@ } } + // You might be wondering why there's a `while` loop here. Changes can + // be recursively nested within `"change"` events. if (changing) return this; if (!silent) { while (this._pending) { @@ -355,14 +375,13 @@ return this; }, - // Remove an attribute from the model, firing `"change"` unless you choose - // to silence it. `unset` is a noop if the attribute doesn't exist. + // Remove an attribute from the model, firing `"change"`. `unset` is a noop + // if the attribute doesn't exist. unset: function(attr, options) { return this.set(attr, void 0, _.extend({}, options, {unset: true})); }, - // Clear all attributes on the model, firing `"change"` unless you choose - // to silence it. + // Clear all attributes on the model, firing `"change"`. clear: function(options) { var attrs = {}; for (var key in this.attributes) attrs[key] = void 0; @@ -406,19 +425,20 @@ return _.clone(this._previousAttributes); }, - // --------------------------------------------------------------------- - // Fetch the model from the server. If the server's representation of the - // model differs from its current attributes, they will be overriden, + // model differs from its current attributes, they will be overridden, // triggering a `"change"` event. fetch: function(options) { options = options ? _.clone(options) : {}; if (options.parse === void 0) options.parse = true; + var model = this; var success = options.success; - options.success = function(model, resp, options) { + options.success = function(resp) { if (!model.set(model.parse(resp, options), options)) return false; if (success) success(model, resp, options); + model.trigger('sync', model, resp, options); }; + wrapError(this, options); return this.sync('read', this, options); }, @@ -426,7 +446,7 @@ // If the server returns an attributes hash that differs, the model's // state will be `set` again. save: function(key, val, options) { - var attrs, success, method, xhr, attributes = this.attributes; + var attrs, method, xhr, attributes = this.attributes; // Handle both `"key", value` and `{key: value}` -style arguments. if (key == null || typeof key === 'object') { @@ -452,8 +472,9 @@ // After a successful server-side save, the client is (optionally) // updated with the server-side state. if (options.parse === void 0) options.parse = true; - success = options.success; - options.success = function(model, resp, options) { + var model = this; + var success = options.success; + options.success = function(resp) { // Ensure attributes are restored during synchronous saves. model.attributes = attributes; var serverAttrs = model.parse(resp, options); @@ -462,9 +483,10 @@ return false; } if (success) success(model, resp, options); + model.trigger('sync', model, resp, options); }; + wrapError(this, options); - // Finish configuring and sending the Ajax request. method = this.isNew() ? 'create' : (options.patch ? 'patch' : 'update'); if (method === 'patch') options.attrs = attrs; xhr = this.sync(method, this, options); @@ -487,15 +509,17 @@ model.trigger('destroy', model, model.collection, options); }; - options.success = function(model, resp, options) { + options.success = function(resp) { if (options.wait || model.isNew()) destroy(); if (success) success(model, resp, options); + if (!model.isNew()) model.trigger('sync', model, resp, options); }; if (this.isNew()) { - options.success(this, null, options); + options.success(); return false; } + wrapError(this, options); var xhr = this.sync('delete', this, options); if (!options.wait) destroy(); @@ -529,39 +553,61 @@ // Check if the model is currently in a valid state. isValid: function(options) { - return !this.validate || !this.validate(this.attributes, options); + return this._validate({}, _.extend(options || {}, { validate: true })); }, // Run validation against the next complete set of model attributes, - // returning `true` if all is well. Otherwise, fire a general - // `"error"` event and call the error callback, if specified. + // returning `true` if all is well. Otherwise, fire an `"invalid"` event. _validate: function(attrs, options) { if (!options.validate || !this.validate) return true; attrs = _.extend({}, this.attributes, attrs); var error = this.validationError = this.validate(attrs, options) || null; if (!error) return true; - this.trigger('invalid', this, error, options || {}); + this.trigger('invalid', this, error, _.extend(options || {}, {validationError: error})); return false; } }); + // Underscore methods that we want to implement on the Model. + var modelMethods = ['keys', 'values', 'pairs', 'invert', 'pick', 'omit']; + + // Mix in each Underscore method as a proxy to `Model#attributes`. + _.each(modelMethods, function(method) { + Model.prototype[method] = function() { + var args = slice.call(arguments); + args.unshift(this.attributes); + return _[method].apply(_, args); + }; + }); + // Backbone.Collection // ------------------- - // Provides a standard collection class for our sets of models, ordered - // or unordered. If a `comparator` is specified, the Collection will maintain + // If models tend to represent a single row of data, a Backbone Collection is + // more analagous to a table full of data ... or a small slice or page of that + // table, or a collection of rows that belong together for a particular reason + // -- all of the messages in this particular folder, all of the documents + // belonging to this particular author, and so on. Collections maintain + // indexes of their models, both in order, and for lookup by `id`. + + // Create a new **Collection**, perhaps to contain a specific type of `model`. + // If a `comparator` is specified, the Collection will maintain // its models in sort order, as they're added and removed. var Collection = Backbone.Collection = function(models, options) { options || (options = {}); + if (options.url) this.url = options.url; if (options.model) this.model = options.model; if (options.comparator !== void 0) this.comparator = options.comparator; - this.models = []; this._reset(); this.initialize.apply(this, arguments); if (models) this.reset(models, _.extend({silent: true}, options)); }; + // Default options for `Collection#set`. + var setOptions = {add: true, remove: true, merge: true}; + var addOptions = {add: true, merge: false, remove: false}; + // Define the Collection's inheritable methods. _.extend(Collection.prototype, Events, { @@ -586,88 +632,118 @@ // Add a model, or list of models to the set. add: function(models, options) { + return this.set(models, _.defaults(options || {}, addOptions)); + }, + + // Remove a model, or a list of models from the set. + remove: function(models, options) { models = _.isArray(models) ? models.slice() : [models]; options || (options = {}); - var i, l, model, attrs, existing, doSort, add, at, sort, sortAttr; - add = []; - at = options.at; - sort = this.comparator && (at == null) && options.sort != false; - sortAttr = _.isString(this.comparator) ? this.comparator : null; + var i, l, index, model; + for (i = 0, l = models.length; i < l; i++) { + model = this.get(models[i]); + if (!model) continue; + delete this._byId[model.id]; + delete this._byId[model.cid]; + index = this.indexOf(model); + this.models.splice(index, 1); + this.length--; + if (!options.silent) { + options.index = index; + model.trigger('remove', model, this, options); + } + this._removeReference(model); + } + return this; + }, + + // Update a collection by `set`-ing a new list of models, adding new ones, + // removing models that are no longer present, and merging models that + // already exist in the collection, as necessary. Similar to **Model#set**, + // the core operation for updating the data contained by the collection. + set: function(models, options) { + options = _.defaults(options || {}, setOptions); + if (options.parse) models = this.parse(models, options); + if (!_.isArray(models)) models = models ? [models] : []; + var i, l, model, attrs, existing, sort; + var at = options.at; + var sortable = this.comparator && (at == null) && options.sort !== false; + var sortAttr = _.isString(this.comparator) ? this.comparator : null; + var toAdd = [], toRemove = [], modelMap = {}; // Turn bare objects into model references, and prevent invalid models // from being added. for (i = 0, l = models.length; i < l; i++) { - if (!(model = this._prepareModel(attrs = models[i], options))) { - this.trigger('invalid', this, attrs, options); - continue; - } + if (!(model = this._prepareModel(models[i], options))) continue; // If a duplicate is found, prevent it from being added and // optionally merge it into the existing model. if (existing = this.get(model)) { + if (options.remove) modelMap[existing.cid] = true; if (options.merge) { - existing.set(attrs === model ? model.attributes : attrs, options); - if (sort && !doSort && existing.hasChanged(sortAttr)) doSort = true; + existing.set(model.attributes, options); + if (sortable && !sort && existing.hasChanged(sortAttr)) sort = true; } - continue; - } - // This is a new model, push it to the `add` list. - add.push(model); + // This is a new model, push it to the `toAdd` list. + } else if (options.add) { + toAdd.push(model); - // Listen to added models' events, and index models for lookup by - // `id` and by `cid`. - model.on('all', this._onModelEvent, this); - this._byId[model.cid] = model; - if (model.id != null) this._byId[model.id] = model; + // Listen to added models' events, and index models for lookup by + // `id` and by `cid`. + model.on('all', this._onModelEvent, this); + this._byId[model.cid] = model; + if (model.id != null) this._byId[model.id] = model; + } + } + + // Remove nonexistent models if appropriate. + if (options.remove) { + for (i = 0, l = this.length; i < l; ++i) { + if (!modelMap[(model = this.models[i]).cid]) toRemove.push(model); + } + if (toRemove.length) this.remove(toRemove, options); } // See if sorting is needed, update `length` and splice in new models. - if (add.length) { - if (sort) doSort = true; - this.length += add.length; + if (toAdd.length) { + if (sortable) sort = true; + this.length += toAdd.length; if (at != null) { - splice.apply(this.models, [at, 0].concat(add)); + splice.apply(this.models, [at, 0].concat(toAdd)); } else { - push.apply(this.models, add); + push.apply(this.models, toAdd); } } // Silently sort the collection if appropriate. - if (doSort) this.sort({silent: true}); + if (sort) this.sort({silent: true}); if (options.silent) return this; // Trigger `add` events. - for (i = 0, l = add.length; i < l; i++) { - (model = add[i]).trigger('add', model, this, options); + for (i = 0, l = toAdd.length; i < l; i++) { + (model = toAdd[i]).trigger('add', model, this, options); } // Trigger `sort` if the collection was sorted. - if (doSort) this.trigger('sort', this, options); - + if (sort) this.trigger('sort', this, options); return this; }, - // Remove a model, or a list of models from the set. - remove: function(models, options) { - models = _.isArray(models) ? models.slice() : [models]; + // When you have more items than you want to add or remove individually, + // you can reset the entire set with a new list of models, without firing + // any granular `add` or `remove` events. Fires `reset` when finished. + // Useful for bulk operations and optimizations. + reset: function(models, options) { options || (options = {}); - var i, l, index, model; - for (i = 0, l = models.length; i < l; i++) { - model = this.get(models[i]); - if (!model) continue; - delete this._byId[model.id]; - delete this._byId[model.cid]; - index = this.indexOf(model); - this.models.splice(index, 1); - this.length--; - if (!options.silent) { - options.index = index; - model.trigger('remove', model, this, options); - } - this._removeReference(model); + for (var i = 0, l = this.models.length; i < l; i++) { + this._removeReference(this.models[i]); } + options.previousModels = this.models; + this._reset(); + this.add(models, _.extend({silent: true}, options)); + if (!options.silent) this.trigger('reset', this, options); return this; }, @@ -707,8 +783,7 @@ // Get a model from the set by id. get: function(obj) { if (obj == null) return void 0; - this._idAttr || (this._idAttr = this.model.prototype.idAttribute); - return this._byId[obj.id || obj.cid || obj[this._idAttr] || obj]; + return this._byId[obj.id != null ? obj.id : obj.cid || obj]; }, // Get the model at the given index. @@ -716,10 +791,11 @@ return this.models[index]; }, - // Return models with matching attributes. Useful for simple cases of `filter`. - where: function(attrs) { - if (_.isEmpty(attrs)) return []; - return this.filter(function(model) { + // Return models with matching attributes. Useful for simple cases of + // `filter`. + where: function(attrs, first) { + if (_.isEmpty(attrs)) return first ? void 0 : []; + return this[first ? 'find' : 'filter'](function(model) { for (var key in attrs) { if (attrs[key] !== model.get(key)) return false; } @@ -727,13 +803,17 @@ }); }, + // Return the first model with matching attributes. Useful for simple cases + // of `find`. + findWhere: function(attrs) { + return this.where(attrs, true); + }, + // Force the collection to re-sort itself. You don't need to call this under // normal circumstances, as the set will maintain sort order as each item // is added. sort: function(options) { - if (!this.comparator) { - throw new Error('Cannot sort a set without a comparator'); - } + if (!this.comparator) throw new Error('Cannot sort a set without a comparator'); options || (options = {}); // Run sort based on type of `comparator`. @@ -747,75 +827,36 @@ return this; }, + // Figure out the smallest index at which a model should be inserted so as + // to maintain order. + sortedIndex: function(model, value, context) { + value || (value = this.comparator); + var iterator = _.isFunction(value) ? value : function(model) { + return model.get(value); + }; + return _.sortedIndex(this.models, model, iterator, context); + }, + // Pluck an attribute from each model in the collection. pluck: function(attr) { return _.invoke(this.models, 'get', attr); }, - // Smartly update a collection with a change set of models, adding, - // removing, and merging as necessary. - update: function(models, options) { - options = _.extend({add: true, merge: true, remove: true}, options); - if (options.parse) models = this.parse(models, options); - var model, i, l, existing; - var add = [], remove = [], modelMap = {}; - - // Allow a single model (or no argument) to be passed. - if (!_.isArray(models)) models = models ? [models] : []; - - // Proxy to `add` for this case, no need to iterate... - if (options.add && !options.remove) return this.add(models, options); - - // Determine which models to add and merge, and which to remove. - for (i = 0, l = models.length; i < l; i++) { - model = models[i]; - existing = this.get(model); - if (options.remove && existing) modelMap[existing.cid] = true; - if ((options.add && !existing) || (options.merge && existing)) { - add.push(model); - } - } - if (options.remove) { - for (i = 0, l = this.models.length; i < l; i++) { - model = this.models[i]; - if (!modelMap[model.cid]) remove.push(model); - } - } - - // Remove models (if applicable) before we add and merge the rest. - if (remove.length) this.remove(remove, options); - if (add.length) this.add(add, options); - return this; - }, - - // When you have more items than you want to add or remove individually, - // you can reset the entire set with a new list of models, without firing - // any `add` or `remove` events. Fires `reset` when finished. - reset: function(models, options) { - options || (options = {}); - if (options.parse) models = this.parse(models, options); - for (var i = 0, l = this.models.length; i < l; i++) { - this._removeReference(this.models[i]); - } - options.previousModels = this.models.slice(); - this._reset(); - if (models) this.add(models, _.extend({silent: true}, options)); - if (!options.silent) this.trigger('reset', this, options); - return this; - }, - // Fetch the default set of models for this collection, resetting the - // collection when they arrive. If `update: true` is passed, the response - // data will be passed through the `update` method instead of `reset`. + // collection when they arrive. If `reset: true` is passed, the response + // data will be passed through the `reset` method instead of `set`. fetch: function(options) { options = options ? _.clone(options) : {}; if (options.parse === void 0) options.parse = true; var success = options.success; - options.success = function(collection, resp, options) { - var method = options.update ? 'update' : 'reset'; + var collection = this; + options.success = function(resp) { + var method = options.reset ? 'reset' : 'set'; collection[method](resp, options); if (success) success(collection, resp, options); + collection.trigger('sync', collection, resp, options); }; + wrapError(this, options); return this.sync('read', this, options); }, @@ -828,7 +869,7 @@ if (!options.wait) this.add(model, options); var collection = this; var success = options.success; - options.success = function(model, resp, options) { + options.success = function(resp) { if (options.wait) collection.add(model, options); if (success) success(model, resp, options); }; @@ -847,14 +888,16 @@ return new this.constructor(this.models); }, - // Reset all internal state. Called when the collection is reset. + // Private method to reset all internal state. Called when the collection + // is first initialized or reset. _reset: function() { this.length = 0; - this.models.length = 0; + this.models = []; this._byId = {}; }, - // Prepare a model or hash of attributes to be added to this collection. + // Prepare a hash of attributes (or other model) to be added to this + // collection. _prepareModel: function(attrs, options) { if (attrs instanceof Model) { if (!attrs.collection) attrs.collection = this; @@ -863,11 +906,14 @@ options || (options = {}); options.collection = this; var model = new this.model(attrs, options); - if (!model._validate(attrs, options)) return false; + if (!model._validate(attrs, options)) { + this.trigger('invalid', this, attrs, options); + return false; + } return model; }, - // Internal method to remove a model's ties to a collection. + // Internal method to sever a model's ties to a collection. _removeReference: function(model) { if (this === model.collection) delete model.collection; model.off('all', this._onModelEvent, this); @@ -885,19 +931,13 @@ if (model.id != null) this._byId[model.id] = model; } this.trigger.apply(this, arguments); - }, - - sortedIndex: function (model, value, context) { - value || (value = this.comparator); - var iterator = _.isFunction(value) ? value : function(model) { - return model.get(value); - }; - return _.sortedIndex(this.models, model, iterator, context); } }); // Underscore methods that we want to implement on the Collection. + // 90% of the core usefulness of Backbone Collections is actually implemented + // right here: var methods = ['forEach', 'each', 'map', 'collect', 'reduce', 'foldl', 'inject', 'reduceRight', 'foldr', 'find', 'detect', 'filter', 'select', 'reject', 'every', 'all', 'some', 'any', 'include', 'contains', 'invoke', @@ -927,62 +967,303 @@ }; }); - // Backbone.Router - // --------------- + // Backbone.View + // ------------- - // Routers map faux-URLs to actions, and fire events when routes are - // matched. Creating a new one sets its `routes` hash, if not set statically. - var Router = Backbone.Router = function(options) { - options || (options = {}); - if (options.routes) this.routes = options.routes; - this._bindRoutes(); + // Backbone Views are almost more convention than they are actual code. A View + // is simply a JavaScript object that represents a logical chunk of UI in the + // DOM. This might be a single item, an entire list, a sidebar or panel, or + // even the surrounding frame which wraps your whole app. Defining a chunk of + // UI as a **View** allows you to define your DOM events declaratively, without + // having to worry about render order ... and makes it easy for the view to + // react to specific changes in the state of your models. + + // Creating a Backbone.View creates its initial element outside of the DOM, + // if an existing element is not provided... + var View = Backbone.View = function(options) { + this.cid = _.uniqueId('view'); + this._configure(options || {}); + this._ensureElement(); this.initialize.apply(this, arguments); + this.delegateEvents(); }; - // Cached regular expressions for matching named param parts and splatted - // parts of route strings. - var optionalParam = /\((.*?)\)/g; - var namedParam = /(\(\?)?:\w+/g; - var splatParam = /\*\w+/g; - var escapeRegExp = /[\-{}\[\]+?.,\\\^$|#\s]/g; + // Cached regex to split keys for `delegate`. + var delegateEventSplitter = /^(\S+)\s*(.*)$/; - // Set up all inheritable **Backbone.Router** properties and methods. - _.extend(Router.prototype, Events, { + // List of view options to be merged as properties. + var viewOptions = ['model', 'collection', 'el', 'id', 'attributes', 'className', 'tagName', 'events']; + + // Set up all inheritable **Backbone.View** properties and methods. + _.extend(View.prototype, Events, { + + // The default `tagName` of a View's element is `"div"`. + tagName: 'div', + + // jQuery delegate for element lookup, scoped to DOM elements within the + // current view. This should be prefered to global lookups where possible. + $: function(selector) { + return this.$el.find(selector); + }, // Initialize is an empty function by default. Override it with your own // initialization logic. initialize: function(){}, - // Manually bind a single named route to a callback. For example: - // - // this.route('search/:query/p:num', 'search', function(query, num) { - // ... - // }); - // - route: function(route, name, callback) { - if (!_.isRegExp(route)) route = this._routeToRegExp(route); - if (!callback) callback = this[name]; - Backbone.history.route(route, _.bind(function(fragment) { - var args = this._extractParameters(route, fragment); - callback && callback.apply(this, args); - this.trigger.apply(this, ['route:' + name].concat(args)); - this.trigger('route', name, args); - Backbone.history.trigger('route', this, name, args); - }, this)); + // **render** is the core function that your view should override, in order + // to populate its element (`this.el`), with the appropriate HTML. The + // convention is for **render** to always return `this`. + render: function() { return this; }, - // Simple proxy to `Backbone.history` to save a fragment into the history. - navigate: function(fragment, options) { - Backbone.history.navigate(fragment, options); - return this; - }, + // Remove this view by taking the element out of the DOM, and removing any + // applicable Backbone.Events listeners. + remove: function() { + this.$el.remove(); + this.stopListening(); + return this; + }, + + // Change the view's element (`this.el` property), including event + // re-delegation. + setElement: function(element, delegate) { + if (this.$el) this.undelegateEvents(); + this.$el = element instanceof Backbone.$ ? element : Backbone.$(element); + this.el = this.$el[0]; + if (delegate !== false) this.delegateEvents(); + return this; + }, + + // Set callbacks, where `this.events` is a hash of + // + // *{"event selector": "callback"}* + // + // { + // 'mousedown .title': 'edit', + // 'click .button': 'save' + // 'click .open': function(e) { ... } + // } + // + // pairs. Callbacks will be bound to the view, with `this` set properly. + // Uses event delegation for efficiency. + // Omitting the selector binds the event to `this.el`. + // This only works for delegate-able events: not `focus`, `blur`, and + // not `change`, `submit`, and `reset` in Internet Explorer. + delegateEvents: function(events) { + if (!(events || (events = _.result(this, 'events')))) return this; + this.undelegateEvents(); + for (var key in events) { + var method = events[key]; + if (!_.isFunction(method)) method = this[events[key]]; + if (!method) continue; + + var match = key.match(delegateEventSplitter); + var eventName = match[1], selector = match[2]; + method = _.bind(method, this); + eventName += '.delegateEvents' + this.cid; + if (selector === '') { + this.$el.on(eventName, method); + } else { + this.$el.on(eventName, selector, method); + } + } + return this; + }, + + // Clears all callbacks previously bound to the view with `delegateEvents`. + // You usually don't need to use this, but may wish to if you have multiple + // Backbone views attached to the same DOM element. + undelegateEvents: function() { + this.$el.off('.delegateEvents' + this.cid); + return this; + }, + + // Performs the initial configuration of a View with a set of options. + // Keys with special meaning *(e.g. model, collection, id, className)* are + // attached directly to the view. See `viewOptions` for an exhaustive + // list. + _configure: function(options) { + if (this.options) options = _.extend({}, _.result(this, 'options'), options); + _.extend(this, _.pick(options, viewOptions)); + this.options = options; + }, + + // Ensure that the View has a DOM element to render into. + // If `this.el` is a string, pass it through `$()`, take the first + // matching element, and re-assign it to `el`. Otherwise, create + // an element from the `id`, `className` and `tagName` properties. + _ensureElement: function() { + if (!this.el) { + var attrs = _.extend({}, _.result(this, 'attributes')); + if (this.id) attrs.id = _.result(this, 'id'); + if (this.className) attrs['class'] = _.result(this, 'className'); + var $el = Backbone.$('<' + _.result(this, 'tagName') + '>').attr(attrs); + this.setElement($el, false); + } else { + this.setElement(_.result(this, 'el'), false); + } + } + + }); + + // Backbone.sync + // ------------- + + // Override this function to change the manner in which Backbone persists + // models to the server. You will be passed the type of request, and the + // model in question. By default, makes a RESTful Ajax request + // to the model's `url()`. Some possible customizations could be: + // + // * Use `setTimeout` to batch rapid-fire updates into a single request. + // * Send up the models as XML instead of JSON. + // * Persist models via WebSockets instead of Ajax. + // + // Turn on `Backbone.emulateHTTP` in order to send `PUT` and `DELETE` requests + // as `POST`, with a `_method` parameter containing the true HTTP method, + // as well as all requests with the body as `application/x-www-form-urlencoded` + // instead of `application/json` with the model in a param named `model`. + // Useful when interfacing with server-side languages like **PHP** that make + // it difficult to read the body of `PUT` requests. + Backbone.sync = function(method, model, options) { + var type = methodMap[method]; + + // Default options, unless specified. + _.defaults(options || (options = {}), { + emulateHTTP: Backbone.emulateHTTP, + emulateJSON: Backbone.emulateJSON + }); + + // Default JSON-request options. + var params = {type: type, dataType: 'json'}; + + // Ensure that we have a URL. + if (!options.url) { + params.url = _.result(model, 'url') || urlError(); + } + + // Ensure that we have the appropriate request data. + if (options.data == null && model && (method === 'create' || method === 'update' || method === 'patch')) { + params.contentType = 'application/json'; + params.data = JSON.stringify(options.attrs || model.toJSON(options)); + } + + // For older servers, emulate JSON by encoding the request into an HTML-form. + if (options.emulateJSON) { + params.contentType = 'application/x-www-form-urlencoded'; + params.data = params.data ? {model: params.data} : {}; + } + + // For older servers, emulate HTTP by mimicking the HTTP method with `_method` + // And an `X-HTTP-Method-Override` header. + if (options.emulateHTTP && (type === 'PUT' || type === 'DELETE' || type === 'PATCH')) { + params.type = 'POST'; + if (options.emulateJSON) params.data._method = type; + var beforeSend = options.beforeSend; + options.beforeSend = function(xhr) { + xhr.setRequestHeader('X-HTTP-Method-Override', type); + if (beforeSend) return beforeSend.apply(this, arguments); + }; + } + + // Don't process data on a non-GET request. + if (params.type !== 'GET' && !options.emulateJSON) { + params.processData = false; + } + + // If we're sending a `PATCH` request, and we're in an old Internet Explorer + // that still has ActiveX enabled by default, override jQuery to use that + // for XHR instead. Remove this line when jQuery supports `PATCH` on IE8. + if (params.type === 'PATCH' && window.ActiveXObject && + !(window.external && window.external.msActiveXFilteringEnabled)) { + params.xhr = function() { + return new ActiveXObject("Microsoft.XMLHTTP"); + }; + } + + // Make the request, allowing the user to override any Ajax options. + var xhr = options.xhr = Backbone.ajax(_.extend(params, options)); + model.trigger('request', model, xhr, options); + return xhr; + }; + + // Map from CRUD to HTTP for our default `Backbone.sync` implementation. + var methodMap = { + 'create': 'POST', + 'update': 'PUT', + 'patch': 'PATCH', + 'delete': 'DELETE', + 'read': 'GET' + }; + + // Set the default implementation of `Backbone.ajax` to proxy through to `$`. + // Override this if you'd like to use a different library. + Backbone.ajax = function() { + return Backbone.$.ajax.apply(Backbone.$, arguments); + }; + + // Backbone.Router + // --------------- + + // Routers map faux-URLs to actions, and fire events when routes are + // matched. Creating a new one sets its `routes` hash, if not set statically. + var Router = Backbone.Router = function(options) { + options || (options = {}); + if (options.routes) this.routes = options.routes; + this._bindRoutes(); + this.initialize.apply(this, arguments); + }; + + // Cached regular expressions for matching named param parts and splatted + // parts of route strings. + var optionalParam = /\((.*?)\)/g; + var namedParam = /(\(\?)?:\w+/g; + var splatParam = /\*\w+/g; + var escapeRegExp = /[\-{}\[\]+?.,\\\^$|#\s]/g; + + // Set up all inheritable **Backbone.Router** properties and methods. + _.extend(Router.prototype, Events, { + + // Initialize is an empty function by default. Override it with your own + // initialization logic. + initialize: function(){}, + + // Manually bind a single named route to a callback. For example: + // + // this.route('search/:query/p:num', 'search', function(query, num) { + // ... + // }); + // + route: function(route, name, callback) { + if (!_.isRegExp(route)) route = this._routeToRegExp(route); + if (_.isFunction(name)) { + callback = name; + name = ''; + } + if (!callback) callback = this[name]; + var router = this; + Backbone.history.route(route, function(fragment) { + var args = router._extractParameters(route, fragment); + callback && callback.apply(router, args); + router.trigger.apply(router, ['route:' + name].concat(args)); + router.trigger('route', name, args); + Backbone.history.trigger('route', router, name, args); + }); + return this; + }, + + // Simple proxy to `Backbone.history` to save a fragment into the history. + navigate: function(fragment, options) { + Backbone.history.navigate(fragment, options); + return this; + }, // Bind all defined routes to `Backbone.history`. We have to reverse the // order of the routes here to support behavior where the most general // routes can be defined at the bottom of the route map. _bindRoutes: function() { if (!this.routes) return; + this.routes = _.result(this, 'routes'); var route, routes = _.keys(this.routes); while ((route = routes.pop()) != null) { this.route(route, this.routes[route]); @@ -1002,9 +1283,13 @@ }, // Given a route, and a URL fragment that it matches, return the array of - // extracted parameters. + // extracted decoded parameters. Empty or unmatched parameters will be + // treated as `null` to normalize cross-browser behavior. _extractParameters: function(route, fragment) { - return route.exec(fragment).slice(1); + var params = route.exec(fragment).slice(1); + return _.map(params, function(param) { + return param ? decodeURIComponent(param) : null; + }); } }); @@ -1012,8 +1297,11 @@ // Backbone.History // ---------------- - // Handles cross-browser history management, based on URL fragments. If the - // browser does not support `onhashchange`, falls back to polling. + // Handles cross-browser history management, based on either + // [pushState](http://diveintohtml5.info/history.html) and real URLs, or + // [onhashchange](https://developer.mozilla.org/en-US/docs/DOM/window.onhashchange) + // and URL fragments. If the browser supports neither (old IE, natch), + // falls back to polling. var History = Backbone.History = function() { this.handlers = []; _.bindAll(this, 'checkUrl'); @@ -1224,230 +1512,6 @@ // Create the default Backbone.history. Backbone.history = new History; - // Backbone.View - // ------------- - - // Creating a Backbone.View creates its initial element outside of the DOM, - // if an existing element is not provided... - var View = Backbone.View = function(options) { - this.cid = _.uniqueId('view'); - this._configure(options || {}); - this._ensureElement(); - this.initialize.apply(this, arguments); - this.delegateEvents(); - }; - - // Cached regex to split keys for `delegate`. - var delegateEventSplitter = /^(\S+)\s*(.*)$/; - - // List of view options to be merged as properties. - var viewOptions = ['model', 'collection', 'el', 'id', 'attributes', 'className', 'tagName', 'events']; - - // Set up all inheritable **Backbone.View** properties and methods. - _.extend(View.prototype, Events, { - - // The default `tagName` of a View's element is `"div"`. - tagName: 'div', - - // jQuery delegate for element lookup, scoped to DOM elements within the - // current view. This should be prefered to global lookups where possible. - $: function(selector) { - return this.$el.find(selector); - }, - - // Initialize is an empty function by default. Override it with your own - // initialization logic. - initialize: function(){}, - - // **render** is the core function that your view should override, in order - // to populate its element (`this.el`), with the appropriate HTML. The - // convention is for **render** to always return `this`. - render: function() { - return this; - }, - - // Remove this view by taking the element out of the DOM, and removing any - // applicable Backbone.Events listeners. - remove: function() { - this.$el.remove(); - this.stopListening(); - return this; - }, - - // Change the view's element (`this.el` property), including event - // re-delegation. - setElement: function(element, delegate) { - if (this.$el) this.undelegateEvents(); - this.$el = element instanceof Backbone.$ ? element : Backbone.$(element); - this.el = this.$el[0]; - if (delegate !== false) this.delegateEvents(); - return this; - }, - - // Set callbacks, where `this.events` is a hash of - // - // *{"event selector": "callback"}* - // - // { - // 'mousedown .title': 'edit', - // 'click .button': 'save' - // 'click .open': function(e) { ... } - // } - // - // pairs. Callbacks will be bound to the view, with `this` set properly. - // Uses event delegation for efficiency. - // Omitting the selector binds the event to `this.el`. - // This only works for delegate-able events: not `focus`, `blur`, and - // not `change`, `submit`, and `reset` in Internet Explorer. - delegateEvents: function(events) { - if (!(events || (events = _.result(this, 'events')))) return; - this.undelegateEvents(); - for (var key in events) { - var method = events[key]; - if (!_.isFunction(method)) method = this[events[key]]; - if (!method) throw new Error('Method "' + events[key] + '" does not exist'); - var match = key.match(delegateEventSplitter); - var eventName = match[1], selector = match[2]; - method = _.bind(method, this); - eventName += '.delegateEvents' + this.cid; - if (selector === '') { - this.$el.on(eventName, method); - } else { - this.$el.on(eventName, selector, method); - } - } - }, - - // Clears all callbacks previously bound to the view with `delegateEvents`. - // You usually don't need to use this, but may wish to if you have multiple - // Backbone views attached to the same DOM element. - undelegateEvents: function() { - this.$el.off('.delegateEvents' + this.cid); - }, - - // Performs the initial configuration of a View with a set of options. - // Keys with special meaning *(model, collection, id, className)*, are - // attached directly to the view. - _configure: function(options) { - if (this.options) options = _.extend({}, _.result(this, 'options'), options); - _.extend(this, _.pick(options, viewOptions)); - this.options = options; - }, - - // Ensure that the View has a DOM element to render into. - // If `this.el` is a string, pass it through `$()`, take the first - // matching element, and re-assign it to `el`. Otherwise, create - // an element from the `id`, `className` and `tagName` properties. - _ensureElement: function() { - if (!this.el) { - var attrs = _.extend({}, _.result(this, 'attributes')); - if (this.id) attrs.id = _.result(this, 'id'); - if (this.className) attrs['class'] = _.result(this, 'className'); - var $el = Backbone.$('<' + _.result(this, 'tagName') + '>').attr(attrs); - this.setElement($el, false); - } else { - this.setElement(_.result(this, 'el'), false); - } - } - - }); - - // Backbone.sync - // ------------- - - // Map from CRUD to HTTP for our default `Backbone.sync` implementation. - var methodMap = { - 'create': 'POST', - 'update': 'PUT', - 'patch': 'PATCH', - 'delete': 'DELETE', - 'read': 'GET' - }; - - // Override this function to change the manner in which Backbone persists - // models to the server. You will be passed the type of request, and the - // model in question. By default, makes a RESTful Ajax request - // to the model's `url()`. Some possible customizations could be: - // - // * Use `setTimeout` to batch rapid-fire updates into a single request. - // * Send up the models as XML instead of JSON. - // * Persist models via WebSockets instead of Ajax. - // - // Turn on `Backbone.emulateHTTP` in order to send `PUT` and `DELETE` requests - // as `POST`, with a `_method` parameter containing the true HTTP method, - // as well as all requests with the body as `application/x-www-form-urlencoded` - // instead of `application/json` with the model in a param named `model`. - // Useful when interfacing with server-side languages like **PHP** that make - // it difficult to read the body of `PUT` requests. - Backbone.sync = function(method, model, options) { - var type = methodMap[method]; - - // Default options, unless specified. - _.defaults(options || (options = {}), { - emulateHTTP: Backbone.emulateHTTP, - emulateJSON: Backbone.emulateJSON - }); - - // Default JSON-request options. - var params = {type: type, dataType: 'json'}; - - // Ensure that we have a URL. - if (!options.url) { - params.url = _.result(model, 'url') || urlError(); - } - - // Ensure that we have the appropriate request data. - if (options.data == null && model && (method === 'create' || method === 'update' || method === 'patch')) { - params.contentType = 'application/json'; - params.data = JSON.stringify(options.attrs || model.toJSON(options)); - } - - // For older servers, emulate JSON by encoding the request into an HTML-form. - if (options.emulateJSON) { - params.contentType = 'application/x-www-form-urlencoded'; - params.data = params.data ? {model: params.data} : {}; - } - - // For older servers, emulate HTTP by mimicking the HTTP method with `_method` - // And an `X-HTTP-Method-Override` header. - if (options.emulateHTTP && (type === 'PUT' || type === 'DELETE' || type === 'PATCH')) { - params.type = 'POST'; - if (options.emulateJSON) params.data._method = type; - var beforeSend = options.beforeSend; - options.beforeSend = function(xhr) { - xhr.setRequestHeader('X-HTTP-Method-Override', type); - if (beforeSend) return beforeSend.apply(this, arguments); - }; - } - - // Don't process data on a non-GET request. - if (params.type !== 'GET' && !options.emulateJSON) { - params.processData = false; - } - - var success = options.success; - options.success = function(resp) { - if (success) success(model, resp, options); - model.trigger('sync', model, resp, options); - }; - - var error = options.error; - options.error = function(xhr) { - if (error) error(model, xhr, options); - model.trigger('error', model, xhr, options); - }; - - // Make the request, allowing the user to override any Ajax options. - var xhr = options.xhr = Backbone.ajax(_.extend(params, options)); - model.trigger('request', model, xhr, options); - return xhr; - }; - - // Set the default implementation of `Backbone.ajax` to proxy through to `$`. - Backbone.ajax = function() { - return Backbone.$.ajax.apply(Backbone.$, arguments); - }; - // Helpers // ------- @@ -1495,4 +1559,13 @@ throw new Error('A "url" property or function must be specified'); }; + // Wrap an optional error callback with a fallback error event. + var wrapError = function (model, options) { + var error = options.error; + options.error = function(resp) { + if (error) error(model, resp, options); + model.trigger('error', model, resp, options); + }; + }; + }).call(this); diff --git a/vendor/backbone/test/collection.js b/vendor/backbone/test/collection.js index 64193fdee3..d068b39613 100644 --- a/vendor/backbone/test/collection.js +++ b/vendor/backbone/test/collection.js @@ -62,30 +62,29 @@ $(document).ready(function() { strictEqual(collection.last().get('a'), 4); }); - test("get", 5, function() { + test("get", 6, function() { equal(col.get(0), d); + equal(col.get(d.clone()), d); equal(col.get(2), b); equal(col.get({id: 1}), c); equal(col.get(c.clone()), c); equal(col.get(col.first().cid), col.first()); }); - test("get with non-default ids", 4, function() { + test("get with non-default ids", 5, function() { var col = new Backbone.Collection(); - var MongoModel = Backbone.Model.extend({ - idAttribute: '_id' - }); + var MongoModel = Backbone.Model.extend({idAttribute: '_id'}); var model = new MongoModel({_id: 100}); - col.push(model); + col.add(model); equal(col.get(100), model); - model.set({_id: 101}); - equal(col.get(101), model); + equal(col.get(model.cid), model); + equal(col.get(model), model); + equal(col.get(101), void 0); - var Col2 = Backbone.Collection.extend({ model: MongoModel }); - var col2 = new Col2(); - col2.push(model); - equal(col2.get({_id: 101}), model); - equal(col2.get(model.clone()), model); + var col2 = new Backbone.Collection(); + col2.model = MongoModel; + col2.add(model.attributes); + equal(col2.get(model.clone()), col2.first()); }); test("update index when id changes", 3, function() { @@ -226,6 +225,19 @@ $(document).ready(function() { equal(col.at(0).get('value'), 2); }); + test("add with parse and merge", function() { + var Model = Backbone.Model.extend({ + parse: function (data) { + return data.model; + } + }); + var collection = new Backbone.Collection(); + collection.model = Model; + collection.add({id: 1}); + collection.add({model: {id: 1, name: 'Alf'}}, {parse: true, merge: true}); + equal(collection.first().get('name'), 'Alf'); + }); + test("add model to collection with sort()-style comparator", 3, function() { var col = new Backbone.Collection; col.comparator = function(a, b) { @@ -362,9 +374,7 @@ $(document).ready(function() { test("model destroy removes from all collections", 3, function() { var e = new Backbone.Model({id: 5, title: 'Othello'}); - e.sync = function(method, model, options) { - options.success(model, [], options); - }; + e.sync = function(method, model, options) { options.success(); }; var colE = new Backbone.Collection([e]); var colF = new Backbone.Collection([e]); e.destroy(); @@ -396,6 +406,15 @@ $(document).ready(function() { equal(this.syncArgs.options.parse, false); }); + test("fetch with an error response triggers an error event", 1, function () { + var collection = new Backbone.Collection(); + collection.on('error', function () { + ok(true); + }); + collection.sync = function (method, model, options) { options.error(); }; + collection.fetch(); + }); + test("ensure fetch only parses once", 1, function() { var collection = new Backbone.Collection; var counter = 0; @@ -405,7 +424,7 @@ $(document).ready(function() { }; collection.url = '/test'; collection.fetch(); - this.syncArgs.options.success([]); + this.syncArgs.options.success(); equal(counter, 1); }); @@ -419,7 +438,7 @@ $(document).ready(function() { equal(model.collection, collection); }); - test("create with validate:true enforces validation", 1, function() { + test("create with validate:true enforces validation", 2, function() { var ValidatingModel = Backbone.Model.extend({ validate: function(attrs) { return "fail"; @@ -429,6 +448,9 @@ $(document).ready(function() { model: ValidatingModel }); var col = new ValidatingCollection(); + col.on('invalid', function (collection, attrs, options) { + equal(options.validationError, 'fail'); + }); equal(col.create({"foo":"bar"}, {validate:true}), false); }); @@ -461,9 +483,10 @@ $(document).ready(function() { equal(JSON.stringify(col), '[{"id":3,"label":"a"},{"id":2,"label":"b"},{"id":1,"label":"c"},{"id":0,"label":"d"}]'); }); - test("where", 6, function() { + test("where and findWhere", 8, function() { + var model = new Backbone.Model({a: 1}); var coll = new Backbone.Collection([ - {a: 1}, + model, {a: 1}, {a: 1, b: 2}, {a: 2, b: 2}, @@ -475,6 +498,8 @@ $(document).ready(function() { equal(coll.where({b: 1}).length, 0); equal(coll.where({b: 2}).length, 2); equal(coll.where({a: 1, b: 2}).length, 1); + equal(coll.findWhere({a: 1}), model); + equal(coll.findWhere({a: 4}), void 0); }); test("Underscore methods", 13, function() { @@ -484,10 +509,10 @@ $(document).ready(function() { equal(col.indexOf(b), 1); equal(col.size(), 4); equal(col.rest().length, 3); - ok(!_.include(col.rest()), a); - ok(!_.include(col.rest()), d); + ok(!_.include(col.rest(), a)); + ok(_.include(col.rest(), d)); ok(!col.isEmpty()); - ok(!_.include(col.without(d)), d); + ok(!_.include(col.without(d), d)); equal(col.max(function(model){ return model.id; }).id, 3); equal(col.min(function(model){ return model.id; }).id, 0); deepEqual(col.chain() @@ -509,9 +534,9 @@ $(document).ready(function() { }), 1); }); - test("reset", 10, function() { + test("reset", 12, function() { var resetCount = 0; - var models = col.models.slice(); + var models = col.models; col.on('reset', function() { resetCount += 1; }); col.reset([]); equal(resetCount, 1); @@ -526,6 +551,22 @@ $(document).ready(function() { equal(col.length, 4); ok(col.last() !== d); ok(_.isEqual(col.last().attributes, d.attributes)); + col.reset(); + equal(col.length, 0); + equal(resetCount, 4); + }); + + test ("reset with different values", function(){ + var col = new Backbone.Collection({id: 1}); + col.reset({id: 1, a: 1}); + equal(col.get(1).get('a'), 1); + }); + + test("same references in reset", function() { + var model = new Backbone.Model({id: 1}); + var collection = new Backbone.Collection({id: 1}); + collection.reset(model); + equal(collection.get(1), model); }); test("reset passes caller options", 3, function() { @@ -702,9 +743,7 @@ $(document).ready(function() { test("#1447 - create with wait adds model.", 1, function() { var collection = new Backbone.Collection; var model = new Backbone.Model; - model.sync = function(method, model, options){ - options.success(model, [], options); - }; + model.sync = function(method, model, options){ options.success(); }; collection.on('add', function(){ ok(true); }); collection.create(model, {wait: true}); }); @@ -834,7 +873,7 @@ $(document).ready(function() { collection.reset([]); }); - test("update", function() { + test("set", function() { var m1 = new Backbone.Model(); var m2 = new Backbone.Model({id: 2}); var m3 = new Backbone.Model(); @@ -852,24 +891,24 @@ $(document).ready(function() { }); // remove: false doesn't remove any models - c.update([], {remove: false}); + c.set([], {remove: false}); strictEqual(c.length, 2); // add: false doesn't add any models - c.update([m1, m2, m3], {add: false}); + c.set([m1, m2, m3], {add: false}); strictEqual(c.length, 2); // merge: false doesn't change any models - c.update([m1, {id: 2, a: 1}], {merge: false}); + c.set([m1, {id: 2, a: 1}], {merge: false}); strictEqual(m2.get('a'), void 0); // add: false, remove: false only merges existing models - c.update([m1, {id: 2, a: 0}, m3, {id: 4}], {add: false, remove: false}); + c.set([m1, {id: 2, a: 0}, m3, {id: 4}], {add: false, remove: false}); strictEqual(c.length, 2); strictEqual(m2.get('a'), 0); // default options add/remove/merge as appropriate - c.update([{id: 2, a: 1}, m3]); + c.set([{id: 2, a: 1}, m3]); strictEqual(c.length, 2); strictEqual(m2.get('a'), 1); @@ -877,23 +916,23 @@ $(document).ready(function() { c.off('remove').on('remove', function(model) { ok(model === m2 || model === m3); }); - c.update([]); + c.set([]); strictEqual(c.length, 0); }); - test("update with only cids", 3, function() { + test("set with only cids", 3, function() { var m1 = new Backbone.Model; var m2 = new Backbone.Model; var c = new Backbone.Collection; - c.update([m1, m2]); + c.set([m1, m2]); equal(c.length, 2); - c.update([m1]); + c.set([m1]); equal(c.length, 1); - c.update([m1, m1, m1, m2, m2], {remove: false}); + c.set([m1, m1, m1, m2, m2], {remove: false}); equal(c.length, 2); }); - test("update with only idAttribute", 3, function() { + test("set with only idAttribute", 3, function() { var m1 = { _id: 1 }; var m2 = { _id: 2 }; var col = Backbone.Collection.extend({ @@ -902,15 +941,15 @@ $(document).ready(function() { }) }); var c = new col; - c.update([m1, m2]); + c.set([m1, m2]); equal(c.length, 2); - c.update([m1]); + c.set([m1]); equal(c.length, 1); - c.update([m1, m1, m1, m2, m2], {remove: false}); + c.set([m1, m1, m1, m2, m2], {remove: false}); equal(c.length, 2); }); - test("update + merge with default values defined", function() { + test("set + merge with default values defined", function() { var Model = Backbone.Model.extend({ defaults: { key: 'value' @@ -920,14 +959,43 @@ $(document).ready(function() { var col = new Backbone.Collection([m], {model: Model}); equal(col.first().get('key'), 'value'); - col.update({id: 1, key: 'other'}); + col.set({id: 1, key: 'other'}); equal(col.first().get('key'), 'other'); - col.update({id: 1, other: 'value'}); - equal(col.first().get('key'), 'other'); + col.set({id: 1, other: 'value'}); + equal(col.first().get('key'), 'value'); equal(col.length, 1); }); + test("`set` and model level `parse`", function() { + var Model = Backbone.Model.extend({ + parse: function (res) { return res.model; } + }); + var Collection = Backbone.Collection.extend({ + model: Model, + parse: function (res) { return res.models; } + }); + var model = new Model({id: 1}); + var collection = new Collection(model); + collection.set({models: [ + {model: {id: 1}}, + {model: {id: 2}} + ]}, {parse: true}); + equal(collection.first(), model); + }); + + test("`set` data is only parsed once", function() { + var collection = new Backbone.Collection(); + collection.model = Backbone.Model.extend({ + parse: function (data) { + equal(data.parsed, void 0); + data.parsed = true; + return data; + } + }); + collection.set({}, {parse: true}); + }); + test("#1894 - Push should not trigger a sort", 0, function() { var Collection = Backbone.Collection.extend({ comparator: 'id', @@ -938,12 +1006,12 @@ $(document).ready(function() { new Collection().push({id: 1}); }); - test("`update` with non-normal id", function() { + test("`set` with non-normal id", function() { var Collection = Backbone.Collection.extend({ model: Backbone.Model.extend({idAttribute: '_id'}) }); var collection = new Collection({_id: 1}); - collection.update([{_id: 1, a: 1}], {add: false}); + collection.set([{_id: 1, a: 1}], {add: false}); equal(collection.first().get('a'), 1); }); @@ -955,7 +1023,7 @@ $(document).ready(function() { new Collection().add({id: 1}, {sort: false}); }); - test("#1915 - `parse` data in the right order in `update`", function() { + test("#1915 - `parse` data in the right order in `set`", function() { var collection = new (Backbone.Collection.extend({ parse: function (data) { strictEqual(data.status, 'ok'); @@ -963,7 +1031,7 @@ $(document).ready(function() { } })); var res = {status: 'ok', data:[{id: 1}]}; - collection.update(res, {parse: true}); + collection.set(res, {parse: true}); }); asyncTest("#1939 - `parse` is passed `options`", 1, function () { @@ -1001,7 +1069,7 @@ $(document).ready(function() { test("`add` only `sort`s when necessary with comparator function", 3, function () { var collection = new (Backbone.Collection.extend({ comparator: function(a, b) { - a.get('a') > b.get('a') ? 1 : (a.get('a') < b.get('a') ? -1 : 0); + return a.get('a') > b.get('a') ? 1 : (a.get('a') < b.get('a') ? -1 : 0); } }))([{id: 1}, {id: 2}, {id: 3}]); collection.on('sort', function () { ok(true); }); @@ -1013,4 +1081,20 @@ $(document).ready(function() { collection.add(collection.models, {merge: true}); // don't sort }); + test("Attach options to collection.", 3, function() { + var url = '/somewhere'; + var model = new Backbone.Model; + var comparator = function(){}; + + var collection = new Backbone.Collection([], { + url: url, + model: model, + comparator: comparator + }); + + strictEqual(collection.url, url); + ok(collection.model === model); + ok(collection.comparator === comparator); + }); + }); diff --git a/vendor/backbone/test/events.js b/vendor/backbone/test/events.js index f94d32c3d4..1aa746ccee 100644 --- a/vendor/backbone/test/events.js +++ b/vendor/backbone/test/events.js @@ -99,6 +99,43 @@ $(document).ready(function() { a.listenTo(b, 'event2', cb); a.stopListening(null, {event: cb}); b.trigger('event event2'); + b.off(); + a.listenTo(b, 'event event2', cb); + a.stopListening(null, 'event'); + a.stopListening(); + b.trigger('event2'); + }); + + test("listenToOnce and stopListening", 1, function() { + var a = _.extend({}, Backbone.Events); + var b = _.extend({}, Backbone.Events); + a.listenToOnce(b, 'all', function() { ok(true); }); + b.trigger('anything'); + b.trigger('anything'); + a.listenToOnce(b, 'all', function() { ok(false); }); + a.stopListening(); + b.trigger('anything'); + }); + + test("listenTo, listenToOnce and stopListening", 1, function() { + var a = _.extend({}, Backbone.Events); + var b = _.extend({}, Backbone.Events); + a.listenToOnce(b, 'all', function() { ok(true); }); + b.trigger('anything'); + b.trigger('anything'); + a.listenTo(b, 'all', function() { ok(false); }); + a.stopListening(); + b.trigger('anything'); + }); + + test("listenTo and stopListening with event maps", 1, function() { + var a = _.extend({}, Backbone.Events); + var b = _.extend({}, Backbone.Events); + a.listenTo(b, {change: function(){ ok(true); }}); + b.trigger('change'); + a.listenTo(b, {change: function(){ ok(false); }}); + a.stopListening(); + b.trigger('change'); }); test("listenTo yourself", 1, function(){ @@ -241,6 +278,13 @@ $(document).ready(function() { _.extend({}, Backbone.Events).on('test').trigger('test'); }); + test("if callback is truthy but not a function, `on` should throw an error just like jQuery", 1, function() { + var view = _.extend({}, Backbone.Events).on('test', 'noop'); + throws(function() { + view.trigger('test'); + }); + }); + test("remove all events for a specific context", 4, function() { var obj = _.extend({}, Backbone.Events); obj.on('x y all', function() { ok(true); }); @@ -259,18 +303,6 @@ $(document).ready(function() { obj.trigger('x y'); }); - test("off is chainable", 3, function() { - var obj = _.extend({}, Backbone.Events); - // With no events - ok(obj.off() === obj); - // When removing all events - obj.on('event', function(){}, obj); - ok(obj.off() === obj); - // When removing some events - obj.on('event', function(){}, obj); - ok(obj.off('event') === obj); - }); - test("#1310 - off does not skip consecutive events", 0, function() { var obj = _.extend({}, Backbone.Events); obj.on('event', function() { ok(false); }, obj); @@ -400,4 +432,21 @@ $(document).ready(function() { _.extend({}, Backbone.Events).once('event').trigger('event'); }); + test("event functions are chainable", function() { + var obj = _.extend({}, Backbone.Events); + var obj2 = _.extend({}, Backbone.Events); + var fn = function() {}; + equal(obj, obj.trigger('noeventssetyet')); + equal(obj, obj.off('noeventssetyet')); + equal(obj, obj.stopListening('noeventssetyet')); + equal(obj, obj.on('a', fn)); + equal(obj, obj.once('c', fn)); + equal(obj, obj.trigger('a')); + equal(obj, obj.listenTo(obj2, 'a', fn)); + equal(obj, obj.listenToOnce(obj2, 'b', fn)); + equal(obj, obj.off('a c')); + equal(obj, obj.stopListening(obj2, 'a')); + equal(obj, obj.stopListening()); + }); + }); diff --git a/vendor/backbone/test/model.js b/vendor/backbone/test/model.js index 7bbb8337c7..3b196c48ec 100644 --- a/vendor/backbone/test/model.js +++ b/vendor/backbone/test/model.js @@ -46,9 +46,9 @@ $(document).ready(function() { test("initialize with parsed attributes", 1, function() { var Model = Backbone.Model.extend({ - parse: function(obj) { - obj.value += 1; - return obj; + parse: function(attrs) { + attrs.value += 1; + return attrs; } }); var model = new Model({value: 1}, {parse: true}); @@ -69,8 +69,8 @@ $(document).ready(function() { test("parse can return null", 1, function() { var Model = Backbone.Model.extend({ - parse: function(obj) { - obj.value += 1; + parse: function(attrs) { + attrs.value += 1; return null; } }); @@ -111,6 +111,23 @@ $(document).ready(function() { equal(model.url(), '/nested/1/collection/2'); }); + test('url and urlRoot are directly attached if passed in the options', 2, function () { + var model = new Backbone.Model({a: 1}, {url: '/test'}); + var model2 = new Backbone.Model({a: 2}, {urlRoot: '/test2'}); + equal(model.url, '/test'); + equal(model2.urlRoot, '/test2'); + }); + + test("underscore methods", 5, function() { + var model = new Backbone.Model({ 'foo': 'a', 'bar': 'b', 'baz': 'c' }); + var model2 = model.clone(); + deepEqual(model.keys(), ['foo', 'bar', 'baz']); + deepEqual(model.values(), ['a', 'b', 'c']); + deepEqual(model.invert(), { 'a': 'foo', 'b': 'bar', 'c': 'baz' }); + deepEqual(model.pick('foo', 'baz'), {'foo': 'a', 'baz': 'c'}); + deepEqual(model.omit('foo', 'bar'), {'baz': 'c'}); + }); + test("clone", 10, function() { var a = new Backbone.Model({ 'foo': 1, 'bar': 2, 'baz': 3}); var b = a.clone(); @@ -324,7 +341,7 @@ $(document).ready(function() { "two": 2 } }); - var model = new Defaulted({two: null}); + var model = new Defaulted({two: undefined}); equal(model.get('one'), 1); equal(model.get('two'), 2); Defaulted = Backbone.Model.extend({ @@ -335,7 +352,7 @@ $(document).ready(function() { }; } }); - model = new Defaulted({two: null}); + model = new Defaulted({two: undefined}); equal(model.get('one'), 3); equal(model.get('two'), 4); }); @@ -401,7 +418,7 @@ $(document).ready(function() { if (attrs.admin) return "Can't change admin status."; }; model.sync = function(method, model, options) { - options.success.call(this, this, {admin: true}, options); + options.success.call(this, {admin: true}); }; model.on('invalid', function(model, error) { lastError = error; @@ -418,6 +435,19 @@ $(document).ready(function() { ok(_.isEqual(this.syncArgs.model, doc)); }); + test("save, fetch, destroy triggers error event when an error occurs", 3, function () { + var model = new Backbone.Model(); + model.on('error', function () { + ok(true); + }); + model.sync = function (method, model, options) { + options.error(); + }; + model.save({data: 2, id: 1}); + model.fetch(); + model.destroy(); + }); + test("save with PATCH", function() { doc.clear().set({id: 1, a: 1, b: 2, c: 3, d: 4}); doc.save(); @@ -435,7 +465,7 @@ $(document).ready(function() { test("save in positional style", 1, function() { var model = new Backbone.Model(); model.sync = function(method, model, options) { - options.success(model, {}, options); + options.success(); }; model.save('title', 'Twelfth Night'); equal(model.get('title'), 'Twelfth Night'); @@ -444,8 +474,8 @@ $(document).ready(function() { test("save with non-object success response", 2, function () { var model = new Backbone.Model(); model.sync = function(method, model, options) { - options.success(model, '', options); - options.success(model, null, options); + options.success('', options); + options.success(null, options); }; model.save({testing:'empty'}, { success: function (model) { @@ -720,7 +750,7 @@ $(document).ready(function() { test("#1030 - `save` with `wait` results in correct attributes if success is called during sync", 2, function() { var model = new Backbone.Model({x: 1, y: 2}); model.sync = function(method, model, options) { - options.success(model, {}, options); + options.success(); }; model.on("change:x", function() { ok(true); }); model.save({x: 3}, {wait: true}); @@ -893,7 +923,7 @@ $(document).ready(function() { } }; model.sync = function(method, model, options) { - options.success(model, {}, options); + options.success(); }; model.save({id: 1}, opts); model.fetch(opts); @@ -902,9 +932,8 @@ $(document).ready(function() { test("#1412 - Trigger 'sync' event.", 3, function() { var model = new Backbone.Model({id: 1}); - model.url = '/test'; + model.sync = function (method, model, options) { options.success(); }; model.on('sync', function(){ ok(true); }); - Backbone.ajax = function(settings){ settings.success(); }; model.fetch(); model.save(); model.destroy(); @@ -950,7 +979,7 @@ $(document).ready(function() { var Model = Backbone.Model.extend({ sync: function(method, model, options) { setTimeout(function(){ - options.success(model, {}, options); + options.success(); start(); }, 0); } diff --git a/vendor/backbone/test/router.js b/vendor/backbone/test/router.js index 26d3800970..e6e1b3d6ea 100644 --- a/vendor/backbone/test/router.js +++ b/vendor/backbone/test/router.js @@ -57,6 +57,15 @@ $(document).ready(function() { }); + var ExternalObject = { + value: 'unset', + + routingFunction: function(value) { + this.value = value; + } + }; + _.bindAll(ExternalObject); + var Router = Backbone.Router.extend({ count: 0, @@ -73,8 +82,11 @@ $(document).ready(function() { "optional(/:item)": "optionalItem", "named/optional/(y:z)": "namedOptional", "splat/*args/end": "splat", - "*first/complex-:part/*rest": "complex", + ":repo/compare/*from...*to": "github", + "decode/:named/*splat": "decode", + "*first/complex-*part/*rest": "complex", ":entity?*args": "query", + "function/:value": ExternalObject.routingFunction, "*anything": "anything" }, @@ -116,6 +128,12 @@ $(document).ready(function() { this.args = args; }, + github: function(repo, from, to) { + this.repo = repo; + this.from = from; + this.to = to; + }, + complex: function(first, part, rest) { this.first = first; this.part = part; @@ -135,6 +153,11 @@ $(document).ready(function() { this.z = z; }, + decode: function(named, path) { + this.named = named; + this.path = path; + }, + routeEvent: function(arg) { } @@ -153,6 +176,15 @@ $(document).ready(function() { equal(lastArgs[0], 'news'); }); + test("routes (simple, but unicode)", 4, function() { + location.replace('http://example.com#search/тест'); + Backbone.history.checkUrl(); + equal(router.query, "тест"); + equal(router.page, void 0); + equal(lastRoute, 'search'); + equal(lastArgs[0], "тест"); + }); + test("routes (two part)", 2, function() { location.replace('http://example.com#search/nyc/p10'); Backbone.history.checkUrl(); @@ -213,6 +245,14 @@ $(document).ready(function() { equal(router.args, 'long-list/of/splatted_99args'); }); + test("routes (github)", 3, function() { + location.replace('http://example.com#backbone/compare/1.0...braddunbar:with/slash'); + Backbone.history.checkUrl(); + equal(router.repo, 'backbone'); + equal(router.from, '1.0'); + equal(router.to, 'braddunbar:with/slash'); + }); + test("routes (optional)", 2, function() { location.replace('http://example.com#optional'); Backbone.history.checkUrl(); @@ -246,6 +286,23 @@ $(document).ready(function() { equal(router.anything, 'doesnt-match-a-route'); }); + test("routes (function)", 3, function() { + router.on('route', function(name) { + ok(name === ''); + }); + equal(ExternalObject.value, 'unset'); + location.replace('http://example.com#function/set'); + Backbone.history.checkUrl(); + equal(ExternalObject.value, 'set'); + }); + + test("Decode named parameters, not splats.", 2, function() { + location.replace('http://example.com#decode/a%2Fb/c%2Fd/e'); + Backbone.history.checkUrl(); + strictEqual(router.named, 'a/b'); + strictEqual(router.path, 'c/d/e'); + }); + test("fires event when router doesn't have callback on it", 1, function() { router.on("route:noCallback", function(){ ok(true); }); location.replace('http://example.com#noCallback'); @@ -277,9 +334,9 @@ $(document).ready(function() { test("#967 - Route callback gets passed encoded values.", 3, function() { var route = 'has%2Fslash/complex-has%23hash/has%20space'; Backbone.history.navigate(route, {trigger: true}); - strictEqual(router.first, 'has%2Fslash'); - strictEqual(router.part, 'has%23hash'); - strictEqual(router.rest, 'has%20space'); + strictEqual(router.first, 'has/slash'); + strictEqual(router.part, 'has#hash'); + strictEqual(router.rest, 'has space'); }); test("correctly handles URLs with % (#868)", 3, function() { @@ -529,4 +586,27 @@ $(document).ready(function() { Backbone.history.checkUrl(); }); + test("#2255 - Extend routes by making routes a function.", 1, function() { + var RouterBase = Backbone.Router.extend({ + routes: function() { + return { + home: "root", + index: "index.html" + }; + } + }); + + var RouterExtended = RouterBase.extend({ + routes: function() { + var _super = RouterExtended.__super__.routes; + return _.extend(_super(), + { show: "show", + search: "search" }); + } + }); + + var router = new RouterExtended(); + deepEqual({home: "root", index: "index.html", show: "show", search: "search"}, router.routes); + }); + }); diff --git a/vendor/backbone/test/view.js b/vendor/backbone/test/view.js index 7496c9da2a..58a87718dc 100644 --- a/vendor/backbone/test/view.js +++ b/vendor/backbone/test/view.js @@ -85,6 +85,13 @@ $(document).ready(function() { equal(view.counter, 3); }); + + test("delegateEvents ignore undefined methods", 0, function() { + var view = new Backbone.View({el: '

'}); + view.delegateEvents({'click': 'undefinedMethod'}); + view.$el.trigger('click'); + }); + test("undelegateEvents", 6, function() { var counter1 = 0, counter2 = 0; diff --git a/vendor/benchmark.js/README.md b/vendor/benchmark.js/README.md index 7bd96a68bd..d99539bf90 100644 --- a/vendor/benchmark.js/README.md +++ b/vendor/benchmark.js/README.md @@ -15,7 +15,7 @@ For a list of upcoming features, check out our [roadmap](https://github.com/best ## Support -Benchmark.js has been tested in at least Chrome 5~25, Firefox 1~19, IE 6-10, Opera 9.25-12, Safari 3-6, Node.js 0.4.8-0.8.22, Narwhal 0.3.2, PhantomJS 1.8.1, RingoJS 0.9, and Rhino 1.7RC5. +Benchmark.js has been tested in at least Chrome 5~25, Firefox 1~19, IE 6-10, Opera 9.25-12, Safari 3-6, Node.js 0.4.8-0.10.1, Narwhal 0.3.2, PhantomJS 1.8.1, RingoJS 0.9, and Rhino 1.7RC5. ## Installation and usage diff --git a/vendor/platform.js/README.md b/vendor/platform.js/README.md index 3fb842faf7..219c00b2fd 100644 --- a/vendor/platform.js/README.md +++ b/vendor/platform.js/README.md @@ -18,7 +18,7 @@ For a list of upcoming features, check out our [roadmap](https://github.com/best ## Support -Platform.js has been tested in at least Chrome 5~25, Firefox 1~19, IE 6-10, Opera 9.25-12, Safari 3-6, Node.js 0.4.8-0.8.22, Narwhal 0.3.2, PhantomJS 1.8.1, RingoJS 0.9, and Rhino 1.7RC5. +Platform.js has been tested in at least Chrome 5~25, Firefox 1~19, IE 6-10, Opera 9.25-12, Safari 3-6, Node.js 0.4.8-0.10.1, Narwhal 0.3.2, PhantomJS 1.8.1, RingoJS 0.9, and Rhino 1.7RC5. ## Installation and usage diff --git a/vendor/qunit-clib/README.md b/vendor/qunit-clib/README.md index 02349f5553..7b44ea8562 100644 --- a/vendor/qunit-clib/README.md +++ b/vendor/qunit-clib/README.md @@ -1,7 +1,7 @@ # QUnit CLIB v1.3.0 ## command-line interface boilerplate -QUnit CLIB helps extend QUnit's CLI support to many common CLI environments. +QUnit CLIB helps extend QUnit’s CLI support to many common CLI environments. ## Screenshot @@ -9,7 +9,7 @@ QUnit CLIB helps extend QUnit's CLI support to many common CLI environments. ## Support -QUnit CLIB has been tested in at least Node.js 0.4.8-0.8.22, Narwhal 0.3.2, PhantomJS 1.8.1, RingoJS 0.9, and Rhino 1.7RC5. +QUnit CLIB has been tested in at least Node.js 0.4.8-0.10.1, Narwhal 0.3.2, PhantomJS 1.8.1, RingoJS 0.9, and Rhino 1.7RC5. ## Usage diff --git a/vendor/qunit-clib/qunit-clib.js b/vendor/qunit-clib/qunit-clib.js index 8e1578d792..eb89ef3c1c 100644 --- a/vendor/qunit-clib/qunit-clib.js +++ b/vendor/qunit-clib/qunit-clib.js @@ -1,5 +1,5 @@ /*! - * QUnit CLI Boilerplate v1.2.0 + * QUnit CLI Boilerplate v1.3.0 * Copyright 2011-2012 John-David Dalton * Based on a gist by Jörn Zaefferer * Available under MIT license diff --git a/vendor/uglifyjs.tar.gz b/vendor/uglifyjs.tar.gz index 548bf49560..41308bd569 100644 Binary files a/vendor/uglifyjs.tar.gz and b/vendor/uglifyjs.tar.gz differ