2 * Sinon.JS 1.10.3, 2014/07/11
4 * @author Christian Johansen (christian@cjohansen.no)
5 * @author Contributors: https://github.com/cjohansen/Sinon.JS/blob/master/AUTHORS
9 * Copyright (c) 2010-2014, Christian Johansen, christian@cjohansen.no
10 * All rights reserved.
12 * Redistribution and use in source and binary forms, with or without modification,
13 * are permitted provided that the following conditions are met:
15 * * Redistributions of source code must retain the above copyright notice,
16 * this list of conditions and the following disclaimer.
17 * * Redistributions in binary form must reproduce the above copyright notice,
18 * this list of conditions and the following disclaimer in the documentation
19 * and/or other materials provided with the distribution.
20 * * Neither the name of Christian Johansen nor the names of his contributors
21 * may be used to endorse or promote products derived from this software
22 * without specific prior written permission.
24 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
25 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
26 * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
27 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
28 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
29 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
30 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
31 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
32 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
33 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
36 this.sinon = (function () {
38 function define(mod, deps, fn) { if (mod == "samsam") { samsam = deps(); } else if (typeof fn === "function") { formatio = fn(samsam); } }
40 ((typeof define === "function" && define.amd && function (m) { define("samsam", m); }) ||
41 (typeof module === "object" &&
42 function (m) { module.exports = m(); }) || // Node
43 function (m) { this.samsam = m(); } // Browser globals
45 var o = Object.prototype;
46 var div = typeof document !== "undefined" && document.createElement("div");
48 function isNaN(value) {
49 // Unlike global isNaN, this avoids type coercion
50 // typeof check avoids IE host object issues, hat tip to
52 var val = value; // JsLint thinks value !== value is "weird"
53 return typeof value === "number" && value !== val;
56 function getClass(value) {
57 // Returns the internal [[Class]] by calling Object.prototype.toString
58 // with the provided value as this. Return value is a string, naming the
59 // internal class, e.g. "Array"
60 return o.toString.call(value).split(/[ \]]/)[1];
64 * @name samsam.isArguments
65 * @param Object object
67 * Returns ``true`` if ``object`` is an ``arguments`` object,
68 * ``false`` otherwise.
70 function isArguments(object) {
71 if (typeof object !== "object" || typeof object.length !== "number" ||
72 getClass(object) === "Array") {
75 if (typeof object.callee == "function") { return true; }
77 object[object.length] = 6;
78 delete object[object.length];
86 * @name samsam.isElement
87 * @param Object object
89 * Returns ``true`` if ``object`` is a DOM element node. Unlike
90 * Underscore.js/lodash, this function will return ``false`` if ``object``
91 * is an *element-like* object, i.e. a regular object with a ``nodeType``
92 * property that holds the value ``1``.
94 function isElement(object) {
95 if (!object || object.nodeType !== 1 || !div) { return false; }
97 object.appendChild(div);
98 object.removeChild(div);
107 * @param Object object
109 * Return an array of own property names.
111 function keys(object) {
113 for (prop in object) {
114 if (o.hasOwnProperty.call(object, prop)) { ks.push(prop); }
120 * @name samsam.isDate
121 * @param Object value
123 * Returns true if the object is a ``Date``, or *date-like*. Duck typing
124 * of date objects work by checking that the object has a ``getTime``
125 * function whose return value equals the return value from the object's
128 function isDate(value) {
129 return typeof value.getTime == "function" &&
130 value.getTime() == value.valueOf();
134 * @name samsam.isNegZero
135 * @param Object value
137 * Returns ``true`` if ``value`` is ``-0``.
139 function isNegZero(value) {
140 return value === 0 && 1 / value === -Infinity;
148 * Returns ``true`` if two objects are strictly equal. Compared to
149 * ``===`` there are two exceptions:
151 * - NaN is considered equal to NaN
152 * - -0 and +0 are not considered equal
154 function identical(obj1, obj2) {
155 if (obj1 === obj2 || (isNaN(obj1) && isNaN(obj2))) {
156 return obj1 !== 0 || isNegZero(obj1) === isNegZero(obj2);
162 * @name samsam.deepEqual
166 * Deep equal comparison. Two values are "deep equal" if:
168 * - They are equal, according to samsam.identical
169 * - They are both date objects representing the same time
170 * - They are both arrays containing elements that are all deepEqual
171 * - They are objects with the same set of properties, and each property
172 * in ``obj1`` is deepEqual to the corresponding property in ``obj2``
174 * Supports cyclic objects.
176 function deepEqualCyclic(obj1, obj2) {
178 // used for cyclic comparison
179 // contain already visited objects
182 // contain pathes (position in the object structure)
183 // of the already visited objects
184 // indexes same as in objects arrays
187 // contains combinations of already compared objects
188 // in the manner: { "$1['ref']$2['ref']": true }
192 * used to check, if the value of a property is an object
193 * (cyclic logic is only needed for objects)
194 * only needed for cyclic logic
196 function isObject(value) {
198 if (typeof value === 'object' && value !== null &&
199 !(value instanceof Boolean) &&
200 !(value instanceof Date) &&
201 !(value instanceof Number) &&
202 !(value instanceof RegExp) &&
203 !(value instanceof String)) {
212 * returns the index of the given object in the
213 * given objects array, -1 if not contained
214 * only needed for cyclic logic
216 function getIndex(objects, obj) {
219 for (i = 0; i < objects.length; i++) {
220 if (objects[i] === obj) {
228 // does the recursion for the deep equal check
229 return (function deepEqual(obj1, obj2, path1, path2) {
230 var type1 = typeof obj1;
231 var type2 = typeof obj2;
233 // == null also matches undefined
235 isNaN(obj1) || isNaN(obj2) ||
236 obj1 == null || obj2 == null ||
237 type1 !== "object" || type2 !== "object") {
239 return identical(obj1, obj2);
242 // Elements are only equal if identical(expected, actual)
243 if (isElement(obj1) || isElement(obj2)) { return false; }
245 var isDate1 = isDate(obj1), isDate2 = isDate(obj2);
246 if (isDate1 || isDate2) {
247 if (!isDate1 || !isDate2 || obj1.getTime() !== obj2.getTime()) {
252 if (obj1 instanceof RegExp && obj2 instanceof RegExp) {
253 if (obj1.toString() !== obj2.toString()) { return false; }
256 var class1 = getClass(obj1);
257 var class2 = getClass(obj2);
258 var keys1 = keys(obj1);
259 var keys2 = keys(obj2);
261 if (isArguments(obj1) || isArguments(obj2)) {
262 if (obj1.length !== obj2.length) { return false; }
264 if (type1 !== type2 || class1 !== class2 ||
265 keys1.length !== keys2.length) {
271 // following vars are used for the cyclic logic
273 isObject1, isObject2,
277 for (i = 0, l = keys1.length; i < l; i++) {
279 if (!o.hasOwnProperty.call(obj2, key)) {
283 // Start of the cyclic logic
288 isObject1 = isObject(value1);
289 isObject2 = isObject(value2);
291 // determine, if the objects were already visited
292 // (it's faster to check for isObject first, than to
293 // get -1 from getIndex for non objects)
294 index1 = isObject1 ? getIndex(objects1, value1) : -1;
295 index2 = isObject2 ? getIndex(objects2, value2) : -1;
297 // determine the new pathes of the objects
298 // - for non cyclic objects the current path will be extended
299 // by current property name
300 // - for cyclic objects the stored path is taken
301 newPath1 = index1 !== -1
303 : path1 + '[' + JSON.stringify(key) + ']';
304 newPath2 = index2 !== -1
306 : path2 + '[' + JSON.stringify(key) + ']';
308 // stop recursion if current objects are already compared
309 if (compared[newPath1 + newPath2]) {
313 // remember the current objects and their pathes
314 if (index1 === -1 && isObject1) {
315 objects1.push(value1);
316 paths1.push(newPath1);
318 if (index2 === -1 && isObject2) {
319 objects2.push(value2);
320 paths2.push(newPath2);
323 // remember that the current objects are already compared
324 if (isObject1 && isObject2) {
325 compared[newPath1 + newPath2] = true;
328 // End of cyclic logic
330 // neither value1 nor value2 is a cycle
331 // continue with next level
332 if (!deepEqual(value1, value2, newPath1, newPath2)) {
339 }(obj1, obj2, '$1', '$2'));
344 function arrayContains(array, subset) {
345 if (subset.length === 0) { return true; }
347 for (i = 0, l = array.length; i < l; ++i) {
348 if (match(array[i], subset[0])) {
349 for (j = 0, k = subset.length; j < k; ++j) {
350 if (!match(array[i + j], subset[j])) { return false; }
360 * @param Object object
361 * @param Object matcher
363 * Compare arbitrary value ``object`` with matcher.
365 match = function match(object, matcher) {
366 if (matcher && typeof matcher.test === "function") {
367 return matcher.test(object);
370 if (typeof matcher === "function") {
371 return matcher(object) === true;
374 if (typeof matcher === "string") {
375 matcher = matcher.toLowerCase();
376 var notNull = typeof object === "string" || !!object;
378 (String(object)).toLowerCase().indexOf(matcher) >= 0;
381 if (typeof matcher === "number") {
382 return matcher === object;
385 if (typeof matcher === "boolean") {
386 return matcher === object;
389 if (getClass(object) === "Array" && getClass(matcher) === "Array") {
390 return arrayContains(object, matcher);
393 if (matcher && typeof matcher === "object") {
395 for (prop in matcher) {
396 if (!match(object[prop], matcher[prop])) {
403 throw new Error("Matcher was not a string, a number, a " +
404 "function, a boolean or an object");
408 isArguments: isArguments,
409 isElement: isElement,
411 isNegZero: isNegZero,
412 identical: identical,
413 deepEqual: deepEqualCyclic,
418 ((typeof define === "function" && define.amd && function (m) {
419 define("formatio", ["samsam"], m);
420 }) || (typeof module === "object" && function (m) {
421 module.exports = m(require("samsam"));
422 }) || function (m) { this.formatio = m(this.samsam); }
423 )(function (samsam) {
426 excludeConstructors: ["Object", /^.$/],
430 var hasOwn = Object.prototype.hasOwnProperty;
432 var specialObjects = [];
433 if (typeof global !== "undefined") {
434 specialObjects.push({ object: global, value: "[object global]" });
436 if (typeof document !== "undefined") {
437 specialObjects.push({
439 value: "[object HTMLDocument]"
442 if (typeof window !== "undefined") {
443 specialObjects.push({ object: window, value: "[object Window]" });
446 function functionName(func) {
447 if (!func) { return ""; }
448 if (func.displayName) { return func.displayName; }
449 if (func.name) { return func.name; }
450 var matches = func.toString().match(/function\s+([^\(]+)/m);
451 return (matches && matches[1]) || "";
454 function constructorName(f, object) {
455 var name = functionName(object && object.constructor);
456 var excludes = f.excludeConstructors ||
457 formatio.excludeConstructors || [];
460 for (i = 0, l = excludes.length; i < l; ++i) {
461 if (typeof excludes[i] === "string" && excludes[i] === name) {
463 } else if (excludes[i].test && excludes[i].test(name)) {
471 function isCircular(object, objects) {
472 if (typeof object !== "object") { return false; }
474 for (i = 0, l = objects.length; i < l; ++i) {
475 if (objects[i] === object) { return true; }
480 function ascii(f, object, processed, indent) {
481 if (typeof object === "string") {
482 var qs = f.quoteStrings;
483 var quote = typeof qs !== "boolean" || qs;
484 return processed || quote ? '"' + object + '"' : object;
487 if (typeof object === "function" && !(object instanceof RegExp)) {
488 return ascii.func(object);
491 processed = processed || [];
493 if (isCircular(object, processed)) { return "[Circular]"; }
495 if (Object.prototype.toString.call(object) === "[object Array]") {
496 return ascii.array.call(f, object, processed);
499 if (!object) { return String((1/object) === -Infinity ? "-0" : object); }
500 if (samsam.isElement(object)) { return ascii.element(object); }
502 if (typeof object.toString === "function" &&
503 object.toString !== Object.prototype.toString) {
504 return object.toString();
508 for (i = 0, l = specialObjects.length; i < l; i++) {
509 if (object === specialObjects[i].object) {
510 return specialObjects[i].value;
514 return ascii.object.call(f, object, processed, indent);
517 ascii.func = function (func) {
518 return "function " + functionName(func) + "() {}";
521 ascii.array = function (array, processed) {
522 processed = processed || [];
523 processed.push(array);
524 var i, l, pieces = [];
525 for (i = 0, l = array.length; i < l; ++i) {
526 pieces.push(ascii(this, array[i], processed));
528 return "[" + pieces.join(", ") + "]";
531 ascii.object = function (object, processed, indent) {
532 processed = processed || [];
533 processed.push(object);
534 indent = indent || 0;
535 var pieces = [], properties = samsam.keys(object).sort();
537 var prop, str, obj, i, l;
539 for (i = 0, l = properties.length; i < l; ++i) {
540 prop = properties[i];
543 if (isCircular(obj, processed)) {
546 str = ascii(this, obj, processed, indent + 2);
549 str = (/\s/.test(prop) ? '"' + prop + '"' : prop) + ": " + str;
550 length += str.length;
554 var cons = constructorName(this, object);
555 var prefix = cons ? "[" + cons + "] " : "";
557 for (i = 0, l = indent; i < l; ++i) { is += " "; }
559 if (length + indent > 80) {
560 return prefix + "{\n " + is + pieces.join(",\n " + is) + "\n" +
563 return prefix + "{ " + pieces.join(", ") + " }";
566 ascii.element = function (element) {
567 var tagName = element.tagName.toLowerCase();
568 var attrs = element.attributes, attr, pairs = [], attrName, i, l, val;
570 for (i = 0, l = attrs.length; i < l; ++i) {
571 attr = attrs.item(i);
572 attrName = attr.nodeName.toLowerCase().replace("html:", "");
573 val = attr.nodeValue;
574 if (attrName !== "contenteditable" || val !== "inherit") {
575 if (!!val) { pairs.push(attrName + "=\"" + val + "\""); }
579 var formatted = "<" + tagName + (pairs.length > 0 ? " " : "");
580 var content = element.innerHTML;
582 if (content.length > 20) {
583 content = content.substr(0, 20) + "[...]";
586 var res = formatted + pairs.join(" ") + ">" + content +
587 "</" + tagName + ">";
589 return res.replace(/ contentEditable="inherit"/, "");
592 function Formatio(options) {
593 for (var opt in options) {
594 this[opt] = options[opt];
598 Formatio.prototype = {
599 functionName: functionName,
601 configure: function (options) {
602 return new Formatio(options);
605 constructorName: function (object) {
606 return constructorName(this, object);
609 ascii: function (object, processed, indent) {
610 return ascii(this, object, processed, indent);
614 return Formatio.prototype;
616 /*jslint eqeqeq: false, onevar: false, forin: true, nomen: false, regexp: false, plusplus: false*/
617 /*global module, require, __dirname, document*/
619 * Sinon core utilities. For internal use only.
621 * @author Christian Johansen (christian@cjohansen.no)
624 * Copyright (c) 2010-2013 Christian Johansen
627 var sinon = (function (formatio) {
628 var div = typeof document != "undefined" && document.createElement("div");
629 var hasOwn = Object.prototype.hasOwnProperty;
631 function isDOMNode(obj) {
635 obj.appendChild(div);
636 success = div.parentNode == obj;
641 obj.removeChild(div);
643 // Remove failed, not much we can do about that
650 function isElement(obj) {
651 return div && obj && obj.nodeType === 1 && isDOMNode(obj);
654 function isFunction(obj) {
655 return typeof obj === "function" || !!(obj && obj.constructor && obj.call && obj.apply);
658 function isReallyNaN(val) {
659 return typeof val === 'number' && isNaN(val);
662 function mirrorProperties(target, source) {
663 for (var prop in source) {
664 if (!hasOwn.call(target, prop)) {
665 target[prop] = source[prop];
670 function isRestorable (obj) {
671 return typeof obj === "function" && typeof obj.restore === "function" && obj.restore.sinon;
675 wrapMethod: function wrapMethod(object, property, method) {
677 throw new TypeError("Should wrap property of object");
680 if (typeof method != "function") {
681 throw new TypeError("Method wrapper should be function");
684 var wrappedMethod = object[property],
687 if (!isFunction(wrappedMethod)) {
688 error = new TypeError("Attempted to wrap " + (typeof wrappedMethod) + " property " +
689 property + " as function");
690 } else if (wrappedMethod.restore && wrappedMethod.restore.sinon) {
691 error = new TypeError("Attempted to wrap " + property + " which is already wrapped");
692 } else if (wrappedMethod.calledBefore) {
693 var verb = !!wrappedMethod.returns ? "stubbed" : "spied on";
694 error = new TypeError("Attempted to wrap " + property + " which is already " + verb);
698 if (wrappedMethod && wrappedMethod._stack) {
699 error.stack += '\n--------------\n' + wrappedMethod._stack;
704 // IE 8 does not support hasOwnProperty on the window object and Firefox has a problem
705 // when using hasOwn.call on objects from other frames.
706 var owned = object.hasOwnProperty ? object.hasOwnProperty(property) : hasOwn.call(object, property);
707 object[property] = method;
708 method.displayName = property;
709 // Set up a stack trace which can be used later to find what line of
710 // code the original method was created on.
711 method._stack = (new Error('Stack Trace for original')).stack;
713 method.restore = function () {
714 // For prototype properties try to reset by delete first.
715 // If this fails (ex: localStorage on mobile safari) then force a reset
716 // via direct assignment.
718 delete object[property];
720 if (object[property] === method) {
721 object[property] = wrappedMethod;
725 method.restore.sinon = true;
726 mirrorProperties(method, wrappedMethod);
731 extend: function extend(target) {
732 for (var i = 1, l = arguments.length; i < l; i += 1) {
733 for (var prop in arguments[i]) {
734 if (arguments[i].hasOwnProperty(prop)) {
735 target[prop] = arguments[i][prop];
738 // DONT ENUM bug, only care about toString
739 if (arguments[i].hasOwnProperty("toString") &&
740 arguments[i].toString != target.toString) {
741 target.toString = arguments[i].toString;
749 create: function create(proto) {
750 var F = function () {};
755 deepEqual: function deepEqual(a, b) {
756 if (sinon.match && sinon.match.isMatcher(a)) {
760 if (typeof a != 'object' || typeof b != 'object') {
761 if (isReallyNaN(a) && isReallyNaN(b)) {
768 if (isElement(a) || isElement(b)) {
776 if ((a === null && b !== null) || (a !== null && b === null)) {
780 if (a instanceof RegExp && b instanceof RegExp) {
781 return (a.source === b.source) && (a.global === b.global) &&
782 (a.ignoreCase === b.ignoreCase) && (a.multiline === b.multiline);
785 var aString = Object.prototype.toString.call(a);
786 if (aString != Object.prototype.toString.call(b)) {
790 if (aString == "[object Date]") {
791 return a.valueOf() === b.valueOf();
794 var prop, aLength = 0, bLength = 0;
796 if (aString == "[object Array]" && a.length !== b.length) {
807 if (!deepEqual(a[prop], b[prop])) {
816 return aLength == bLength;
819 functionName: function functionName(func) {
820 var name = func.displayName || func.name;
822 // Use function decomposition as a last resort to get function
823 // name. Does not rely on function decomposition to work - if it
824 // doesn't debugging will be slightly less informative
825 // (i.e. toString will say 'spy' rather than 'myFunc').
827 var matches = func.toString().match(/function ([^\s\(]+)/);
828 name = matches && matches[1];
834 functionToString: function toString() {
835 if (this.getCall && this.callCount) {
836 var thisValue, prop, i = this.callCount;
839 thisValue = this.getCall(i).thisValue;
841 for (prop in thisValue) {
842 if (thisValue[prop] === this) {
849 return this.displayName || "sinon fake";
852 getConfig: function (custom) {
854 custom = custom || {};
855 var defaults = sinon.defaultConfig;
857 for (var prop in defaults) {
858 if (defaults.hasOwnProperty(prop)) {
859 config[prop] = custom.hasOwnProperty(prop) ? custom[prop] : defaults[prop];
866 format: function (val) {
871 injectIntoThis: true,
873 properties: ["spy", "stub", "mock", "clock", "server", "requests"],
878 timesInWords: function timesInWords(count) {
879 return count == 1 && "once" ||
880 count == 2 && "twice" ||
881 count == 3 && "thrice" ||
882 (count || 0) + " times";
885 calledInOrder: function (spies) {
886 for (var i = 1, l = spies.length; i < l; i++) {
887 if (!spies[i - 1].calledBefore(spies[i]) || !spies[i].called) {
895 orderByFirstCall: function (spies) {
896 return spies.sort(function (a, b) {
897 // uuid, won't ever be equal
898 var aCall = a.getCall(0);
899 var bCall = b.getCall(0);
900 var aId = aCall && aCall.callId || -1;
901 var bId = bCall && bCall.callId || -1;
903 return aId < bId ? -1 : 1;
909 logError: function (label, err) {
910 var msg = label + " threw exception: ";
911 sinon.log(msg + "[" + err.name + "] " + err.message);
912 if (err.stack) { sinon.log(err.stack); }
914 setTimeout(function () {
915 err.message = msg + err.message;
920 typeOf: function (value) {
921 if (value === null) {
924 else if (value === undefined) {
927 var string = Object.prototype.toString.call(value);
928 return string.substring(8, string.length - 1).toLowerCase();
931 createStubInstance: function (constructor) {
932 if (typeof constructor !== "function") {
933 throw new TypeError("The constructor should be a function.");
935 return sinon.stub(sinon.create(constructor.prototype));
938 restore: function (object) {
939 if (object !== null && typeof object === "object") {
940 for (var prop in object) {
941 if (isRestorable(object[prop])) {
942 object[prop].restore();
946 else if (isRestorable(object)) {
952 var isNode = typeof module !== "undefined" && module.exports && typeof require == "function";
953 var isAMD = typeof define === 'function' && typeof define.amd === 'object' && define.amd;
955 function makePublicAPI(require, exports, module) {
956 module.exports = sinon;
957 sinon.spy = require("./sinon/spy");
958 sinon.spyCall = require("./sinon/call");
959 sinon.behavior = require("./sinon/behavior");
960 sinon.stub = require("./sinon/stub");
961 sinon.mock = require("./sinon/mock");
962 sinon.collection = require("./sinon/collection");
963 sinon.assert = require("./sinon/assert");
964 sinon.sandbox = require("./sinon/sandbox");
965 sinon.test = require("./sinon/test");
966 sinon.testCase = require("./sinon/test_case");
967 sinon.match = require("./sinon/match");
971 define(makePublicAPI);
974 formatio = require("formatio");
976 makePublicAPI(require, exports, module);
980 var formatter = formatio.configure({ quoteStrings: false });
981 sinon.format = function () {
982 return formatter.ascii.apply(formatter, arguments);
986 var util = require("util");
987 sinon.format = function (value) {
988 return typeof value == "object" && value.toString === Object.prototype.toString ? util.inspect(value) : value;
991 /* Node, but no util module - would be very old, but better safe than
997 }(typeof formatio == "object" && formatio));
999 /* @depend ../sinon.js */
1000 /*jslint eqeqeq: false, onevar: false, plusplus: false*/
1001 /*global module, require, sinon*/
1005 * @author Maximilian Antoni (mail@maxantoni.de)
1008 * Copyright (c) 2012 Maximilian Antoni
1012 var commonJSModule = typeof module !== "undefined" && module.exports && typeof require == "function";
1014 if (!sinon && commonJSModule) {
1015 sinon = require("../sinon");
1022 function assertType(value, type, name) {
1023 var actual = sinon.typeOf(value);
1024 if (actual !== type) {
1025 throw new TypeError("Expected type of " + name + " to be " +
1026 type + ", but was " + actual);
1031 toString: function () {
1032 return this.message;
1036 function isMatcher(object) {
1037 return matcher.isPrototypeOf(object);
1040 function matchObject(expectation, actual) {
1041 if (actual === null || actual === undefined) {
1044 for (var key in expectation) {
1045 if (expectation.hasOwnProperty(key)) {
1046 var exp = expectation[key];
1047 var act = actual[key];
1048 if (match.isMatcher(exp)) {
1049 if (!exp.test(act)) {
1052 } else if (sinon.typeOf(exp) === "object") {
1053 if (!matchObject(exp, act)) {
1056 } else if (!sinon.deepEqual(exp, act)) {
1064 matcher.or = function (m2) {
1065 if (!arguments.length) {
1066 throw new TypeError("Matcher expected");
1067 } else if (!isMatcher(m2)) {
1071 var or = sinon.create(matcher);
1072 or.test = function (actual) {
1073 return m1.test(actual) || m2.test(actual);
1075 or.message = m1.message + ".or(" + m2.message + ")";
1079 matcher.and = function (m2) {
1080 if (!arguments.length) {
1081 throw new TypeError("Matcher expected");
1082 } else if (!isMatcher(m2)) {
1086 var and = sinon.create(matcher);
1087 and.test = function (actual) {
1088 return m1.test(actual) && m2.test(actual);
1090 and.message = m1.message + ".and(" + m2.message + ")";
1094 var match = function (expectation, message) {
1095 var m = sinon.create(matcher);
1096 var type = sinon.typeOf(expectation);
1099 if (typeof expectation.test === "function") {
1100 m.test = function (actual) {
1101 return expectation.test(actual) === true;
1103 m.message = "match(" + sinon.functionName(expectation.test) + ")";
1107 for (var key in expectation) {
1108 if (expectation.hasOwnProperty(key)) {
1109 str.push(key + ": " + expectation[key]);
1112 m.test = function (actual) {
1113 return matchObject(expectation, actual);
1115 m.message = "match(" + str.join(", ") + ")";
1118 m.test = function (actual) {
1119 return expectation == actual;
1123 m.test = function (actual) {
1124 if (typeof actual !== "string") {
1127 return actual.indexOf(expectation) !== -1;
1129 m.message = "match(\"" + expectation + "\")";
1132 m.test = function (actual) {
1133 if (typeof actual !== "string") {
1136 return expectation.test(actual);
1140 m.test = expectation;
1142 m.message = message;
1144 m.message = "match(" + sinon.functionName(expectation) + ")";
1148 m.test = function (actual) {
1149 return sinon.deepEqual(expectation, actual);
1153 m.message = "match(" + expectation + ")";
1158 match.isMatcher = isMatcher;
1160 match.any = match(function () {
1164 match.defined = match(function (actual) {
1165 return actual !== null && actual !== undefined;
1168 match.truthy = match(function (actual) {
1172 match.falsy = match(function (actual) {
1176 match.same = function (expectation) {
1177 return match(function (actual) {
1178 return expectation === actual;
1179 }, "same(" + expectation + ")");
1182 match.typeOf = function (type) {
1183 assertType(type, "string", "type");
1184 return match(function (actual) {
1185 return sinon.typeOf(actual) === type;
1186 }, "typeOf(\"" + type + "\")");
1189 match.instanceOf = function (type) {
1190 assertType(type, "function", "type");
1191 return match(function (actual) {
1192 return actual instanceof type;
1193 }, "instanceOf(" + sinon.functionName(type) + ")");
1196 function createPropertyMatcher(propertyTest, messagePrefix) {
1197 return function (property, value) {
1198 assertType(property, "string", "property");
1199 var onlyProperty = arguments.length === 1;
1200 var message = messagePrefix + "(\"" + property + "\"";
1201 if (!onlyProperty) {
1202 message += ", " + value;
1205 return match(function (actual) {
1206 if (actual === undefined || actual === null ||
1207 !propertyTest(actual, property)) {
1210 return onlyProperty || sinon.deepEqual(value, actual[property]);
1215 match.has = createPropertyMatcher(function (actual, property) {
1216 if (typeof actual === "object") {
1217 return property in actual;
1219 return actual[property] !== undefined;
1222 match.hasOwn = createPropertyMatcher(function (actual, property) {
1223 return actual.hasOwnProperty(property);
1226 match.bool = match.typeOf("boolean");
1227 match.number = match.typeOf("number");
1228 match.string = match.typeOf("string");
1229 match.object = match.typeOf("object");
1230 match.func = match.typeOf("function");
1231 match.array = match.typeOf("array");
1232 match.regexp = match.typeOf("regexp");
1233 match.date = match.typeOf("date");
1235 sinon.match = match;
1237 if (typeof define === "function" && define.amd) {
1238 define(["module"], function(module) { module.exports = match; });
1239 } else if (commonJSModule) {
1240 module.exports = match;
1242 }(typeof sinon == "object" && sinon || null));
1245 * @depend ../sinon.js
1248 /*jslint eqeqeq: false, onevar: false, plusplus: false*/
1249 /*global module, require, sinon*/
1253 * @author Christian Johansen (christian@cjohansen.no)
1254 * @author Maximilian Antoni (mail@maxantoni.de)
1257 * Copyright (c) 2010-2013 Christian Johansen
1258 * Copyright (c) 2013 Maximilian Antoni
1262 var commonJSModule = typeof module !== "undefined" && module.exports && typeof require == "function";
1263 if (!sinon && commonJSModule) {
1264 sinon = require("../sinon");
1271 function throwYieldError(proxy, text, args) {
1272 var msg = sinon.functionName(proxy) + text;
1274 msg += " Received [" + slice.call(args).join(", ") + "]";
1276 throw new Error(msg);
1279 var slice = Array.prototype.slice;
1282 calledOn: function calledOn(thisValue) {
1283 if (sinon.match && sinon.match.isMatcher(thisValue)) {
1284 return thisValue.test(this.thisValue);
1286 return this.thisValue === thisValue;
1289 calledWith: function calledWith() {
1290 for (var i = 0, l = arguments.length; i < l; i += 1) {
1291 if (!sinon.deepEqual(arguments[i], this.args[i])) {
1299 calledWithMatch: function calledWithMatch() {
1300 for (var i = 0, l = arguments.length; i < l; i += 1) {
1301 var actual = this.args[i];
1302 var expectation = arguments[i];
1303 if (!sinon.match || !sinon.match(expectation).test(actual)) {
1310 calledWithExactly: function calledWithExactly() {
1311 return arguments.length == this.args.length &&
1312 this.calledWith.apply(this, arguments);
1315 notCalledWith: function notCalledWith() {
1316 return !this.calledWith.apply(this, arguments);
1319 notCalledWithMatch: function notCalledWithMatch() {
1320 return !this.calledWithMatch.apply(this, arguments);
1323 returned: function returned(value) {
1324 return sinon.deepEqual(value, this.returnValue);
1327 threw: function threw(error) {
1328 if (typeof error === "undefined" || !this.exception) {
1329 return !!this.exception;
1332 return this.exception === error || this.exception.name === error;
1335 calledWithNew: function calledWithNew() {
1336 return this.proxy.prototype && this.thisValue instanceof this.proxy;
1339 calledBefore: function (other) {
1340 return this.callId < other.callId;
1343 calledAfter: function (other) {
1344 return this.callId > other.callId;
1347 callArg: function (pos) {
1351 callArgOn: function (pos, thisValue) {
1352 this.args[pos].apply(thisValue);
1355 callArgWith: function (pos) {
1356 this.callArgOnWith.apply(this, [pos, null].concat(slice.call(arguments, 1)));
1359 callArgOnWith: function (pos, thisValue) {
1360 var args = slice.call(arguments, 2);
1361 this.args[pos].apply(thisValue, args);
1364 "yield": function () {
1365 this.yieldOn.apply(this, [null].concat(slice.call(arguments, 0)));
1368 yieldOn: function (thisValue) {
1369 var args = this.args;
1370 for (var i = 0, l = args.length; i < l; ++i) {
1371 if (typeof args[i] === "function") {
1372 args[i].apply(thisValue, slice.call(arguments, 1));
1376 throwYieldError(this.proxy, " cannot yield since no callback was passed.", args);
1379 yieldTo: function (prop) {
1380 this.yieldToOn.apply(this, [prop, null].concat(slice.call(arguments, 1)));
1383 yieldToOn: function (prop, thisValue) {
1384 var args = this.args;
1385 for (var i = 0, l = args.length; i < l; ++i) {
1386 if (args[i] && typeof args[i][prop] === "function") {
1387 args[i][prop].apply(thisValue, slice.call(arguments, 2));
1391 throwYieldError(this.proxy, " cannot yield to '" + prop +
1392 "' since no callback was passed.", args);
1395 toString: function () {
1396 var callStr = this.proxy.toString() + "(";
1399 for (var i = 0, l = this.args.length; i < l; ++i) {
1400 args.push(sinon.format(this.args[i]));
1403 callStr = callStr + args.join(", ") + ")";
1405 if (typeof this.returnValue != "undefined") {
1406 callStr += " => " + sinon.format(this.returnValue);
1409 if (this.exception) {
1410 callStr += " !" + this.exception.name;
1412 if (this.exception.message) {
1413 callStr += "(" + this.exception.message + ")";
1421 callProto.invokeCallback = callProto.yield;
1423 function createSpyCall(spy, thisValue, args, returnValue, exception, id) {
1424 if (typeof id !== "number") {
1425 throw new TypeError("Call id is not a number");
1427 var proxyCall = sinon.create(callProto);
1428 proxyCall.proxy = spy;
1429 proxyCall.thisValue = thisValue;
1430 proxyCall.args = args;
1431 proxyCall.returnValue = returnValue;
1432 proxyCall.exception = exception;
1433 proxyCall.callId = id;
1437 createSpyCall.toString = callProto.toString; // used by mocks
1439 sinon.spyCall = createSpyCall;
1441 if (typeof define === "function" && define.amd) {
1442 define(["module"], function(module) { module.exports = createSpyCall; });
1443 } else if (commonJSModule) {
1444 module.exports = createSpyCall;
1446 }(typeof sinon == "object" && sinon || null));
1450 * @depend ../sinon.js
1453 /*jslint eqeqeq: false, onevar: false, plusplus: false*/
1454 /*global module, require, sinon*/
1458 * @author Christian Johansen (christian@cjohansen.no)
1461 * Copyright (c) 2010-2013 Christian Johansen
1465 var commonJSModule = typeof module !== "undefined" && module.exports && typeof require == "function";
1466 var push = Array.prototype.push;
1467 var slice = Array.prototype.slice;
1470 if (!sinon && commonJSModule) {
1471 sinon = require("../sinon");
1478 function spy(object, property) {
1479 if (!property && typeof object == "function") {
1480 return spy.create(object);
1483 if (!object && !property) {
1484 return spy.create(function () { });
1487 var method = object[property];
1488 return sinon.wrapMethod(object, property, spy.create(method));
1491 function matchingFake(fakes, args, strict) {
1496 for (var i = 0, l = fakes.length; i < l; i++) {
1497 if (fakes[i].matches(args, strict)) {
1503 function incrementCallCount() {
1505 this.callCount += 1;
1506 this.notCalled = false;
1507 this.calledOnce = this.callCount == 1;
1508 this.calledTwice = this.callCount == 2;
1509 this.calledThrice = this.callCount == 3;
1512 function createCallProperties() {
1513 this.firstCall = this.getCall(0);
1514 this.secondCall = this.getCall(1);
1515 this.thirdCall = this.getCall(2);
1516 this.lastCall = this.getCall(this.callCount - 1);
1519 var vars = "a,b,c,d,e,f,g,h,i,j,k,l";
1520 function createProxy(func) {
1521 // Retain the function length:
1524 eval("p = (function proxy(" + vars.substring(0, func.length * 2 - 1) +
1525 ") { return p.invoke(func, this, slice.call(arguments)); });");
1528 p = function proxy() {
1529 return p.invoke(func, this, slice.call(arguments));
1539 reset: function () {
1540 this.called = false;
1541 this.notCalled = true;
1542 this.calledOnce = false;
1543 this.calledTwice = false;
1544 this.calledThrice = false;
1546 this.firstCall = null;
1547 this.secondCall = null;
1548 this.thirdCall = null;
1549 this.lastCall = null;
1551 this.returnValues = [];
1552 this.thisValues = [];
1553 this.exceptions = [];
1556 for (var i = 0; i < this.fakes.length; i++) {
1557 this.fakes[i].reset();
1562 create: function create(func) {
1565 if (typeof func != "function") {
1566 func = function () { };
1568 name = sinon.functionName(func);
1571 var proxy = createProxy(func);
1573 sinon.extend(proxy, spy);
1574 delete proxy.create;
1575 sinon.extend(proxy, func);
1578 proxy.prototype = func.prototype;
1579 proxy.displayName = name || "spy";
1580 proxy.toString = sinon.functionToString;
1581 proxy._create = sinon.spy.create;
1582 proxy.id = "spy#" + uuid++;
1587 invoke: function invoke(func, thisValue, args) {
1588 var matching = matchingFake(this.fakes, args);
1589 var exception, returnValue;
1591 incrementCallCount.call(this);
1592 push.call(this.thisValues, thisValue);
1593 push.call(this.args, args);
1594 push.call(this.callIds, callId++);
1596 // Make call properties available from within the spied function:
1597 createCallProperties.call(this);
1601 returnValue = matching.invoke(func, thisValue, args);
1603 returnValue = (this.func || func).apply(thisValue, args);
1606 var thisCall = this.getCall(this.callCount - 1);
1607 if (thisCall.calledWithNew() && typeof returnValue !== 'object') {
1608 returnValue = thisValue;
1614 push.call(this.exceptions, exception);
1615 push.call(this.returnValues, returnValue);
1617 // Make return value and exception available in the calls:
1618 createCallProperties.call(this);
1620 if (exception !== undefined) {
1627 named: function named(name) {
1628 this.displayName = name;
1632 getCall: function getCall(i) {
1633 if (i < 0 || i >= this.callCount) {
1637 return sinon.spyCall(this, this.thisValues[i], this.args[i],
1638 this.returnValues[i], this.exceptions[i],
1642 getCalls: function () {
1646 for (i = 0; i < this.callCount; i++) {
1647 calls.push(this.getCall(i));
1653 calledBefore: function calledBefore(spyFn) {
1658 if (!spyFn.called) {
1662 return this.callIds[0] < spyFn.callIds[spyFn.callIds.length - 1];
1665 calledAfter: function calledAfter(spyFn) {
1666 if (!this.called || !spyFn.called) {
1670 return this.callIds[this.callCount - 1] > spyFn.callIds[spyFn.callCount - 1];
1673 withArgs: function () {
1674 var args = slice.call(arguments);
1677 var match = matchingFake(this.fakes, args, true);
1686 var original = this;
1687 var fake = this._create();
1688 fake.matchingAguments = args;
1690 push.call(this.fakes, fake);
1692 fake.withArgs = function () {
1693 return original.withArgs.apply(original, arguments);
1696 for (var i = 0; i < this.args.length; i++) {
1697 if (fake.matches(this.args[i])) {
1698 incrementCallCount.call(fake);
1699 push.call(fake.thisValues, this.thisValues[i]);
1700 push.call(fake.args, this.args[i]);
1701 push.call(fake.returnValues, this.returnValues[i]);
1702 push.call(fake.exceptions, this.exceptions[i]);
1703 push.call(fake.callIds, this.callIds[i]);
1706 createCallProperties.call(fake);
1711 matches: function (args, strict) {
1712 var margs = this.matchingAguments;
1714 if (margs.length <= args.length &&
1715 sinon.deepEqual(margs, args.slice(0, margs.length))) {
1716 return !strict || margs.length == args.length;
1720 printf: function (format) {
1722 var args = slice.call(arguments, 1);
1725 return (format || "").replace(/%(.)/g, function (match, specifyer) {
1726 formatter = spyApi.formatters[specifyer];
1728 if (typeof formatter == "function") {
1729 return formatter.call(null, spy, args);
1730 } else if (!isNaN(parseInt(specifyer, 10))) {
1731 return sinon.format(args[specifyer - 1]);
1734 return "%" + specifyer;
1739 function delegateToCalls(method, matchAny, actual, notCalled) {
1740 spyApi[method] = function () {
1743 return notCalled.apply(this, arguments);
1751 for (var i = 0, l = this.callCount; i < l; i += 1) {
1752 currentCall = this.getCall(i);
1754 if (currentCall[actual || method].apply(currentCall, arguments)) {
1763 return matches === this.callCount;
1767 delegateToCalls("calledOn", true);
1768 delegateToCalls("alwaysCalledOn", false, "calledOn");
1769 delegateToCalls("calledWith", true);
1770 delegateToCalls("calledWithMatch", true);
1771 delegateToCalls("alwaysCalledWith", false, "calledWith");
1772 delegateToCalls("alwaysCalledWithMatch", false, "calledWithMatch");
1773 delegateToCalls("calledWithExactly", true);
1774 delegateToCalls("alwaysCalledWithExactly", false, "calledWithExactly");
1775 delegateToCalls("neverCalledWith", false, "notCalledWith",
1776 function () { return true; });
1777 delegateToCalls("neverCalledWithMatch", false, "notCalledWithMatch",
1778 function () { return true; });
1779 delegateToCalls("threw", true);
1780 delegateToCalls("alwaysThrew", false, "threw");
1781 delegateToCalls("returned", true);
1782 delegateToCalls("alwaysReturned", false, "returned");
1783 delegateToCalls("calledWithNew", true);
1784 delegateToCalls("alwaysCalledWithNew", false, "calledWithNew");
1785 delegateToCalls("callArg", false, "callArgWith", function () {
1786 throw new Error(this.toString() + " cannot call arg since it was not yet invoked.");
1788 spyApi.callArgWith = spyApi.callArg;
1789 delegateToCalls("callArgOn", false, "callArgOnWith", function () {
1790 throw new Error(this.toString() + " cannot call arg since it was not yet invoked.");
1792 spyApi.callArgOnWith = spyApi.callArgOn;
1793 delegateToCalls("yield", false, "yield", function () {
1794 throw new Error(this.toString() + " cannot yield since it was not yet invoked.");
1796 // "invokeCallback" is an alias for "yield" since "yield" is invalid in strict mode.
1797 spyApi.invokeCallback = spyApi.yield;
1798 delegateToCalls("yieldOn", false, "yieldOn", function () {
1799 throw new Error(this.toString() + " cannot yield since it was not yet invoked.");
1801 delegateToCalls("yieldTo", false, "yieldTo", function (property) {
1802 throw new Error(this.toString() + " cannot yield to '" + property +
1803 "' since it was not yet invoked.");
1805 delegateToCalls("yieldToOn", false, "yieldToOn", function (property) {
1806 throw new Error(this.toString() + " cannot yield to '" + property +
1807 "' since it was not yet invoked.");
1810 spyApi.formatters = {
1811 "c": function (spy) {
1812 return sinon.timesInWords(spy.callCount);
1815 "n": function (spy) {
1816 return spy.toString();
1819 "C": function (spy) {
1822 for (var i = 0, l = spy.callCount; i < l; ++i) {
1823 var stringifiedCall = " " + spy.getCall(i).toString();
1824 if (/\n/.test(calls[i - 1])) {
1825 stringifiedCall = "\n" + stringifiedCall;
1827 push.call(calls, stringifiedCall);
1830 return calls.length > 0 ? "\n" + calls.join("\n") : "";
1833 "t": function (spy) {
1836 for (var i = 0, l = spy.callCount; i < l; ++i) {
1837 push.call(objects, sinon.format(spy.thisValues[i]));
1840 return objects.join(", ");
1843 "*": function (spy, args) {
1846 for (var i = 0, l = args.length; i < l; ++i) {
1847 push.call(formatted, sinon.format(args[i]));
1850 return formatted.join(", ");
1854 sinon.extend(spy, spyApi);
1856 spy.spyCall = sinon.spyCall;
1859 if (typeof define === "function" && define.amd) {
1860 define(["module"], function(module) { module.exports = spy; });
1861 } else if (commonJSModule) {
1862 module.exports = spy;
1864 }(typeof sinon == "object" && sinon || null));
1867 * @depend ../sinon.js
1869 /*jslint eqeqeq: false, onevar: false*/
1870 /*global module, require, sinon, process, setImmediate, setTimeout*/
1874 * @author Christian Johansen (christian@cjohansen.no)
1875 * @author Tim Fischbach (mail@timfischbach.de)
1878 * Copyright (c) 2010-2013 Christian Johansen
1882 var commonJSModule = typeof module !== "undefined" && module.exports && typeof require == "function";
1884 if (!sinon && commonJSModule) {
1885 sinon = require("../sinon");
1892 var slice = Array.prototype.slice;
1893 var join = Array.prototype.join;
1896 var nextTick = (function () {
1897 if (typeof process === "object" && typeof process.nextTick === "function") {
1898 return process.nextTick;
1899 } else if (typeof setImmediate === "function") {
1900 return setImmediate;
1902 return function (callback) {
1903 setTimeout(callback, 0);
1908 function throwsException(error, message) {
1909 if (typeof error == "string") {
1910 this.exception = new Error(message || "");
1911 this.exception.name = error;
1912 } else if (!error) {
1913 this.exception = new Error("Error");
1915 this.exception = error;
1921 function getCallback(behavior, args) {
1922 var callArgAt = behavior.callArgAt;
1924 if (callArgAt < 0) {
1925 var callArgProp = behavior.callArgProp;
1927 for (var i = 0, l = args.length; i < l; ++i) {
1928 if (!callArgProp && typeof args[i] == "function") {
1932 if (callArgProp && args[i] &&
1933 typeof args[i][callArgProp] == "function") {
1934 return args[i][callArgProp];
1941 return args[callArgAt];
1944 function getCallbackError(behavior, func, args) {
1945 if (behavior.callArgAt < 0) {
1948 if (behavior.callArgProp) {
1949 msg = sinon.functionName(behavior.stub) +
1950 " expected to yield to '" + behavior.callArgProp +
1951 "', but no object with such a property was passed.";
1953 msg = sinon.functionName(behavior.stub) +
1954 " expected to yield, but no callback was passed.";
1957 if (args.length > 0) {
1958 msg += " Received [" + join.call(args, ", ") + "]";
1964 return "argument at index " + behavior.callArgAt + " is not a function: " + func;
1967 function callCallback(behavior, args) {
1968 if (typeof behavior.callArgAt == "number") {
1969 var func = getCallback(behavior, args);
1971 if (typeof func != "function") {
1972 throw new TypeError(getCallbackError(behavior, func, args));
1975 if (behavior.callbackAsync) {
1976 nextTick(function() {
1977 func.apply(behavior.callbackContext, behavior.callbackArguments);
1980 func.apply(behavior.callbackContext, behavior.callbackArguments);
1986 create: function(stub) {
1987 var behavior = sinon.extend({}, sinon.behavior);
1988 delete behavior.create;
1989 behavior.stub = stub;
1994 isPresent: function() {
1995 return (typeof this.callArgAt == 'number' ||
1997 typeof this.returnArgAt == 'number' ||
1999 this.returnValueDefined);
2002 invoke: function(context, args) {
2003 callCallback(this, args);
2005 if (this.exception) {
2006 throw this.exception;
2007 } else if (typeof this.returnArgAt == 'number') {
2008 return args[this.returnArgAt];
2009 } else if (this.returnThis) {
2013 return this.returnValue;
2016 onCall: function(index) {
2017 return this.stub.onCall(index);
2020 onFirstCall: function() {
2021 return this.stub.onFirstCall();
2024 onSecondCall: function() {
2025 return this.stub.onSecondCall();
2028 onThirdCall: function() {
2029 return this.stub.onThirdCall();
2032 withArgs: function(/* arguments */) {
2033 throw new Error('Defining a stub by invoking "stub.onCall(...).withArgs(...)" is not supported. ' +
2034 'Use "stub.withArgs(...).onCall(...)" to define sequential behavior for calls with certain arguments.');
2037 callsArg: function callsArg(pos) {
2038 if (typeof pos != "number") {
2039 throw new TypeError("argument index is not number");
2042 this.callArgAt = pos;
2043 this.callbackArguments = [];
2044 this.callbackContext = undefined;
2045 this.callArgProp = undefined;
2046 this.callbackAsync = false;
2051 callsArgOn: function callsArgOn(pos, context) {
2052 if (typeof pos != "number") {
2053 throw new TypeError("argument index is not number");
2055 if (typeof context != "object") {
2056 throw new TypeError("argument context is not an object");
2059 this.callArgAt = pos;
2060 this.callbackArguments = [];
2061 this.callbackContext = context;
2062 this.callArgProp = undefined;
2063 this.callbackAsync = false;
2068 callsArgWith: function callsArgWith(pos) {
2069 if (typeof pos != "number") {
2070 throw new TypeError("argument index is not number");
2073 this.callArgAt = pos;
2074 this.callbackArguments = slice.call(arguments, 1);
2075 this.callbackContext = undefined;
2076 this.callArgProp = undefined;
2077 this.callbackAsync = false;
2082 callsArgOnWith: function callsArgWith(pos, context) {
2083 if (typeof pos != "number") {
2084 throw new TypeError("argument index is not number");
2086 if (typeof context != "object") {
2087 throw new TypeError("argument context is not an object");
2090 this.callArgAt = pos;
2091 this.callbackArguments = slice.call(arguments, 2);
2092 this.callbackContext = context;
2093 this.callArgProp = undefined;
2094 this.callbackAsync = false;
2099 yields: function () {
2100 this.callArgAt = -1;
2101 this.callbackArguments = slice.call(arguments, 0);
2102 this.callbackContext = undefined;
2103 this.callArgProp = undefined;
2104 this.callbackAsync = false;
2109 yieldsOn: function (context) {
2110 if (typeof context != "object") {
2111 throw new TypeError("argument context is not an object");
2114 this.callArgAt = -1;
2115 this.callbackArguments = slice.call(arguments, 1);
2116 this.callbackContext = context;
2117 this.callArgProp = undefined;
2118 this.callbackAsync = false;
2123 yieldsTo: function (prop) {
2124 this.callArgAt = -1;
2125 this.callbackArguments = slice.call(arguments, 1);
2126 this.callbackContext = undefined;
2127 this.callArgProp = prop;
2128 this.callbackAsync = false;
2133 yieldsToOn: function (prop, context) {
2134 if (typeof context != "object") {
2135 throw new TypeError("argument context is not an object");
2138 this.callArgAt = -1;
2139 this.callbackArguments = slice.call(arguments, 2);
2140 this.callbackContext = context;
2141 this.callArgProp = prop;
2142 this.callbackAsync = false;
2148 "throws": throwsException,
2149 throwsException: throwsException,
2151 returns: function returns(value) {
2152 this.returnValue = value;
2153 this.returnValueDefined = true;
2158 returnsArg: function returnsArg(pos) {
2159 if (typeof pos != "number") {
2160 throw new TypeError("argument index is not number");
2163 this.returnArgAt = pos;
2168 returnsThis: function returnsThis() {
2169 this.returnThis = true;
2175 // create asynchronous versions of callsArg* and yields* methods
2176 for (var method in proto) {
2177 // need to avoid creating anotherasync versions of the newly added async methods
2178 if (proto.hasOwnProperty(method) &&
2179 method.match(/^(callsArg|yields)/) &&
2180 !method.match(/Async/)) {
2181 proto[method + 'Async'] = (function (syncFnName) {
2182 return function () {
2183 var result = this[syncFnName].apply(this, arguments);
2184 this.callbackAsync = true;
2191 sinon.behavior = proto;
2193 if (typeof define === "function" && define.amd) {
2194 define(["module"], function(module) { module.exports = proto; });
2195 } else if (commonJSModule) {
2196 module.exports = proto;
2198 }(typeof sinon == "object" && sinon || null));
2201 * @depend ../sinon.js
2203 * @depend behavior.js
2205 /*jslint eqeqeq: false, onevar: false*/
2206 /*global module, require, sinon*/
2210 * @author Christian Johansen (christian@cjohansen.no)
2213 * Copyright (c) 2010-2013 Christian Johansen
2217 var commonJSModule = typeof module !== "undefined" && module.exports && typeof require == "function";
2219 if (!sinon && commonJSModule) {
2220 sinon = require("../sinon");
2227 function stub(object, property, func) {
2228 if (!!func && typeof func != "function") {
2229 throw new TypeError("Custom stub should be function");
2235 wrapper = sinon.spy && sinon.spy.create ? sinon.spy.create(func) : func;
2237 wrapper = stub.create();
2240 if (!object && typeof property === "undefined") {
2241 return sinon.stub.create();
2244 if (typeof property === "undefined" && typeof object == "object") {
2245 for (var prop in object) {
2246 if (typeof object[prop] === "function") {
2254 return sinon.wrapMethod(object, property, wrapper);
2257 function getDefaultBehavior(stub) {
2258 return stub.defaultBehavior || getParentBehaviour(stub) || sinon.behavior.create(stub);
2261 function getParentBehaviour(stub) {
2262 return (stub.parent && getCurrentBehavior(stub.parent));
2265 function getCurrentBehavior(stub) {
2266 var behavior = stub.behaviors[stub.callCount - 1];
2267 return behavior && behavior.isPresent() ? behavior : getDefaultBehavior(stub);
2272 sinon.extend(stub, (function () {
2274 create: function create() {
2275 var functionStub = function () {
2276 return getCurrentBehavior(functionStub).invoke(this, arguments);
2279 functionStub.id = "stub#" + uuid++;
2280 var orig = functionStub;
2281 functionStub = sinon.spy.create(functionStub);
2282 functionStub.func = orig;
2284 sinon.extend(functionStub, stub);
2285 functionStub._create = sinon.stub.create;
2286 functionStub.displayName = "stub";
2287 functionStub.toString = sinon.functionToString;
2289 functionStub.defaultBehavior = null;
2290 functionStub.behaviors = [];
2292 return functionStub;
2295 resetBehavior: function () {
2298 this.defaultBehavior = null;
2299 this.behaviors = [];
2301 delete this.returnValue;
2302 delete this.returnArgAt;
2303 this.returnThis = false;
2306 for (i = 0; i < this.fakes.length; i++) {
2307 this.fakes[i].resetBehavior();
2312 onCall: function(index) {
2313 if (!this.behaviors[index]) {
2314 this.behaviors[index] = sinon.behavior.create(this);
2317 return this.behaviors[index];
2320 onFirstCall: function() {
2321 return this.onCall(0);
2324 onSecondCall: function() {
2325 return this.onCall(1);
2328 onThirdCall: function() {
2329 return this.onCall(2);
2333 for (var method in sinon.behavior) {
2334 if (sinon.behavior.hasOwnProperty(method) &&
2335 !proto.hasOwnProperty(method) &&
2336 method != 'create' &&
2337 method != 'withArgs' &&
2338 method != 'invoke') {
2339 proto[method] = (function(behaviorMethod) {
2341 this.defaultBehavior = this.defaultBehavior || sinon.behavior.create(this);
2342 this.defaultBehavior[behaviorMethod].apply(this.defaultBehavior, arguments);
2354 if (typeof define === "function" && define.amd) {
2355 define(["module"], function(module) { module.exports = stub; });
2356 } else if (commonJSModule) {
2357 module.exports = stub;
2359 }(typeof sinon == "object" && sinon || null));
2362 * @depend ../sinon.js
2365 /*jslint eqeqeq: false, onevar: false, nomen: false*/
2366 /*global module, require, sinon*/
2370 * @author Christian Johansen (christian@cjohansen.no)
2373 * Copyright (c) 2010-2013 Christian Johansen
2377 var commonJSModule = typeof module !== "undefined" && module.exports && typeof require == "function";
2381 if (!sinon && commonJSModule) {
2382 sinon = require("../sinon");
2389 match = sinon.match;
2391 if (!match && commonJSModule) {
2392 match = require("./match");
2395 function mock(object) {
2397 return sinon.expectation.create("Anonymous mock");
2400 return mock.create(object);
2405 sinon.extend(mock, (function () {
2406 function each(collection, callback) {
2411 for (var i = 0, l = collection.length; i < l; i += 1) {
2412 callback(collection[i]);
2417 create: function create(object) {
2419 throw new TypeError("object is null");
2422 var mockObject = sinon.extend({}, mock);
2423 mockObject.object = object;
2424 delete mockObject.create;
2429 expects: function expects(method) {
2431 throw new TypeError("method is falsy");
2434 if (!this.expectations) {
2435 this.expectations = {};
2439 if (!this.expectations[method]) {
2440 this.expectations[method] = [];
2441 var mockObject = this;
2443 sinon.wrapMethod(this.object, method, function () {
2444 return mockObject.invokeMethod(method, this, arguments);
2447 push.call(this.proxies, method);
2450 var expectation = sinon.expectation.create(method);
2451 push.call(this.expectations[method], expectation);
2456 restore: function restore() {
2457 var object = this.object;
2459 each(this.proxies, function (proxy) {
2460 if (typeof object[proxy].restore == "function") {
2461 object[proxy].restore();
2466 verify: function verify() {
2467 var expectations = this.expectations || {};
2468 var messages = [], met = [];
2470 each(this.proxies, function (proxy) {
2471 each(expectations[proxy], function (expectation) {
2472 if (!expectation.met()) {
2473 push.call(messages, expectation.toString());
2475 push.call(met, expectation.toString());
2482 if (messages.length > 0) {
2483 sinon.expectation.fail(messages.concat(met).join("\n"));
2485 sinon.expectation.pass(messages.concat(met).join("\n"));
2491 invokeMethod: function invokeMethod(method, thisValue, args) {
2492 var expectations = this.expectations && this.expectations[method];
2493 var length = expectations && expectations.length || 0, i;
2495 for (i = 0; i < length; i += 1) {
2496 if (!expectations[i].met() &&
2497 expectations[i].allowsCall(thisValue, args)) {
2498 return expectations[i].apply(thisValue, args);
2502 var messages = [], available, exhausted = 0;
2504 for (i = 0; i < length; i += 1) {
2505 if (expectations[i].allowsCall(thisValue, args)) {
2506 available = available || expectations[i];
2510 push.call(messages, " " + expectations[i].toString());
2513 if (exhausted === 0) {
2514 return available.apply(thisValue, args);
2517 messages.unshift("Unexpected call: " + sinon.spyCall.toString.call({
2522 sinon.expectation.fail(messages.join("\n"));
2527 var times = sinon.timesInWords;
2529 sinon.expectation = (function () {
2530 var slice = Array.prototype.slice;
2531 var _invoke = sinon.spy.invoke;
2533 function callCountInWords(callCount) {
2534 if (callCount == 0) {
2535 return "never called";
2537 return "called " + times(callCount);
2541 function expectedCallCountInWords(expectation) {
2542 var min = expectation.minCalls;
2543 var max = expectation.maxCalls;
2545 if (typeof min == "number" && typeof max == "number") {
2546 var str = times(min);
2549 str = "at least " + str + " and at most " + times(max);
2555 if (typeof min == "number") {
2556 return "at least " + times(min);
2559 return "at most " + times(max);
2562 function receivedMinCalls(expectation) {
2563 var hasMinLimit = typeof expectation.minCalls == "number";
2564 return !hasMinLimit || expectation.callCount >= expectation.minCalls;
2567 function receivedMaxCalls(expectation) {
2568 if (typeof expectation.maxCalls != "number") {
2572 return expectation.callCount == expectation.maxCalls;
2575 function verifyMatcher(possibleMatcher, arg){
2576 if (match && match.isMatcher(possibleMatcher)) {
2577 return possibleMatcher.test(arg);
2587 create: function create(methodName) {
2588 var expectation = sinon.extend(sinon.stub.create(), sinon.expectation);
2589 delete expectation.create;
2590 expectation.method = methodName;
2595 invoke: function invoke(func, thisValue, args) {
2596 this.verifyCallAllowed(thisValue, args);
2598 return _invoke.apply(this, arguments);
2601 atLeast: function atLeast(num) {
2602 if (typeof num != "number") {
2603 throw new TypeError("'" + num + "' is not number");
2606 if (!this.limitsSet) {
2607 this.maxCalls = null;
2608 this.limitsSet = true;
2611 this.minCalls = num;
2616 atMost: function atMost(num) {
2617 if (typeof num != "number") {
2618 throw new TypeError("'" + num + "' is not number");
2621 if (!this.limitsSet) {
2622 this.minCalls = null;
2623 this.limitsSet = true;
2626 this.maxCalls = num;
2631 never: function never() {
2632 return this.exactly(0);
2635 once: function once() {
2636 return this.exactly(1);
2639 twice: function twice() {
2640 return this.exactly(2);
2643 thrice: function thrice() {
2644 return this.exactly(3);
2647 exactly: function exactly(num) {
2648 if (typeof num != "number") {
2649 throw new TypeError("'" + num + "' is not a number");
2653 return this.atMost(num);
2656 met: function met() {
2657 return !this.failed && receivedMinCalls(this);
2660 verifyCallAllowed: function verifyCallAllowed(thisValue, args) {
2661 if (receivedMaxCalls(this)) {
2663 sinon.expectation.fail(this.method + " already called " + times(this.maxCalls));
2666 if ("expectedThis" in this && this.expectedThis !== thisValue) {
2667 sinon.expectation.fail(this.method + " called with " + thisValue + " as thisValue, expected " +
2671 if (!("expectedArguments" in this)) {
2676 sinon.expectation.fail(this.method + " received no arguments, expected " +
2677 sinon.format(this.expectedArguments));
2680 if (args.length < this.expectedArguments.length) {
2681 sinon.expectation.fail(this.method + " received too few arguments (" + sinon.format(args) +
2682 "), expected " + sinon.format(this.expectedArguments));
2685 if (this.expectsExactArgCount &&
2686 args.length != this.expectedArguments.length) {
2687 sinon.expectation.fail(this.method + " received too many arguments (" + sinon.format(args) +
2688 "), expected " + sinon.format(this.expectedArguments));
2691 for (var i = 0, l = this.expectedArguments.length; i < l; i += 1) {
2693 if (!verifyMatcher(this.expectedArguments[i],args[i])) {
2694 sinon.expectation.fail(this.method + " received wrong arguments " + sinon.format(args) +
2695 ", didn't match " + this.expectedArguments.toString());
2698 if (!sinon.deepEqual(this.expectedArguments[i], args[i])) {
2699 sinon.expectation.fail(this.method + " received wrong arguments " + sinon.format(args) +
2700 ", expected " + sinon.format(this.expectedArguments));
2705 allowsCall: function allowsCall(thisValue, args) {
2706 if (this.met() && receivedMaxCalls(this)) {
2710 if ("expectedThis" in this && this.expectedThis !== thisValue) {
2714 if (!("expectedArguments" in this)) {
2720 if (args.length < this.expectedArguments.length) {
2724 if (this.expectsExactArgCount &&
2725 args.length != this.expectedArguments.length) {
2729 for (var i = 0, l = this.expectedArguments.length; i < l; i += 1) {
2730 if (!verifyMatcher(this.expectedArguments[i],args[i])) {
2734 if (!sinon.deepEqual(this.expectedArguments[i], args[i])) {
2742 withArgs: function withArgs() {
2743 this.expectedArguments = slice.call(arguments);
2747 withExactArgs: function withExactArgs() {
2748 this.withArgs.apply(this, arguments);
2749 this.expectsExactArgCount = true;
2753 on: function on(thisValue) {
2754 this.expectedThis = thisValue;
2758 toString: function () {
2759 var args = (this.expectedArguments || []).slice();
2761 if (!this.expectsExactArgCount) {
2762 push.call(args, "[...]");
2765 var callStr = sinon.spyCall.toString.call({
2766 proxy: this.method || "anonymous mock expectation",
2770 var message = callStr.replace(", [...", "[, ...") + " " +
2771 expectedCallCountInWords(this);
2774 return "Expectation met: " + message;
2777 return "Expected " + message + " (" +
2778 callCountInWords(this.callCount) + ")";
2781 verify: function verify() {
2783 sinon.expectation.fail(this.toString());
2785 sinon.expectation.pass(this.toString());
2791 pass: function(message) {
2792 sinon.assert.pass(message);
2794 fail: function (message) {
2795 var exception = new Error(message);
2796 exception.name = "ExpectationError";
2805 if (typeof define === "function" && define.amd) {
2806 define(["module"], function(module) { module.exports = mock; });
2807 } else if (commonJSModule) {
2808 module.exports = mock;
2810 }(typeof sinon == "object" && sinon || null));
2813 * @depend ../sinon.js
2817 /*jslint eqeqeq: false, onevar: false, forin: true*/
2818 /*global module, require, sinon*/
2820 * Collections of stubs, spies and mocks.
2822 * @author Christian Johansen (christian@cjohansen.no)
2825 * Copyright (c) 2010-2013 Christian Johansen
2829 var commonJSModule = typeof module !== "undefined" && module.exports && typeof require == "function";
2831 var hasOwnProperty = Object.prototype.hasOwnProperty;
2833 if (!sinon && commonJSModule) {
2834 sinon = require("../sinon");
2841 function getFakes(fakeCollection) {
2842 if (!fakeCollection.fakes) {
2843 fakeCollection.fakes = [];
2846 return fakeCollection.fakes;
2849 function each(fakeCollection, method) {
2850 var fakes = getFakes(fakeCollection);
2852 for (var i = 0, l = fakes.length; i < l; i += 1) {
2853 if (typeof fakes[i][method] == "function") {
2859 function compact(fakeCollection) {
2860 var fakes = getFakes(fakeCollection);
2862 while (i < fakes.length) {
2868 verify: function resolve() {
2869 each(this, "verify");
2872 restore: function restore() {
2873 each(this, "restore");
2877 verifyAndRestore: function verifyAndRestore() {
2893 add: function add(fake) {
2894 push.call(getFakes(this), fake);
2898 spy: function spy() {
2899 return this.add(sinon.spy.apply(sinon, arguments));
2902 stub: function stub(object, property, value) {
2904 var original = object[property];
2906 if (typeof original != "function") {
2907 if (!hasOwnProperty.call(object, property)) {
2908 throw new TypeError("Cannot stub non-existent own property " + property);
2911 object[property] = value;
2914 restore: function () {
2915 object[property] = original;
2920 if (!property && !!object && typeof object == "object") {
2921 var stubbedObj = sinon.stub.apply(sinon, arguments);
2923 for (var prop in stubbedObj) {
2924 if (typeof stubbedObj[prop] === "function") {
2925 this.add(stubbedObj[prop]);
2932 return this.add(sinon.stub.apply(sinon, arguments));
2935 mock: function mock() {
2936 return this.add(sinon.mock.apply(sinon, arguments));
2939 inject: function inject(obj) {
2942 obj.spy = function () {
2943 return col.spy.apply(col, arguments);
2946 obj.stub = function () {
2947 return col.stub.apply(col, arguments);
2950 obj.mock = function () {
2951 return col.mock.apply(col, arguments);
2958 sinon.collection = collection;
2960 if (typeof define === "function" && define.amd) {
2961 define(["module"], function(module) { module.exports = collection; });
2962 } else if (commonJSModule) {
2963 module.exports = collection;
2965 }(typeof sinon == "object" && sinon || null));
2967 /*jslint eqeqeq: false, plusplus: false, evil: true, onevar: false, browser: true, forin: false*/
2968 /*global module, require, window*/
2979 * Inspired by jsUnitMockTimeOut from JsUnit
2981 * @author Christian Johansen (christian@cjohansen.no)
2984 * Copyright (c) 2010-2013 Christian Johansen
2987 if (typeof sinon == "undefined") {
2991 (function (global) {
2992 // node expects setTimeout/setInterval to return a fn object w/ .ref()/.unref()
2993 // browsers, a number.
2994 // see https://github.com/cjohansen/Sinon.JS/pull/436
2995 var timeoutResult = setTimeout(function() {}, 0);
2996 var addTimerReturnsObject = typeof timeoutResult === 'object';
2997 clearTimeout(timeoutResult);
3001 function addTimer(args, recurring) {
3002 if (args.length === 0) {
3003 throw new Error("Function requires at least 1 parameter");
3006 if (typeof args[0] === "undefined") {
3007 throw new Error("Callback must be provided to timer calls");
3011 var delay = args[1] || 0;
3013 if (!this.timeouts) {
3017 this.timeouts[toId] = {
3020 callAt: this.now + delay,
3021 invokeArgs: Array.prototype.slice.call(args, 2)
3024 if (recurring === true) {
3025 this.timeouts[toId].interval = delay;
3028 if (addTimerReturnsObject) {
3032 unref: function() {}
3040 function parseTime(str) {
3045 var strings = str.split(":");
3046 var l = strings.length, i = l;
3049 if (l > 3 || !/^(\d\d:){0,2}\d\d?$/.test(str)) {
3050 throw new Error("tick only understands numbers and 'h:m:s'");
3054 parsed = parseInt(strings[i], 10);
3057 throw new Error("Invalid time " + str);
3060 ms += parsed * Math.pow(60, (l - i - 1));
3066 function createObject(object) {
3069 if (Object.create) {
3070 newObject = Object.create(object);
3072 var F = function () {};
3073 F.prototype = object;
3074 newObject = new F();
3077 newObject.Date.clock = newObject;
3084 create: function create(now) {
3085 var clock = createObject(this);
3087 if (typeof now == "number") {
3091 if (!!now && typeof now == "object") {
3092 throw new TypeError("now should be milliseconds since UNIX epoch");
3098 setTimeout: function setTimeout(callback, timeout) {
3099 return addTimer.call(this, arguments, false);
3102 clearTimeout: function clearTimeout(timerId) {
3104 // null appears to be allowed in most browsers, and appears to be relied upon by some libraries, like Bootstrap carousel
3107 if (!this.timeouts) {
3110 // in Node, timerId is an object with .ref()/.unref(), and
3111 // its .id field is the actual timer id.
3112 if (typeof timerId === 'object') {
3113 timerId = timerId.id
3115 if (timerId in this.timeouts) {
3116 delete this.timeouts[timerId];
3120 setInterval: function setInterval(callback, timeout) {
3121 return addTimer.call(this, arguments, true);
3124 clearInterval: function clearInterval(timerId) {
3125 this.clearTimeout(timerId);
3128 setImmediate: function setImmediate(callback) {
3129 var passThruArgs = Array.prototype.slice.call(arguments, 1);
3131 return addTimer.call(this, [callback, 0].concat(passThruArgs), false);
3134 clearImmediate: function clearImmediate(timerId) {
3135 this.clearTimeout(timerId);
3138 tick: function tick(ms) {
3139 ms = typeof ms == "number" ? ms : parseTime(ms);
3140 var tickFrom = this.now, tickTo = this.now + ms, previous = this.now;
3141 var timer = this.firstTimerInRange(tickFrom, tickTo);
3144 while (timer && tickFrom <= tickTo) {
3145 if (this.timeouts[timer.id]) {
3146 tickFrom = this.now = timer.callAt;
3148 this.callTimer(timer);
3150 firstException = firstException || e;
3154 timer = this.firstTimerInRange(previous, tickTo);
3155 previous = tickFrom;
3160 if (firstException) {
3161 throw firstException;
3167 firstTimerInRange: function (from, to) {
3168 var timer, smallest = null, originalTimer;
3170 for (var id in this.timeouts) {
3171 if (this.timeouts.hasOwnProperty(id)) {
3172 if (this.timeouts[id].callAt < from || this.timeouts[id].callAt > to) {
3176 if (smallest === null || this.timeouts[id].callAt < smallest) {
3177 originalTimer = this.timeouts[id];
3178 smallest = this.timeouts[id].callAt;
3181 func: this.timeouts[id].func,
3182 callAt: this.timeouts[id].callAt,
3183 interval: this.timeouts[id].interval,
3184 id: this.timeouts[id].id,
3185 invokeArgs: this.timeouts[id].invokeArgs
3191 return timer || null;
3194 callTimer: function (timer) {
3195 if (typeof timer.interval == "number") {
3196 this.timeouts[timer.id].callAt += timer.interval;
3198 delete this.timeouts[timer.id];
3202 if (typeof timer.func == "function") {
3203 timer.func.apply(null, timer.invokeArgs);
3211 if (!this.timeouts[timer.id]) {
3223 reset: function reset() {
3227 Date: (function () {
3228 var NativeDate = Date;
3230 function ClockDate(year, month, date, hour, minute, second, ms) {
3231 // Defensive and verbose to avoid potential harm in passing
3232 // explicit undefined when user does not pass argument
3233 switch (arguments.length) {
3235 return new NativeDate(ClockDate.clock.now);
3237 return new NativeDate(year);
3239 return new NativeDate(year, month);
3241 return new NativeDate(year, month, date);
3243 return new NativeDate(year, month, date, hour);
3245 return new NativeDate(year, month, date, hour, minute);
3247 return new NativeDate(year, month, date, hour, minute, second);
3249 return new NativeDate(year, month, date, hour, minute, second, ms);
3253 return mirrorDateProperties(ClockDate, NativeDate);
3257 function mirrorDateProperties(target, source) {
3259 target.now = function now() {
3260 return target.clock.now;
3266 if (source.toSource) {
3267 target.toSource = function toSource() {
3268 return source.toSource();
3271 delete target.toSource;
3274 target.toString = function toString() {
3275 return source.toString();
3278 target.prototype = source.prototype;
3279 target.parse = source.parse;
3280 target.UTC = source.UTC;
3281 target.prototype.toUTCString = source.prototype.toUTCString;
3283 for (var prop in source) {
3284 if (source.hasOwnProperty(prop)) {
3285 target[prop] = source[prop];
3292 var methods = ["Date", "setTimeout", "setInterval",
3293 "clearTimeout", "clearInterval"];
3295 if (typeof global.setImmediate !== "undefined") {
3296 methods.push("setImmediate");
3299 if (typeof global.clearImmediate !== "undefined") {
3300 methods.push("clearImmediate");
3303 function restore() {
3306 for (var i = 0, l = this.methods.length; i < l; i++) {
3307 method = this.methods[i];
3309 if (global[method].hadOwnProperty) {
3310 global[method] = this["_" + method];
3313 delete global[method];
3318 // Prevent multiple executions which will completely remove these props
3322 function stubGlobal(method, clock) {
3323 clock[method].hadOwnProperty = Object.prototype.hasOwnProperty.call(global, method);
3324 clock["_" + method] = global[method];
3326 if (method == "Date") {
3327 var date = mirrorDateProperties(clock[method], global[method]);
3328 global[method] = date;
3330 global[method] = function () {
3331 return clock[method].apply(clock, arguments);
3334 for (var prop in clock[method]) {
3335 if (clock[method].hasOwnProperty(prop)) {
3336 global[method][prop] = clock[method][prop];
3341 global[method].clock = clock;
3344 sinon.useFakeTimers = function useFakeTimers(now) {
3345 var clock = sinon.clock.create(now);
3346 clock.restore = restore;
3347 clock.methods = Array.prototype.slice.call(arguments,
3348 typeof now == "number" ? 1 : 0);
3350 if (clock.methods.length === 0) {
3351 clock.methods = methods;
3354 for (var i = 0, l = clock.methods.length; i < l; i++) {
3355 stubGlobal(clock.methods[i], clock);
3360 }(typeof global != "undefined" && typeof global !== "function" ? global : this));
3363 setTimeout: setTimeout,
3364 clearTimeout: clearTimeout,
3365 setImmediate: (typeof setImmediate !== "undefined" ? setImmediate : undefined),
3366 clearImmediate: (typeof clearImmediate !== "undefined" ? clearImmediate: undefined),
3367 setInterval: setInterval,
3368 clearInterval: clearInterval,
3372 if (typeof module !== 'undefined' && module.exports) {
3373 module.exports = sinon;
3376 /*jslint eqeqeq: false, onevar: false*/
3377 /*global sinon, module, require, ActiveXObject, XMLHttpRequest, DOMParser*/
3379 * Minimal Event interface implementation
3381 * Original implementation by Sven Fuchs: https://gist.github.com/995028
3382 * Modifications and tests by Christian Johansen.
3384 * @author Sven Fuchs (svenfuchs@artweb-design.de)
3385 * @author Christian Johansen (christian@cjohansen.no)
3388 * Copyright (c) 2011 Sven Fuchs, Christian Johansen
3391 if (typeof sinon == "undefined") {
3398 sinon.Event = function Event(type, bubbles, cancelable, target) {
3399 this.initEvent(type, bubbles, cancelable, target);
3402 sinon.Event.prototype = {
3403 initEvent: function(type, bubbles, cancelable, target) {
3405 this.bubbles = bubbles;
3406 this.cancelable = cancelable;
3407 this.target = target;
3410 stopPropagation: function () {},
3412 preventDefault: function () {
3413 this.defaultPrevented = true;
3417 sinon.ProgressEvent = function ProgressEvent(type, progressEventRaw, target) {
3418 this.initEvent(type, false, false, target);
3419 this.loaded = progressEventRaw.loaded || null;
3420 this.total = progressEventRaw.total || null;
3423 sinon.ProgressEvent.prototype = new sinon.Event();
3425 sinon.ProgressEvent.prototype.constructor = sinon.ProgressEvent;
3427 sinon.CustomEvent = function CustomEvent(type, customData, target) {
3428 this.initEvent(type, false, false, target);
3429 this.detail = customData.detail || null;
3432 sinon.CustomEvent.prototype = new sinon.Event();
3434 sinon.CustomEvent.prototype.constructor = sinon.CustomEvent;
3436 sinon.EventTarget = {
3437 addEventListener: function addEventListener(event, listener) {
3438 this.eventListeners = this.eventListeners || {};
3439 this.eventListeners[event] = this.eventListeners[event] || [];
3440 push.call(this.eventListeners[event], listener);
3443 removeEventListener: function removeEventListener(event, listener) {
3444 var listeners = this.eventListeners && this.eventListeners[event] || [];
3446 for (var i = 0, l = listeners.length; i < l; ++i) {
3447 if (listeners[i] == listener) {
3448 return listeners.splice(i, 1);
3453 dispatchEvent: function dispatchEvent(event) {
3454 var type = event.type;
3455 var listeners = this.eventListeners && this.eventListeners[type] || [];
3457 for (var i = 0; i < listeners.length; i++) {
3458 if (typeof listeners[i] == "function") {
3459 listeners[i].call(this, event);
3461 listeners[i].handleEvent(event);
3465 return !!event.defaultPrevented;
3471 * @depend ../../sinon.js
3474 /*jslint eqeqeq: false, onevar: false*/
3475 /*global sinon, module, require, ActiveXObject, XMLHttpRequest, DOMParser*/
3477 * Fake XMLHttpRequest object
3479 * @author Christian Johansen (christian@cjohansen.no)
3482 * Copyright (c) 2010-2013 Christian Johansen
3485 // wrapper for global
3487 if (typeof sinon === "undefined") {
3491 var supportsProgress = typeof ProgressEvent !== "undefined";
3492 var supportsCustomEvent = typeof CustomEvent !== "undefined";
3493 sinon.xhr = { XMLHttpRequest: global.XMLHttpRequest };
3494 var xhr = sinon.xhr;
3495 xhr.GlobalXMLHttpRequest = global.XMLHttpRequest;
3496 xhr.GlobalActiveXObject = global.ActiveXObject;
3497 xhr.supportsActiveX = typeof xhr.GlobalActiveXObject != "undefined";
3498 xhr.supportsXHR = typeof xhr.GlobalXMLHttpRequest != "undefined";
3499 xhr.workingXHR = xhr.supportsXHR ? xhr.GlobalXMLHttpRequest : xhr.supportsActiveX
3500 ? function() { return new xhr.GlobalActiveXObject("MSXML2.XMLHTTP.3.0") } : false;
3501 xhr.supportsCORS = xhr.supportsXHR && 'withCredentials' in (new sinon.xhr.GlobalXMLHttpRequest());
3504 var unsafeHeaders = {
3505 "Accept-Charset": true,
3506 "Accept-Encoding": true,
3508 "Content-Length": true,
3511 "Content-Transfer-Encoding": true,
3519 "Transfer-Encoding": true,
3526 function FakeXMLHttpRequest() {
3527 this.readyState = FakeXMLHttpRequest.UNSENT;
3528 this.requestHeaders = {};
3529 this.requestBody = null;
3531 this.statusText = "";
3532 this.upload = new UploadProgress();
3533 if (sinon.xhr.supportsCORS) {
3534 this.withCredentials = false;
3539 var events = ["loadstart", "load", "abort", "loadend"];
3541 function addEventListener(eventName) {
3542 xhr.addEventListener(eventName, function (event) {
3543 var listener = xhr["on" + eventName];
3545 if (listener && typeof listener == "function") {
3546 listener.call(this, event);
3551 for (var i = events.length - 1; i >= 0; i--) {
3552 addEventListener(events[i]);
3555 if (typeof FakeXMLHttpRequest.onCreate == "function") {
3556 FakeXMLHttpRequest.onCreate(this);
3560 // An upload object is created for each
3561 // FakeXMLHttpRequest and allows upload
3562 // events to be simulated using uploadProgress
3564 function UploadProgress() {
3565 this.eventListeners = {
3573 UploadProgress.prototype.addEventListener = function(event, listener) {
3574 this.eventListeners[event].push(listener);
3577 UploadProgress.prototype.removeEventListener = function(event, listener) {
3578 var listeners = this.eventListeners[event] || [];
3580 for (var i = 0, l = listeners.length; i < l; ++i) {
3581 if (listeners[i] == listener) {
3582 return listeners.splice(i, 1);
3587 UploadProgress.prototype.dispatchEvent = function(event) {
3588 var listeners = this.eventListeners[event.type] || [];
3590 for (var i = 0, listener; (listener = listeners[i]) != null; i++) {
3595 function verifyState(xhr) {
3596 if (xhr.readyState !== FakeXMLHttpRequest.OPENED) {
3597 throw new Error("INVALID_STATE_ERR");
3601 throw new Error("INVALID_STATE_ERR");
3605 // filtering to enable a white-list version of Sinon FakeXhr,
3606 // where whitelisted requests are passed through to real XHR
3607 function each(collection, callback) {
3608 if (!collection) return;
3609 for (var i = 0, l = collection.length; i < l; i += 1) {
3610 callback(collection[i]);
3613 function some(collection, callback) {
3614 for (var index = 0; index < collection.length; index++) {
3615 if(callback(collection[index]) === true) return true;
3619 // largest arity in XHR is 5 - XHR#open
3620 var apply = function(obj,method,args) {
3621 switch(args.length) {
3622 case 0: return obj[method]();
3623 case 1: return obj[method](args[0]);
3624 case 2: return obj[method](args[0],args[1]);
3625 case 3: return obj[method](args[0],args[1],args[2]);
3626 case 4: return obj[method](args[0],args[1],args[2],args[3]);
3627 case 5: return obj[method](args[0],args[1],args[2],args[3],args[4]);
3631 FakeXMLHttpRequest.filters = [];
3632 FakeXMLHttpRequest.addFilter = function(fn) {
3633 this.filters.push(fn)
3635 var IE6Re = /MSIE 6/;
3636 FakeXMLHttpRequest.defake = function(fakeXhr,xhrArgs) {
3637 var xhr = new sinon.xhr.workingXHR();
3638 each(["open","setRequestHeader","send","abort","getResponseHeader",
3639 "getAllResponseHeaders","addEventListener","overrideMimeType","removeEventListener"],
3641 fakeXhr[method] = function() {
3642 return apply(xhr,method,arguments);
3646 var copyAttrs = function(args) {
3647 each(args, function(attr) {
3649 fakeXhr[attr] = xhr[attr]
3651 if(!IE6Re.test(navigator.userAgent)) throw e;
3656 var stateChange = function() {
3657 fakeXhr.readyState = xhr.readyState;
3658 if(xhr.readyState >= FakeXMLHttpRequest.HEADERS_RECEIVED) {
3659 copyAttrs(["status","statusText"]);
3661 if(xhr.readyState >= FakeXMLHttpRequest.LOADING) {
3662 copyAttrs(["responseText"]);
3664 if(xhr.readyState === FakeXMLHttpRequest.DONE) {
3665 copyAttrs(["responseXML"]);
3667 if(fakeXhr.onreadystatechange) fakeXhr.onreadystatechange.call(fakeXhr, { target: fakeXhr });
3669 if(xhr.addEventListener) {
3670 for(var event in fakeXhr.eventListeners) {
3671 if(fakeXhr.eventListeners.hasOwnProperty(event)) {
3672 each(fakeXhr.eventListeners[event],function(handler) {
3673 xhr.addEventListener(event, handler);
3677 xhr.addEventListener("readystatechange",stateChange);
3679 xhr.onreadystatechange = stateChange;
3681 apply(xhr,"open",xhrArgs);
3683 FakeXMLHttpRequest.useFilters = false;
3685 function verifyRequestOpened(xhr) {
3686 if (xhr.readyState != FakeXMLHttpRequest.OPENED) {
3687 throw new Error("INVALID_STATE_ERR - " + xhr.readyState);
3691 function verifyRequestSent(xhr) {
3692 if (xhr.readyState == FakeXMLHttpRequest.DONE) {
3693 throw new Error("Request done");
3697 function verifyHeadersReceived(xhr) {
3698 if (xhr.async && xhr.readyState != FakeXMLHttpRequest.HEADERS_RECEIVED) {
3699 throw new Error("No headers received");
3703 function verifyResponseBodyType(body) {
3704 if (typeof body != "string") {
3705 var error = new Error("Attempted to respond to fake XMLHttpRequest with " +
3706 body + ", which is not a string.");
3707 error.name = "InvalidBodyException";
3712 sinon.extend(FakeXMLHttpRequest.prototype, sinon.EventTarget, {
3715 open: function open(method, url, async, username, password) {
3716 this.method = method;
3718 this.async = typeof async == "boolean" ? async : true;
3719 this.username = username;
3720 this.password = password;
3721 this.responseText = null;
3722 this.responseXML = null;
3723 this.requestHeaders = {};
3724 this.sendFlag = false;
3725 if(sinon.FakeXMLHttpRequest.useFilters === true) {
3726 var xhrArgs = arguments;
3727 var defake = some(FakeXMLHttpRequest.filters,function(filter) {
3728 return filter.apply(this,xhrArgs)
3731 return sinon.FakeXMLHttpRequest.defake(this,arguments);
3734 this.readyStateChange(FakeXMLHttpRequest.OPENED);
3737 readyStateChange: function readyStateChange(state) {
3738 this.readyState = state;
3740 if (typeof this.onreadystatechange == "function") {
3742 this.onreadystatechange();
3744 sinon.logError("Fake XHR onreadystatechange handler", e);
3748 this.dispatchEvent(new sinon.Event("readystatechange"));
3750 switch (this.readyState) {
3751 case FakeXMLHttpRequest.DONE:
3752 this.dispatchEvent(new sinon.Event("load", false, false, this));
3753 this.dispatchEvent(new sinon.Event("loadend", false, false, this));
3754 this.upload.dispatchEvent(new sinon.Event("load", false, false, this));
3755 if (supportsProgress) {
3756 this.upload.dispatchEvent(new sinon.ProgressEvent('progress', {loaded: 100, total: 100}));
3762 setRequestHeader: function setRequestHeader(header, value) {
3765 if (unsafeHeaders[header] || /^(Sec-|Proxy-)/.test(header)) {
3766 throw new Error("Refused to set unsafe header \"" + header + "\"");
3769 if (this.requestHeaders[header]) {
3770 this.requestHeaders[header] += "," + value;
3772 this.requestHeaders[header] = value;
3777 setResponseHeaders: function setResponseHeaders(headers) {
3778 verifyRequestOpened(this);
3779 this.responseHeaders = {};
3781 for (var header in headers) {
3782 if (headers.hasOwnProperty(header)) {
3783 this.responseHeaders[header] = headers[header];
3788 this.readyStateChange(FakeXMLHttpRequest.HEADERS_RECEIVED);
3790 this.readyState = FakeXMLHttpRequest.HEADERS_RECEIVED;
3794 // Currently treats ALL data as a DOMString (i.e. no Document)
3795 send: function send(data) {
3798 if (!/^(get|head)$/i.test(this.method)) {
3799 if (this.requestHeaders["Content-Type"]) {
3800 var value = this.requestHeaders["Content-Type"].split(";");
3801 this.requestHeaders["Content-Type"] = value[0] + ";charset=utf-8";
3803 this.requestHeaders["Content-Type"] = "text/plain;charset=utf-8";
3806 this.requestBody = data;
3809 this.errorFlag = false;
3810 this.sendFlag = this.async;
3811 this.readyStateChange(FakeXMLHttpRequest.OPENED);
3813 if (typeof this.onSend == "function") {
3817 this.dispatchEvent(new sinon.Event("loadstart", false, false, this));
3820 abort: function abort() {
3821 this.aborted = true;
3822 this.responseText = null;
3823 this.errorFlag = true;
3824 this.requestHeaders = {};
3826 if (this.readyState > sinon.FakeXMLHttpRequest.UNSENT && this.sendFlag) {
3827 this.readyStateChange(sinon.FakeXMLHttpRequest.DONE);
3828 this.sendFlag = false;
3831 this.readyState = sinon.FakeXMLHttpRequest.UNSENT;
3833 this.dispatchEvent(new sinon.Event("abort", false, false, this));
3835 this.upload.dispatchEvent(new sinon.Event("abort", false, false, this));
3837 if (typeof this.onerror === "function") {
3842 getResponseHeader: function getResponseHeader(header) {
3843 if (this.readyState < FakeXMLHttpRequest.HEADERS_RECEIVED) {
3847 if (/^Set-Cookie2?$/i.test(header)) {
3851 header = header.toLowerCase();
3853 for (var h in this.responseHeaders) {
3854 if (h.toLowerCase() == header) {
3855 return this.responseHeaders[h];
3862 getAllResponseHeaders: function getAllResponseHeaders() {
3863 if (this.readyState < FakeXMLHttpRequest.HEADERS_RECEIVED) {
3869 for (var header in this.responseHeaders) {
3870 if (this.responseHeaders.hasOwnProperty(header) &&
3871 !/^Set-Cookie2?$/i.test(header)) {
3872 headers += header + ": " + this.responseHeaders[header] + "\r\n";
3879 setResponseBody: function setResponseBody(body) {
3880 verifyRequestSent(this);
3881 verifyHeadersReceived(this);
3882 verifyResponseBodyType(body);
3884 var chunkSize = this.chunkSize || 10;
3886 this.responseText = "";
3890 this.readyStateChange(FakeXMLHttpRequest.LOADING);
3893 this.responseText += body.substring(index, index + chunkSize);
3895 } while (index < body.length);
3897 var type = this.getResponseHeader("Content-Type");
3899 if (this.responseText &&
3900 (!type || /(text\/xml)|(application\/xml)|(\+xml)/.test(type))) {
3902 this.responseXML = FakeXMLHttpRequest.parseXML(this.responseText);
3904 // Unable to parse XML - no biggie
3909 this.readyStateChange(FakeXMLHttpRequest.DONE);
3911 this.readyState = FakeXMLHttpRequest.DONE;
3915 respond: function respond(status, headers, body) {
3916 this.status = typeof status == "number" ? status : 200;
3917 this.statusText = FakeXMLHttpRequest.statusCodes[this.status];
3918 this.setResponseHeaders(headers || {});
3919 this.setResponseBody(body || "");
3922 uploadProgress: function uploadProgress(progressEventRaw) {
3923 if (supportsProgress) {
3924 this.upload.dispatchEvent(new sinon.ProgressEvent("progress", progressEventRaw));
3928 uploadError: function uploadError(error) {
3929 if (supportsCustomEvent) {
3930 this.upload.dispatchEvent(new sinon.CustomEvent("error", {"detail": error}));
3935 sinon.extend(FakeXMLHttpRequest, {
3938 HEADERS_RECEIVED: 2,
3943 // Borrowed from JSpec
3944 FakeXMLHttpRequest.parseXML = function parseXML(text) {
3947 if (typeof DOMParser != "undefined") {
3948 var parser = new DOMParser();
3949 xmlDoc = parser.parseFromString(text, "text/xml");
3951 xmlDoc = new ActiveXObject("Microsoft.XMLDOM");
3952 xmlDoc.async = "false";
3953 xmlDoc.loadXML(text);
3959 FakeXMLHttpRequest.statusCodes = {
3961 101: "Switching Protocols",
3965 203: "Non-Authoritative Information",
3967 205: "Reset Content",
3968 206: "Partial Content",
3969 300: "Multiple Choice",
3970 301: "Moved Permanently",
3973 304: "Not Modified",
3975 307: "Temporary Redirect",
3977 401: "Unauthorized",
3978 402: "Payment Required",
3981 405: "Method Not Allowed",
3982 406: "Not Acceptable",
3983 407: "Proxy Authentication Required",
3984 408: "Request Timeout",
3987 411: "Length Required",
3988 412: "Precondition Failed",
3989 413: "Request Entity Too Large",
3990 414: "Request-URI Too Long",
3991 415: "Unsupported Media Type",
3992 416: "Requested Range Not Satisfiable",
3993 417: "Expectation Failed",
3994 422: "Unprocessable Entity",
3995 500: "Internal Server Error",
3996 501: "Not Implemented",
3998 503: "Service Unavailable",
3999 504: "Gateway Timeout",
4000 505: "HTTP Version Not Supported"
4003 sinon.useFakeXMLHttpRequest = function () {
4004 sinon.FakeXMLHttpRequest.restore = function restore(keepOnCreate) {
4005 if (xhr.supportsXHR) {
4006 global.XMLHttpRequest = xhr.GlobalXMLHttpRequest;
4009 if (xhr.supportsActiveX) {
4010 global.ActiveXObject = xhr.GlobalActiveXObject;
4013 delete sinon.FakeXMLHttpRequest.restore;
4015 if (keepOnCreate !== true) {
4016 delete sinon.FakeXMLHttpRequest.onCreate;
4019 if (xhr.supportsXHR) {
4020 global.XMLHttpRequest = sinon.FakeXMLHttpRequest;
4023 if (xhr.supportsActiveX) {
4024 global.ActiveXObject = function ActiveXObject(objId) {
4025 if (objId == "Microsoft.XMLHTTP" || /^Msxml2\.XMLHTTP/i.test(objId)) {
4027 return new sinon.FakeXMLHttpRequest();
4030 return new xhr.GlobalActiveXObject(objId);
4034 return sinon.FakeXMLHttpRequest;
4037 sinon.FakeXMLHttpRequest = FakeXMLHttpRequest;
4039 })((function(){ return typeof global === "object" ? global : this; })());
4041 if (typeof module !== 'undefined' && module.exports) {
4042 module.exports = sinon;
4046 * @depend fake_xml_http_request.js
4048 /*jslint eqeqeq: false, onevar: false, regexp: false, plusplus: false*/
4049 /*global module, require, window*/
4051 * The Sinon "server" mimics a web server that receives requests from
4052 * sinon.FakeXMLHttpRequest and provides an API to respond to those requests,
4053 * both synchronously and asynchronously. To respond synchronuously, canned
4054 * answers have to be provided upfront.
4056 * @author Christian Johansen (christian@cjohansen.no)
4059 * Copyright (c) 2010-2013 Christian Johansen
4062 if (typeof sinon == "undefined") {
4066 sinon.fakeServer = (function () {
4070 function create(proto) {
4071 F.prototype = proto;
4075 function responseArray(handler) {
4076 var response = handler;
4078 if (Object.prototype.toString.call(handler) != "[object Array]") {
4079 response = [200, {}, handler];
4082 if (typeof response[2] != "string") {
4083 throw new TypeError("Fake server response body should be string, but was " +
4084 typeof response[2]);
4090 var wloc = typeof window !== "undefined" ? window.location : {};
4091 var rCurrLoc = new RegExp("^" + wloc.protocol + "//" + wloc.host);
4093 function matchOne(response, reqMethod, reqUrl) {
4094 var rmeth = response.method;
4095 var matchMethod = !rmeth || rmeth.toLowerCase() == reqMethod.toLowerCase();
4096 var url = response.url;
4097 var matchUrl = !url || url == reqUrl || (typeof url.test == "function" && url.test(reqUrl));
4099 return matchMethod && matchUrl;
4102 function match(response, request) {
4103 var requestUrl = request.url;
4105 if (!/^https?:\/\//.test(requestUrl) || rCurrLoc.test(requestUrl)) {
4106 requestUrl = requestUrl.replace(rCurrLoc, "");
4109 if (matchOne(response, this.getHTTPMethod(request), requestUrl)) {
4110 if (typeof response.response == "function") {
4111 var ru = response.url;
4112 var args = [request].concat(ru && typeof ru.exec == "function" ? ru.exec(requestUrl).slice(1) : []);
4113 return response.response.apply(response, args);
4123 create: function () {
4124 var server = create(this);
4125 this.xhr = sinon.useFakeXMLHttpRequest();
4126 server.requests = [];
4128 this.xhr.onCreate = function (xhrObj) {
4129 server.addRequest(xhrObj);
4135 addRequest: function addRequest(xhrObj) {
4137 push.call(this.requests, xhrObj);
4139 xhrObj.onSend = function () {
4140 server.handleRequest(this);
4142 if (server.autoRespond && !server.responding) {
4143 setTimeout(function () {
4144 server.responding = false;
4146 }, server.autoRespondAfter || 10);
4148 server.responding = true;
4153 getHTTPMethod: function getHTTPMethod(request) {
4154 if (this.fakeHTTPMethods && /post/i.test(request.method)) {
4155 var matches = (request.requestBody || "").match(/_method=([^\b;]+)/);
4156 return !!matches ? matches[1] : request.method;
4159 return request.method;
4162 handleRequest: function handleRequest(xhr) {
4168 push.call(this.queue, xhr);
4170 this.processRequest(xhr);
4174 log: function(response, request) {
4177 str = "Request:\n" + sinon.format(request) + "\n\n";
4178 str += "Response:\n" + sinon.format(response) + "\n\n";
4183 respondWith: function respondWith(method, url, body) {
4184 if (arguments.length == 1 && typeof method != "function") {
4185 this.response = responseArray(method);
4189 if (!this.responses) { this.responses = []; }
4191 if (arguments.length == 1) {
4193 url = method = null;
4196 if (arguments.length == 2) {
4202 push.call(this.responses, {
4205 response: typeof body == "function" ? body : responseArray(body)
4209 respond: function respond() {
4210 if (arguments.length > 0) this.respondWith.apply(this, arguments);
4211 var queue = this.queue || [];
4212 var requests = queue.splice(0, queue.length);
4215 while(request = requests.shift()) {
4216 this.processRequest(request);
4220 processRequest: function processRequest(request) {
4222 if (request.aborted) {
4226 var response = this.response || [404, {}, ""];
4228 if (this.responses) {
4229 for (var l = this.responses.length, i = l - 1; i >= 0; i--) {
4230 if (match.call(this, this.responses[i], request)) {
4231 response = this.responses[i].response;
4237 if (request.readyState != 4) {
4238 sinon.fakeServer.log(response, request);
4240 request.respond(response[0], response[1], response[2]);
4243 sinon.logError("Fake server request processing", e);
4247 restore: function restore() {
4248 return this.xhr.restore && this.xhr.restore.apply(this.xhr, arguments);
4253 if (typeof module !== 'undefined' && module.exports) {
4254 module.exports = sinon;
4258 * @depend fake_server.js
4259 * @depend fake_timers.js
4261 /*jslint browser: true, eqeqeq: false, onevar: false*/
4264 * Add-on for sinon.fakeServer that automatically handles a fake timer along with
4265 * the FakeXMLHttpRequest. The direct inspiration for this add-on is jQuery
4266 * 1.3.x, which does not use xhr object's onreadystatehandler at all - instead,
4267 * it polls the object for completion with setInterval. Dispite the direct
4268 * motivation, there is nothing jQuery-specific in this file, so it can be used
4269 * in any environment where the ajax implementation depends on setInterval or
4272 * @author Christian Johansen (christian@cjohansen.no)
4275 * Copyright (c) 2010-2013 Christian Johansen
4279 function Server() {}
4280 Server.prototype = sinon.fakeServer;
4282 sinon.fakeServerWithClock = new Server();
4284 sinon.fakeServerWithClock.addRequest = function addRequest(xhr) {
4286 if (typeof setTimeout.clock == "object") {
4287 this.clock = setTimeout.clock;
4289 this.clock = sinon.useFakeTimers();
4290 this.resetClock = true;
4293 if (!this.longestTimeout) {
4294 var clockSetTimeout = this.clock.setTimeout;
4295 var clockSetInterval = this.clock.setInterval;
4298 this.clock.setTimeout = function (fn, timeout) {
4299 server.longestTimeout = Math.max(timeout, server.longestTimeout || 0);
4301 return clockSetTimeout.apply(this, arguments);
4304 this.clock.setInterval = function (fn, timeout) {
4305 server.longestTimeout = Math.max(timeout, server.longestTimeout || 0);
4307 return clockSetInterval.apply(this, arguments);
4312 return sinon.fakeServer.addRequest.call(this, xhr);
4315 sinon.fakeServerWithClock.respond = function respond() {
4316 var returnVal = sinon.fakeServer.respond.apply(this, arguments);
4319 this.clock.tick(this.longestTimeout || 0);
4320 this.longestTimeout = 0;
4322 if (this.resetClock) {
4323 this.clock.restore();
4324 this.resetClock = false;
4331 sinon.fakeServerWithClock.restore = function restore() {
4333 this.clock.restore();
4336 return sinon.fakeServer.restore.apply(this, arguments);
4341 * @depend ../sinon.js
4342 * @depend collection.js
4343 * @depend util/fake_timers.js
4344 * @depend util/fake_server_with_clock.js
4346 /*jslint eqeqeq: false, onevar: false, plusplus: false*/
4347 /*global require, module*/
4349 * Manages fake collections as well as fake utilities such as Sinon's
4350 * timers and fake XHR implementation in one convenient object.
4352 * @author Christian Johansen (christian@cjohansen.no)
4355 * Copyright (c) 2010-2013 Christian Johansen
4358 if (typeof module !== "undefined" && module.exports && typeof require == "function") {
4359 var sinon = require("../sinon");
4360 sinon.extend(sinon, require("./util/fake_timers"));
4366 function exposeValue(sandbox, config, key, value) {
4371 if (config.injectInto && !(key in config.injectInto)) {
4372 config.injectInto[key] = value;
4373 sandbox.injectedKeys.push(key);
4375 push.call(sandbox.args, value);
4379 function prepareSandboxFromConfig(config) {
4380 var sandbox = sinon.create(sinon.sandbox);
4382 if (config.useFakeServer) {
4383 if (typeof config.useFakeServer == "object") {
4384 sandbox.serverPrototype = config.useFakeServer;
4387 sandbox.useFakeServer();
4390 if (config.useFakeTimers) {
4391 if (typeof config.useFakeTimers == "object") {
4392 sandbox.useFakeTimers.apply(sandbox, config.useFakeTimers);
4394 sandbox.useFakeTimers();
4401 sinon.sandbox = sinon.extend(sinon.create(sinon.collection), {
4402 useFakeTimers: function useFakeTimers() {
4403 this.clock = sinon.useFakeTimers.apply(sinon, arguments);
4405 return this.add(this.clock);
4408 serverPrototype: sinon.fakeServer,
4410 useFakeServer: function useFakeServer() {
4411 var proto = this.serverPrototype || sinon.fakeServer;
4413 if (!proto || !proto.create) {
4417 this.server = proto.create();
4418 return this.add(this.server);
4421 inject: function (obj) {
4422 sinon.collection.inject.call(this, obj);
4425 obj.clock = this.clock;
4429 obj.server = this.server;
4430 obj.requests = this.server.requests;
4436 restore: function () {
4437 sinon.collection.restore.apply(this, arguments);
4438 this.restoreContext();
4441 restoreContext: function () {
4442 if (this.injectedKeys) {
4443 for (var i = 0, j = this.injectedKeys.length; i < j; i++) {
4444 delete this.injectInto[this.injectedKeys[i]];
4446 this.injectedKeys = [];
4450 create: function (config) {
4452 return sinon.create(sinon.sandbox);
4455 var sandbox = prepareSandboxFromConfig(config);
4456 sandbox.args = sandbox.args || [];
4457 sandbox.injectedKeys = [];
4458 sandbox.injectInto = config.injectInto;
4459 var prop, value, exposed = sandbox.inject({});
4461 if (config.properties) {
4462 for (var i = 0, l = config.properties.length; i < l; i++) {
4463 prop = config.properties[i];
4464 value = exposed[prop] || prop == "sandbox" && sandbox;
4465 exposeValue(sandbox, config, prop, value);
4468 exposeValue(sandbox, config, "sandbox", value);
4475 sinon.sandbox.useFakeXMLHttpRequest = sinon.sandbox.useFakeServer;
4477 if (typeof define === "function" && define.amd) {
4478 define(["module"], function(module) { module.exports = sinon.sandbox; });
4479 } else if (typeof module !== 'undefined' && module.exports) {
4480 module.exports = sinon.sandbox;
4485 * @depend ../sinon.js
4488 * @depend sandbox.js
4490 /*jslint eqeqeq: false, onevar: false, forin: true, plusplus: false*/
4491 /*global module, require, sinon*/
4493 * Test function, sandboxes fakes
4495 * @author Christian Johansen (christian@cjohansen.no)
4498 * Copyright (c) 2010-2013 Christian Johansen
4502 var commonJSModule = typeof module !== "undefined" && module.exports && typeof require == "function";
4504 if (!sinon && commonJSModule) {
4505 sinon = require("../sinon");
4512 function test(callback) {
4513 var type = typeof callback;
4515 if (type != "function") {
4516 throw new TypeError("sinon.test needs to wrap a test function, got " + type);
4519 function sinonSandboxedTest() {
4520 var config = sinon.getConfig(sinon.config);
4521 config.injectInto = config.injectIntoThis && this || config.injectInto;
4522 var sandbox = sinon.sandbox.create(config);
4523 var exception, result;
4524 var args = Array.prototype.slice.call(arguments).concat(sandbox.args);
4527 result = callback.apply(this, args);
4532 if (typeof exception !== "undefined") {
4537 sandbox.verifyAndRestore();
4543 if (callback.length) {
4544 return function sinonAsyncSandboxedTest(callback) {
4545 return sinonSandboxedTest.apply(this, arguments);
4549 return sinonSandboxedTest;
4553 injectIntoThis: true,
4555 properties: ["spy", "stub", "mock", "clock", "server", "requests"],
4556 useFakeTimers: true,
4562 if (typeof define === "function" && define.amd) {
4563 define(["module"], function(module) { module.exports = test; });
4564 } else if (commonJSModule) {
4565 module.exports = test;
4567 }(typeof sinon == "object" && sinon || null));
4570 * @depend ../sinon.js
4573 /*jslint eqeqeq: false, onevar: false, eqeqeq: false*/
4574 /*global module, require, sinon*/
4576 * Test case, sandboxes all test functions
4578 * @author Christian Johansen (christian@cjohansen.no)
4581 * Copyright (c) 2010-2013 Christian Johansen
4585 var commonJSModule = typeof module !== "undefined" && module.exports && typeof require == "function";
4587 if (!sinon && commonJSModule) {
4588 sinon = require("../sinon");
4591 if (!sinon || !Object.prototype.hasOwnProperty) {
4595 function createTest(property, setUp, tearDown) {
4596 return function () {
4598 setUp.apply(this, arguments);
4601 var exception, result;
4604 result = property.apply(this, arguments);
4610 tearDown.apply(this, arguments);
4621 function testCase(tests, prefix) {
4623 if (!tests || typeof tests != "object") {
4624 throw new TypeError("sinon.testCase needs an object with test functions");
4628 prefix = prefix || "test";
4629 var rPrefix = new RegExp("^" + prefix);
4630 var methods = {}, testName, property, method;
4631 var setUp = tests.setUp;
4632 var tearDown = tests.tearDown;
4634 for (testName in tests) {
4635 if (tests.hasOwnProperty(testName)) {
4636 property = tests[testName];
4638 if (/^(setUp|tearDown)$/.test(testName)) {
4642 if (typeof property == "function" && rPrefix.test(testName)) {
4645 if (setUp || tearDown) {
4646 method = createTest(property, setUp, tearDown);
4649 methods[testName] = sinon.test(method);
4651 methods[testName] = tests[testName];
4659 sinon.testCase = testCase;
4661 if (typeof define === "function" && define.amd) {
4662 define(["module"], function(module) { module.exports = testCase; });
4663 } else if (commonJSModule) {
4664 module.exports = testCase;
4666 }(typeof sinon == "object" && sinon || null));
4669 * @depend ../sinon.js
4672 /*jslint eqeqeq: false, onevar: false, nomen: false, plusplus: false*/
4673 /*global module, require, sinon*/
4675 * Assertions matching the test spy retrieval interface.
4677 * @author Christian Johansen (christian@cjohansen.no)
4680 * Copyright (c) 2010-2013 Christian Johansen
4683 (function (sinon, global) {
4684 var commonJSModule = typeof module !== "undefined" && module.exports && typeof require == "function";
4685 var slice = Array.prototype.slice;
4688 if (!sinon && commonJSModule) {
4689 sinon = require("../sinon");
4696 function verifyIsStub() {
4699 for (var i = 0, l = arguments.length; i < l; ++i) {
4700 method = arguments[i];
4703 assert.fail("fake is not a spy");
4706 if (typeof method != "function") {
4707 assert.fail(method + " is not a function");
4710 if (typeof method.getCall != "function") {
4711 assert.fail(method + " is not stubbed");
4716 function failAssertion(object, msg) {
4717 object = object || global;
4718 var failMethod = object.fail || assert.fail;
4719 failMethod.call(object, msg);
4722 function mirrorPropAsAssertion(name, method, message) {
4723 if (arguments.length == 2) {
4728 assert[name] = function (fake) {
4731 var args = slice.call(arguments, 1);
4734 if (typeof method == "function") {
4735 failed = !method(fake);
4737 failed = typeof fake[method] == "function" ?
4738 !fake[method].apply(fake, args) : !fake[method];
4742 failAssertion(this, fake.printf.apply(fake, [message].concat(args)));
4749 function exposedName(prefix, prop) {
4750 return !prefix || /^fail/.test(prop) ? prop :
4751 prefix + prop.slice(0, 1).toUpperCase() + prop.slice(1);
4755 failException: "AssertError",
4757 fail: function fail(message) {
4758 var error = new Error(message);
4759 error.name = this.failException || assert.failException;
4764 pass: function pass(assertion) {},
4766 callOrder: function assertCallOrder() {
4767 verifyIsStub.apply(null, arguments);
4768 var expected = "", actual = "";
4770 if (!sinon.calledInOrder(arguments)) {
4772 expected = [].join.call(arguments, ", ");
4773 var calls = slice.call(arguments);
4774 var i = calls.length;
4776 if (!calls[--i].called) {
4780 actual = sinon.orderByFirstCall(calls).join(", ");
4782 // If this fails, we'll just fall back to the blank string
4785 failAssertion(this, "expected " + expected + " to be " +
4786 "called in order but were called as " + actual);
4788 assert.pass("callOrder");
4792 callCount: function assertCallCount(method, count) {
4793 verifyIsStub(method);
4795 if (method.callCount != count) {
4796 var msg = "expected %n to be called " + sinon.timesInWords(count) +
4797 " but was called %c%C";
4798 failAssertion(this, method.printf(msg));
4800 assert.pass("callCount");
4804 expose: function expose(target, options) {
4806 throw new TypeError("target is null or undefined");
4809 var o = options || {};
4810 var prefix = typeof o.prefix == "undefined" && "assert" || o.prefix;
4811 var includeFail = typeof o.includeFail == "undefined" || !!o.includeFail;
4813 for (var method in this) {
4814 if (method != "export" && (includeFail || !/^(fail)/.test(method))) {
4815 target[exposedName(prefix, method)] = this[method];
4822 match: function match(actual, expectation) {
4823 var matcher = sinon.match(expectation);
4824 if (matcher.test(actual)) {
4825 assert.pass("match");
4828 "expected value to match",
4829 " expected = " + sinon.format(expectation),
4830 " actual = " + sinon.format(actual)
4832 failAssertion(this, formatted.join("\n"));
4837 mirrorPropAsAssertion("called", "expected %n to have been called at least once but was never called");
4838 mirrorPropAsAssertion("notCalled", function (spy) { return !spy.called; },
4839 "expected %n to not have been called but was called %c%C");
4840 mirrorPropAsAssertion("calledOnce", "expected %n to be called once but was called %c%C");
4841 mirrorPropAsAssertion("calledTwice", "expected %n to be called twice but was called %c%C");
4842 mirrorPropAsAssertion("calledThrice", "expected %n to be called thrice but was called %c%C");
4843 mirrorPropAsAssertion("calledOn", "expected %n to be called with %1 as this but was called with %t");
4844 mirrorPropAsAssertion("alwaysCalledOn", "expected %n to always be called with %1 as this but was called with %t");
4845 mirrorPropAsAssertion("calledWithNew", "expected %n to be called with new");
4846 mirrorPropAsAssertion("alwaysCalledWithNew", "expected %n to always be called with new");
4847 mirrorPropAsAssertion("calledWith", "expected %n to be called with arguments %*%C");
4848 mirrorPropAsAssertion("calledWithMatch", "expected %n to be called with match %*%C");
4849 mirrorPropAsAssertion("alwaysCalledWith", "expected %n to always be called with arguments %*%C");
4850 mirrorPropAsAssertion("alwaysCalledWithMatch", "expected %n to always be called with match %*%C");
4851 mirrorPropAsAssertion("calledWithExactly", "expected %n to be called with exact arguments %*%C");
4852 mirrorPropAsAssertion("alwaysCalledWithExactly", "expected %n to always be called with exact arguments %*%C");
4853 mirrorPropAsAssertion("neverCalledWith", "expected %n to never be called with arguments %*%C");
4854 mirrorPropAsAssertion("neverCalledWithMatch", "expected %n to never be called with match %*%C");
4855 mirrorPropAsAssertion("threw", "%n did not throw exception%C");
4856 mirrorPropAsAssertion("alwaysThrew", "%n did not always throw exception%C");
4858 sinon.assert = assert;
4860 if (typeof define === "function" && define.amd) {
4861 define(["module"], function(module) { module.exports = assert; });
4862 } else if (commonJSModule) {
4863 module.exports = assert;
4865 }(typeof sinon == "object" && sinon || null, typeof window != "undefined" ? window : (typeof self != "undefined") ? self : global));
4868 * @depend ../../sinon.js
4871 /*jslint eqeqeq: false, onevar: false*/
4872 /*global sinon, module, require, XDomainRequest*/
4874 * Fake XDomainRequest object
4877 if (typeof sinon == "undefined") {
4880 sinon.xdr = { XDomainRequest: this.XDomainRequest };
4882 // wrapper for global
4883 (function (global) {
4884 var xdr = sinon.xdr;
4885 xdr.GlobalXDomainRequest = global.XDomainRequest;
4886 xdr.supportsXDR = typeof xdr.GlobalXDomainRequest != "undefined";
4887 xdr.workingXDR = xdr.supportsXDR ? xdr.GlobalXDomainRequest : false;
4889 function FakeXDomainRequest() {
4890 this.readyState = FakeXDomainRequest.UNSENT;
4891 this.requestBody = null;
4892 this.requestHeaders = {};
4894 this.timeout = null;
4896 if (typeof FakeXDomainRequest.onCreate == "function") {
4897 FakeXDomainRequest.onCreate(this);
4901 function verifyState(xdr) {
4902 if (xdr.readyState !== FakeXDomainRequest.OPENED) {
4903 throw new Error("INVALID_STATE_ERR");
4907 throw new Error("INVALID_STATE_ERR");
4911 function verifyRequestSent(xdr) {
4912 if (xdr.readyState == FakeXDomainRequest.UNSENT) {
4913 throw new Error("Request not sent");
4915 if (xdr.readyState == FakeXDomainRequest.DONE) {
4916 throw new Error("Request done");
4920 function verifyResponseBodyType(body) {
4921 if (typeof body != "string") {
4922 var error = new Error("Attempted to respond to fake XDomainRequest with " +
4923 body + ", which is not a string.");
4924 error.name = "InvalidBodyException";
4929 sinon.extend(FakeXDomainRequest.prototype, sinon.EventTarget, {
4930 open: function open(method, url) {
4931 this.method = method;
4934 this.responseText = null;
4935 this.sendFlag = false;
4937 this.readyStateChange(FakeXDomainRequest.OPENED);
4940 readyStateChange: function readyStateChange(state) {
4941 this.readyState = state;
4943 switch (this.readyState) {
4944 case FakeXDomainRequest.UNSENT:
4946 case FakeXDomainRequest.OPENED:
4948 case FakeXDomainRequest.LOADING:
4950 //raise the progress event
4951 eventName = 'onprogress';
4954 case FakeXDomainRequest.DONE:
4955 if (this.isTimeout){
4956 eventName = 'ontimeout'
4958 else if (this.errorFlag || (this.status < 200 || this.status > 299)) {
4959 eventName = 'onerror';
4962 eventName = 'onload'
4967 // raising event (if defined)
4969 if (typeof this[eventName] == "function") {
4973 sinon.logError("Fake XHR " + eventName + " handler", e);
4979 send: function send(data) {
4982 if (!/^(get|head)$/i.test(this.method)) {
4983 this.requestBody = data;
4985 this.requestHeaders["Content-Type"] = "text/plain;charset=utf-8";
4987 this.errorFlag = false;
4988 this.sendFlag = true;
4989 this.readyStateChange(FakeXDomainRequest.OPENED);
4991 if (typeof this.onSend == "function") {
4996 abort: function abort() {
4997 this.aborted = true;
4998 this.responseText = null;
4999 this.errorFlag = true;
5001 if (this.readyState > sinon.FakeXDomainRequest.UNSENT && this.sendFlag) {
5002 this.readyStateChange(sinon.FakeXDomainRequest.DONE);
5003 this.sendFlag = false;
5007 setResponseBody: function setResponseBody(body) {
5008 verifyRequestSent(this);
5009 verifyResponseBodyType(body);
5011 var chunkSize = this.chunkSize || 10;
5013 this.responseText = "";
5016 this.readyStateChange(FakeXDomainRequest.LOADING);
5017 this.responseText += body.substring(index, index + chunkSize);
5019 } while (index < body.length);
5021 this.readyStateChange(FakeXDomainRequest.DONE);
5024 respond: function respond(status, contentType, body) {
5025 // content-type ignored, since XDomainRequest does not carry this
5026 // we keep the same syntax for respond(...) as for FakeXMLHttpRequest to ease
5027 // test integration across browsers
5028 this.status = typeof status == "number" ? status : 200;
5029 this.setResponseBody(body || "");
5032 simulatetimeout: function(){
5034 this.isTimeout = true;
5035 // Access to this should actually throw an error
5036 this.responseText = undefined;
5037 this.readyStateChange(FakeXDomainRequest.DONE);
5041 sinon.extend(FakeXDomainRequest, {
5048 sinon.useFakeXDomainRequest = function () {
5049 sinon.FakeXDomainRequest.restore = function restore(keepOnCreate) {
5050 if (xdr.supportsXDR) {
5051 global.XDomainRequest = xdr.GlobalXDomainRequest;
5054 delete sinon.FakeXDomainRequest.restore;
5056 if (keepOnCreate !== true) {
5057 delete sinon.FakeXDomainRequest.onCreate;
5060 if (xdr.supportsXDR) {
5061 global.XDomainRequest = sinon.FakeXDomainRequest;
5063 return sinon.FakeXDomainRequest;
5066 sinon.FakeXDomainRequest = FakeXDomainRequest;
5069 if (typeof module == "object" && typeof require == "function") {
5070 module.exports = sinon;
5073 return sinon;}.call(typeof window != 'undefined' && window || {}));