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
|| {}));