Mercurial > hg > OKFNAnnotator
comparison annotator_files/lib/vendor/jasmine-1.1.0/jasmine.js @ 3:6356e78ccf5c
new version contains Annotator JS files to be used with FilesystemSite.
author | casties |
---|---|
date | Thu, 05 Apr 2012 19:37:27 +0200 |
parents | |
children |
comparison
equal
deleted
inserted
replaced
2:4c6c8835fc5c | 3:6356e78ccf5c |
---|---|
1 var isCommonJS = typeof window == "undefined"; | |
2 | |
3 /** | |
4 * Top level namespace for Jasmine, a lightweight JavaScript BDD/spec/testing framework. | |
5 * | |
6 * @namespace | |
7 */ | |
8 var jasmine = {}; | |
9 if (isCommonJS) exports.jasmine = jasmine; | |
10 /** | |
11 * @private | |
12 */ | |
13 jasmine.unimplementedMethod_ = function() { | |
14 throw new Error("unimplemented method"); | |
15 }; | |
16 | |
17 /** | |
18 * Use <code>jasmine.undefined</code> instead of <code>undefined</code>, since <code>undefined</code> is just | |
19 * a plain old variable and may be redefined by somebody else. | |
20 * | |
21 * @private | |
22 */ | |
23 jasmine.undefined = jasmine.___undefined___; | |
24 | |
25 /** | |
26 * Show diagnostic messages in the console if set to true | |
27 * | |
28 */ | |
29 jasmine.VERBOSE = false; | |
30 | |
31 /** | |
32 * Default interval in milliseconds for event loop yields (e.g. to allow network activity or to refresh the screen with the HTML-based runner). Small values here may result in slow test running. Zero means no updates until all tests have completed. | |
33 * | |
34 */ | |
35 jasmine.DEFAULT_UPDATE_INTERVAL = 250; | |
36 | |
37 /** | |
38 * Default timeout interval in milliseconds for waitsFor() blocks. | |
39 */ | |
40 jasmine.DEFAULT_TIMEOUT_INTERVAL = 5000; | |
41 | |
42 jasmine.getGlobal = function() { | |
43 function getGlobal() { | |
44 return this; | |
45 } | |
46 | |
47 return getGlobal(); | |
48 }; | |
49 | |
50 /** | |
51 * Allows for bound functions to be compared. Internal use only. | |
52 * | |
53 * @ignore | |
54 * @private | |
55 * @param base {Object} bound 'this' for the function | |
56 * @param name {Function} function to find | |
57 */ | |
58 jasmine.bindOriginal_ = function(base, name) { | |
59 var original = base[name]; | |
60 if (original.apply) { | |
61 return function() { | |
62 return original.apply(base, arguments); | |
63 }; | |
64 } else { | |
65 // IE support | |
66 return jasmine.getGlobal()[name]; | |
67 } | |
68 }; | |
69 | |
70 jasmine.setTimeout = jasmine.bindOriginal_(jasmine.getGlobal(), 'setTimeout'); | |
71 jasmine.clearTimeout = jasmine.bindOriginal_(jasmine.getGlobal(), 'clearTimeout'); | |
72 jasmine.setInterval = jasmine.bindOriginal_(jasmine.getGlobal(), 'setInterval'); | |
73 jasmine.clearInterval = jasmine.bindOriginal_(jasmine.getGlobal(), 'clearInterval'); | |
74 | |
75 jasmine.MessageResult = function(values) { | |
76 this.type = 'log'; | |
77 this.values = values; | |
78 this.trace = new Error(); // todo: test better | |
79 }; | |
80 | |
81 jasmine.MessageResult.prototype.toString = function() { | |
82 var text = ""; | |
83 for (var i = 0; i < this.values.length; i++) { | |
84 if (i > 0) text += " "; | |
85 if (jasmine.isString_(this.values[i])) { | |
86 text += this.values[i]; | |
87 } else { | |
88 text += jasmine.pp(this.values[i]); | |
89 } | |
90 } | |
91 return text; | |
92 }; | |
93 | |
94 jasmine.ExpectationResult = function(params) { | |
95 this.type = 'expect'; | |
96 this.matcherName = params.matcherName; | |
97 this.passed_ = params.passed; | |
98 this.expected = params.expected; | |
99 this.actual = params.actual; | |
100 this.message = this.passed_ ? 'Passed.' : params.message; | |
101 | |
102 var trace = (params.trace || new Error(this.message)); | |
103 this.trace = this.passed_ ? '' : trace; | |
104 }; | |
105 | |
106 jasmine.ExpectationResult.prototype.toString = function () { | |
107 return this.message; | |
108 }; | |
109 | |
110 jasmine.ExpectationResult.prototype.passed = function () { | |
111 return this.passed_; | |
112 }; | |
113 | |
114 /** | |
115 * Getter for the Jasmine environment. Ensures one gets created | |
116 */ | |
117 jasmine.getEnv = function() { | |
118 var env = jasmine.currentEnv_ = jasmine.currentEnv_ || new jasmine.Env(); | |
119 return env; | |
120 }; | |
121 | |
122 /** | |
123 * @ignore | |
124 * @private | |
125 * @param value | |
126 * @returns {Boolean} | |
127 */ | |
128 jasmine.isArray_ = function(value) { | |
129 return jasmine.isA_("Array", value); | |
130 }; | |
131 | |
132 /** | |
133 * @ignore | |
134 * @private | |
135 * @param value | |
136 * @returns {Boolean} | |
137 */ | |
138 jasmine.isString_ = function(value) { | |
139 return jasmine.isA_("String", value); | |
140 }; | |
141 | |
142 /** | |
143 * @ignore | |
144 * @private | |
145 * @param value | |
146 * @returns {Boolean} | |
147 */ | |
148 jasmine.isNumber_ = function(value) { | |
149 return jasmine.isA_("Number", value); | |
150 }; | |
151 | |
152 /** | |
153 * @ignore | |
154 * @private | |
155 * @param {String} typeName | |
156 * @param value | |
157 * @returns {Boolean} | |
158 */ | |
159 jasmine.isA_ = function(typeName, value) { | |
160 return Object.prototype.toString.apply(value) === '[object ' + typeName + ']'; | |
161 }; | |
162 | |
163 /** | |
164 * Pretty printer for expecations. Takes any object and turns it into a human-readable string. | |
165 * | |
166 * @param value {Object} an object to be outputted | |
167 * @returns {String} | |
168 */ | |
169 jasmine.pp = function(value) { | |
170 var stringPrettyPrinter = new jasmine.StringPrettyPrinter(); | |
171 stringPrettyPrinter.format(value); | |
172 return stringPrettyPrinter.string; | |
173 }; | |
174 | |
175 /** | |
176 * Returns true if the object is a DOM Node. | |
177 * | |
178 * @param {Object} obj object to check | |
179 * @returns {Boolean} | |
180 */ | |
181 jasmine.isDomNode = function(obj) { | |
182 return obj.nodeType > 0; | |
183 }; | |
184 | |
185 /** | |
186 * Returns a matchable 'generic' object of the class type. For use in expecations of type when values don't matter. | |
187 * | |
188 * @example | |
189 * // don't care about which function is passed in, as long as it's a function | |
190 * expect(mySpy).toHaveBeenCalledWith(jasmine.any(Function)); | |
191 * | |
192 * @param {Class} clazz | |
193 * @returns matchable object of the type clazz | |
194 */ | |
195 jasmine.any = function(clazz) { | |
196 return new jasmine.Matchers.Any(clazz); | |
197 }; | |
198 | |
199 /** | |
200 * Jasmine Spies are test doubles that can act as stubs, spies, fakes or when used in an expecation, mocks. | |
201 * | |
202 * Spies should be created in test setup, before expectations. They can then be checked, using the standard Jasmine | |
203 * expectation syntax. Spies can be checked if they were called or not and what the calling params were. | |
204 * | |
205 * A Spy has the following fields: wasCalled, callCount, mostRecentCall, and argsForCall (see docs). | |
206 * | |
207 * Spies are torn down at the end of every spec. | |
208 * | |
209 * Note: Do <b>not</b> call new jasmine.Spy() directly - a spy must be created using spyOn, jasmine.createSpy or jasmine.createSpyObj. | |
210 * | |
211 * @example | |
212 * // a stub | |
213 * var myStub = jasmine.createSpy('myStub'); // can be used anywhere | |
214 * | |
215 * // spy example | |
216 * var foo = { | |
217 * not: function(bool) { return !bool; } | |
218 * } | |
219 * | |
220 * // actual foo.not will not be called, execution stops | |
221 * spyOn(foo, 'not'); | |
222 | |
223 // foo.not spied upon, execution will continue to implementation | |
224 * spyOn(foo, 'not').andCallThrough(); | |
225 * | |
226 * // fake example | |
227 * var foo = { | |
228 * not: function(bool) { return !bool; } | |
229 * } | |
230 * | |
231 * // foo.not(val) will return val | |
232 * spyOn(foo, 'not').andCallFake(function(value) {return value;}); | |
233 * | |
234 * // mock example | |
235 * foo.not(7 == 7); | |
236 * expect(foo.not).toHaveBeenCalled(); | |
237 * expect(foo.not).toHaveBeenCalledWith(true); | |
238 * | |
239 * @constructor | |
240 * @see spyOn, jasmine.createSpy, jasmine.createSpyObj | |
241 * @param {String} name | |
242 */ | |
243 jasmine.Spy = function(name) { | |
244 /** | |
245 * The name of the spy, if provided. | |
246 */ | |
247 this.identity = name || 'unknown'; | |
248 /** | |
249 * Is this Object a spy? | |
250 */ | |
251 this.isSpy = true; | |
252 /** | |
253 * The actual function this spy stubs. | |
254 */ | |
255 this.plan = function() { | |
256 }; | |
257 /** | |
258 * Tracking of the most recent call to the spy. | |
259 * @example | |
260 * var mySpy = jasmine.createSpy('foo'); | |
261 * mySpy(1, 2); | |
262 * mySpy.mostRecentCall.args = [1, 2]; | |
263 */ | |
264 this.mostRecentCall = {}; | |
265 | |
266 /** | |
267 * Holds arguments for each call to the spy, indexed by call count | |
268 * @example | |
269 * var mySpy = jasmine.createSpy('foo'); | |
270 * mySpy(1, 2); | |
271 * mySpy(7, 8); | |
272 * mySpy.mostRecentCall.args = [7, 8]; | |
273 * mySpy.argsForCall[0] = [1, 2]; | |
274 * mySpy.argsForCall[1] = [7, 8]; | |
275 */ | |
276 this.argsForCall = []; | |
277 this.calls = []; | |
278 }; | |
279 | |
280 /** | |
281 * Tells a spy to call through to the actual implemenatation. | |
282 * | |
283 * @example | |
284 * var foo = { | |
285 * bar: function() { // do some stuff } | |
286 * } | |
287 * | |
288 * // defining a spy on an existing property: foo.bar | |
289 * spyOn(foo, 'bar').andCallThrough(); | |
290 */ | |
291 jasmine.Spy.prototype.andCallThrough = function() { | |
292 this.plan = this.originalValue; | |
293 return this; | |
294 }; | |
295 | |
296 /** | |
297 * For setting the return value of a spy. | |
298 * | |
299 * @example | |
300 * // defining a spy from scratch: foo() returns 'baz' | |
301 * var foo = jasmine.createSpy('spy on foo').andReturn('baz'); | |
302 * | |
303 * // defining a spy on an existing property: foo.bar() returns 'baz' | |
304 * spyOn(foo, 'bar').andReturn('baz'); | |
305 * | |
306 * @param {Object} value | |
307 */ | |
308 jasmine.Spy.prototype.andReturn = function(value) { | |
309 this.plan = function() { | |
310 return value; | |
311 }; | |
312 return this; | |
313 }; | |
314 | |
315 /** | |
316 * For throwing an exception when a spy is called. | |
317 * | |
318 * @example | |
319 * // defining a spy from scratch: foo() throws an exception w/ message 'ouch' | |
320 * var foo = jasmine.createSpy('spy on foo').andThrow('baz'); | |
321 * | |
322 * // defining a spy on an existing property: foo.bar() throws an exception w/ message 'ouch' | |
323 * spyOn(foo, 'bar').andThrow('baz'); | |
324 * | |
325 * @param {String} exceptionMsg | |
326 */ | |
327 jasmine.Spy.prototype.andThrow = function(exceptionMsg) { | |
328 this.plan = function() { | |
329 throw exceptionMsg; | |
330 }; | |
331 return this; | |
332 }; | |
333 | |
334 /** | |
335 * Calls an alternate implementation when a spy is called. | |
336 * | |
337 * @example | |
338 * var baz = function() { | |
339 * // do some stuff, return something | |
340 * } | |
341 * // defining a spy from scratch: foo() calls the function baz | |
342 * var foo = jasmine.createSpy('spy on foo').andCall(baz); | |
343 * | |
344 * // defining a spy on an existing property: foo.bar() calls an anonymnous function | |
345 * spyOn(foo, 'bar').andCall(function() { return 'baz';} ); | |
346 * | |
347 * @param {Function} fakeFunc | |
348 */ | |
349 jasmine.Spy.prototype.andCallFake = function(fakeFunc) { | |
350 this.plan = fakeFunc; | |
351 return this; | |
352 }; | |
353 | |
354 /** | |
355 * Resets all of a spy's the tracking variables so that it can be used again. | |
356 * | |
357 * @example | |
358 * spyOn(foo, 'bar'); | |
359 * | |
360 * foo.bar(); | |
361 * | |
362 * expect(foo.bar.callCount).toEqual(1); | |
363 * | |
364 * foo.bar.reset(); | |
365 * | |
366 * expect(foo.bar.callCount).toEqual(0); | |
367 */ | |
368 jasmine.Spy.prototype.reset = function() { | |
369 this.wasCalled = false; | |
370 this.callCount = 0; | |
371 this.argsForCall = []; | |
372 this.calls = []; | |
373 this.mostRecentCall = {}; | |
374 }; | |
375 | |
376 jasmine.createSpy = function(name) { | |
377 | |
378 var spyObj = function() { | |
379 spyObj.wasCalled = true; | |
380 spyObj.callCount++; | |
381 var args = jasmine.util.argsToArray(arguments); | |
382 spyObj.mostRecentCall.object = this; | |
383 spyObj.mostRecentCall.args = args; | |
384 spyObj.argsForCall.push(args); | |
385 spyObj.calls.push({object: this, args: args}); | |
386 return spyObj.plan.apply(this, arguments); | |
387 }; | |
388 | |
389 var spy = new jasmine.Spy(name); | |
390 | |
391 for (var prop in spy) { | |
392 spyObj[prop] = spy[prop]; | |
393 } | |
394 | |
395 spyObj.reset(); | |
396 | |
397 return spyObj; | |
398 }; | |
399 | |
400 /** | |
401 * Determines whether an object is a spy. | |
402 * | |
403 * @param {jasmine.Spy|Object} putativeSpy | |
404 * @returns {Boolean} | |
405 */ | |
406 jasmine.isSpy = function(putativeSpy) { | |
407 return putativeSpy && putativeSpy.isSpy; | |
408 }; | |
409 | |
410 /** | |
411 * Creates a more complicated spy: an Object that has every property a function that is a spy. Used for stubbing something | |
412 * large in one call. | |
413 * | |
414 * @param {String} baseName name of spy class | |
415 * @param {Array} methodNames array of names of methods to make spies | |
416 */ | |
417 jasmine.createSpyObj = function(baseName, methodNames) { | |
418 if (!jasmine.isArray_(methodNames) || methodNames.length === 0) { | |
419 throw new Error('createSpyObj requires a non-empty array of method names to create spies for'); | |
420 } | |
421 var obj = {}; | |
422 for (var i = 0; i < methodNames.length; i++) { | |
423 obj[methodNames[i]] = jasmine.createSpy(baseName + '.' + methodNames[i]); | |
424 } | |
425 return obj; | |
426 }; | |
427 | |
428 /** | |
429 * All parameters are pretty-printed and concatenated together, then written to the current spec's output. | |
430 * | |
431 * Be careful not to leave calls to <code>jasmine.log</code> in production code. | |
432 */ | |
433 jasmine.log = function() { | |
434 var spec = jasmine.getEnv().currentSpec; | |
435 spec.log.apply(spec, arguments); | |
436 }; | |
437 | |
438 /** | |
439 * Function that installs a spy on an existing object's method name. Used within a Spec to create a spy. | |
440 * | |
441 * @example | |
442 * // spy example | |
443 * var foo = { | |
444 * not: function(bool) { return !bool; } | |
445 * } | |
446 * spyOn(foo, 'not'); // actual foo.not will not be called, execution stops | |
447 * | |
448 * @see jasmine.createSpy | |
449 * @param obj | |
450 * @param methodName | |
451 * @returns a Jasmine spy that can be chained with all spy methods | |
452 */ | |
453 var spyOn = function(obj, methodName) { | |
454 return jasmine.getEnv().currentSpec.spyOn(obj, methodName); | |
455 }; | |
456 if (isCommonJS) exports.spyOn = spyOn; | |
457 | |
458 /** | |
459 * Creates a Jasmine spec that will be added to the current suite. | |
460 * | |
461 * // TODO: pending tests | |
462 * | |
463 * @example | |
464 * it('should be true', function() { | |
465 * expect(true).toEqual(true); | |
466 * }); | |
467 * | |
468 * @param {String} desc description of this specification | |
469 * @param {Function} func defines the preconditions and expectations of the spec | |
470 */ | |
471 var it = function(desc, func) { | |
472 return jasmine.getEnv().it(desc, func); | |
473 }; | |
474 if (isCommonJS) exports.it = it; | |
475 | |
476 /** | |
477 * Creates a <em>disabled</em> Jasmine spec. | |
478 * | |
479 * A convenience method that allows existing specs to be disabled temporarily during development. | |
480 * | |
481 * @param {String} desc description of this specification | |
482 * @param {Function} func defines the preconditions and expectations of the spec | |
483 */ | |
484 var xit = function(desc, func) { | |
485 return jasmine.getEnv().xit(desc, func); | |
486 }; | |
487 if (isCommonJS) exports.xit = xit; | |
488 | |
489 /** | |
490 * Starts a chain for a Jasmine expectation. | |
491 * | |
492 * It is passed an Object that is the actual value and should chain to one of the many | |
493 * jasmine.Matchers functions. | |
494 * | |
495 * @param {Object} actual Actual value to test against and expected value | |
496 */ | |
497 var expect = function(actual) { | |
498 return jasmine.getEnv().currentSpec.expect(actual); | |
499 }; | |
500 if (isCommonJS) exports.expect = expect; | |
501 | |
502 /** | |
503 * Defines part of a jasmine spec. Used in cominbination with waits or waitsFor in asynchrnous specs. | |
504 * | |
505 * @param {Function} func Function that defines part of a jasmine spec. | |
506 */ | |
507 var runs = function(func) { | |
508 jasmine.getEnv().currentSpec.runs(func); | |
509 }; | |
510 if (isCommonJS) exports.runs = runs; | |
511 | |
512 /** | |
513 * Waits a fixed time period before moving to the next block. | |
514 * | |
515 * @deprecated Use waitsFor() instead | |
516 * @param {Number} timeout milliseconds to wait | |
517 */ | |
518 var waits = function(timeout) { | |
519 jasmine.getEnv().currentSpec.waits(timeout); | |
520 }; | |
521 if (isCommonJS) exports.waits = waits; | |
522 | |
523 /** | |
524 * Waits for the latchFunction to return true before proceeding to the next block. | |
525 * | |
526 * @param {Function} latchFunction | |
527 * @param {String} optional_timeoutMessage | |
528 * @param {Number} optional_timeout | |
529 */ | |
530 var waitsFor = function(latchFunction, optional_timeoutMessage, optional_timeout) { | |
531 jasmine.getEnv().currentSpec.waitsFor.apply(jasmine.getEnv().currentSpec, arguments); | |
532 }; | |
533 if (isCommonJS) exports.waitsFor = waitsFor; | |
534 | |
535 /** | |
536 * A function that is called before each spec in a suite. | |
537 * | |
538 * Used for spec setup, including validating assumptions. | |
539 * | |
540 * @param {Function} beforeEachFunction | |
541 */ | |
542 var beforeEach = function(beforeEachFunction) { | |
543 jasmine.getEnv().beforeEach(beforeEachFunction); | |
544 }; | |
545 if (isCommonJS) exports.beforeEach = beforeEach; | |
546 | |
547 /** | |
548 * A function that is called after each spec in a suite. | |
549 * | |
550 * Used for restoring any state that is hijacked during spec execution. | |
551 * | |
552 * @param {Function} afterEachFunction | |
553 */ | |
554 var afterEach = function(afterEachFunction) { | |
555 jasmine.getEnv().afterEach(afterEachFunction); | |
556 }; | |
557 if (isCommonJS) exports.afterEach = afterEach; | |
558 | |
559 /** | |
560 * Defines a suite of specifications. | |
561 * | |
562 * Stores the description and all defined specs in the Jasmine environment as one suite of specs. Variables declared | |
563 * are accessible by calls to beforeEach, it, and afterEach. Describe blocks can be nested, allowing for specialization | |
564 * of setup in some tests. | |
565 * | |
566 * @example | |
567 * // TODO: a simple suite | |
568 * | |
569 * // TODO: a simple suite with a nested describe block | |
570 * | |
571 * @param {String} description A string, usually the class under test. | |
572 * @param {Function} specDefinitions function that defines several specs. | |
573 */ | |
574 var describe = function(description, specDefinitions) { | |
575 return jasmine.getEnv().describe(description, specDefinitions); | |
576 }; | |
577 if (isCommonJS) exports.describe = describe; | |
578 | |
579 /** | |
580 * Disables a suite of specifications. Used to disable some suites in a file, or files, temporarily during development. | |
581 * | |
582 * @param {String} description A string, usually the class under test. | |
583 * @param {Function} specDefinitions function that defines several specs. | |
584 */ | |
585 var xdescribe = function(description, specDefinitions) { | |
586 return jasmine.getEnv().xdescribe(description, specDefinitions); | |
587 }; | |
588 if (isCommonJS) exports.xdescribe = xdescribe; | |
589 | |
590 | |
591 // Provide the XMLHttpRequest class for IE 5.x-6.x: | |
592 jasmine.XmlHttpRequest = (typeof XMLHttpRequest == "undefined") ? function() { | |
593 function tryIt(f) { | |
594 try { | |
595 return f(); | |
596 } catch(e) { | |
597 } | |
598 return null; | |
599 } | |
600 | |
601 var xhr = tryIt(function() { | |
602 return new ActiveXObject("Msxml2.XMLHTTP.6.0"); | |
603 }) || | |
604 tryIt(function() { | |
605 return new ActiveXObject("Msxml2.XMLHTTP.3.0"); | |
606 }) || | |
607 tryIt(function() { | |
608 return new ActiveXObject("Msxml2.XMLHTTP"); | |
609 }) || | |
610 tryIt(function() { | |
611 return new ActiveXObject("Microsoft.XMLHTTP"); | |
612 }); | |
613 | |
614 if (!xhr) throw new Error("This browser does not support XMLHttpRequest."); | |
615 | |
616 return xhr; | |
617 } : XMLHttpRequest; | |
618 /** | |
619 * @namespace | |
620 */ | |
621 jasmine.util = {}; | |
622 | |
623 /** | |
624 * Declare that a child class inherit it's prototype from the parent class. | |
625 * | |
626 * @private | |
627 * @param {Function} childClass | |
628 * @param {Function} parentClass | |
629 */ | |
630 jasmine.util.inherit = function(childClass, parentClass) { | |
631 /** | |
632 * @private | |
633 */ | |
634 var subclass = function() { | |
635 }; | |
636 subclass.prototype = parentClass.prototype; | |
637 childClass.prototype = new subclass(); | |
638 }; | |
639 | |
640 jasmine.util.formatException = function(e) { | |
641 var lineNumber; | |
642 if (e.line) { | |
643 lineNumber = e.line; | |
644 } | |
645 else if (e.lineNumber) { | |
646 lineNumber = e.lineNumber; | |
647 } | |
648 | |
649 var file; | |
650 | |
651 if (e.sourceURL) { | |
652 file = e.sourceURL; | |
653 } | |
654 else if (e.fileName) { | |
655 file = e.fileName; | |
656 } | |
657 | |
658 var message = (e.name && e.message) ? (e.name + ': ' + e.message) : e.toString(); | |
659 | |
660 if (file && lineNumber) { | |
661 message += ' in ' + file + ' (line ' + lineNumber + ')'; | |
662 } | |
663 | |
664 return message; | |
665 }; | |
666 | |
667 jasmine.util.htmlEscape = function(str) { | |
668 if (!str) return str; | |
669 return str.replace(/&/g, '&') | |
670 .replace(/</g, '<') | |
671 .replace(/>/g, '>'); | |
672 }; | |
673 | |
674 jasmine.util.argsToArray = function(args) { | |
675 var arrayOfArgs = []; | |
676 for (var i = 0; i < args.length; i++) arrayOfArgs.push(args[i]); | |
677 return arrayOfArgs; | |
678 }; | |
679 | |
680 jasmine.util.extend = function(destination, source) { | |
681 for (var property in source) destination[property] = source[property]; | |
682 return destination; | |
683 }; | |
684 | |
685 /** | |
686 * Environment for Jasmine | |
687 * | |
688 * @constructor | |
689 */ | |
690 jasmine.Env = function() { | |
691 this.currentSpec = null; | |
692 this.currentSuite = null; | |
693 this.currentRunner_ = new jasmine.Runner(this); | |
694 | |
695 this.reporter = new jasmine.MultiReporter(); | |
696 | |
697 this.updateInterval = jasmine.DEFAULT_UPDATE_INTERVAL; | |
698 this.defaultTimeoutInterval = jasmine.DEFAULT_TIMEOUT_INTERVAL; | |
699 this.lastUpdate = 0; | |
700 this.specFilter = function() { | |
701 return true; | |
702 }; | |
703 | |
704 this.nextSpecId_ = 0; | |
705 this.nextSuiteId_ = 0; | |
706 this.equalityTesters_ = []; | |
707 | |
708 // wrap matchers | |
709 this.matchersClass = function() { | |
710 jasmine.Matchers.apply(this, arguments); | |
711 }; | |
712 jasmine.util.inherit(this.matchersClass, jasmine.Matchers); | |
713 | |
714 jasmine.Matchers.wrapInto_(jasmine.Matchers.prototype, this.matchersClass); | |
715 }; | |
716 | |
717 | |
718 jasmine.Env.prototype.setTimeout = jasmine.setTimeout; | |
719 jasmine.Env.prototype.clearTimeout = jasmine.clearTimeout; | |
720 jasmine.Env.prototype.setInterval = jasmine.setInterval; | |
721 jasmine.Env.prototype.clearInterval = jasmine.clearInterval; | |
722 | |
723 /** | |
724 * @returns an object containing jasmine version build info, if set. | |
725 */ | |
726 jasmine.Env.prototype.version = function () { | |
727 if (jasmine.version_) { | |
728 return jasmine.version_; | |
729 } else { | |
730 throw new Error('Version not set'); | |
731 } | |
732 }; | |
733 | |
734 /** | |
735 * @returns string containing jasmine version build info, if set. | |
736 */ | |
737 jasmine.Env.prototype.versionString = function() { | |
738 if (!jasmine.version_) { | |
739 return "version unknown"; | |
740 } | |
741 | |
742 var version = this.version(); | |
743 var versionString = version.major + "." + version.minor + "." + version.build; | |
744 if (version.release_candidate) { | |
745 versionString += ".rc" + version.release_candidate; | |
746 } | |
747 versionString += " revision " + version.revision; | |
748 return versionString; | |
749 }; | |
750 | |
751 /** | |
752 * @returns a sequential integer starting at 0 | |
753 */ | |
754 jasmine.Env.prototype.nextSpecId = function () { | |
755 return this.nextSpecId_++; | |
756 }; | |
757 | |
758 /** | |
759 * @returns a sequential integer starting at 0 | |
760 */ | |
761 jasmine.Env.prototype.nextSuiteId = function () { | |
762 return this.nextSuiteId_++; | |
763 }; | |
764 | |
765 /** | |
766 * Register a reporter to receive status updates from Jasmine. | |
767 * @param {jasmine.Reporter} reporter An object which will receive status updates. | |
768 */ | |
769 jasmine.Env.prototype.addReporter = function(reporter) { | |
770 this.reporter.addReporter(reporter); | |
771 }; | |
772 | |
773 jasmine.Env.prototype.execute = function() { | |
774 this.currentRunner_.execute(); | |
775 }; | |
776 | |
777 jasmine.Env.prototype.describe = function(description, specDefinitions) { | |
778 var suite = new jasmine.Suite(this, description, specDefinitions, this.currentSuite); | |
779 | |
780 var parentSuite = this.currentSuite; | |
781 if (parentSuite) { | |
782 parentSuite.add(suite); | |
783 } else { | |
784 this.currentRunner_.add(suite); | |
785 } | |
786 | |
787 this.currentSuite = suite; | |
788 | |
789 var declarationError = null; | |
790 try { | |
791 specDefinitions.call(suite); | |
792 } catch(e) { | |
793 declarationError = e; | |
794 } | |
795 | |
796 if (declarationError) { | |
797 this.it("encountered a declaration exception", function() { | |
798 throw declarationError; | |
799 }); | |
800 } | |
801 | |
802 this.currentSuite = parentSuite; | |
803 | |
804 return suite; | |
805 }; | |
806 | |
807 jasmine.Env.prototype.beforeEach = function(beforeEachFunction) { | |
808 if (this.currentSuite) { | |
809 this.currentSuite.beforeEach(beforeEachFunction); | |
810 } else { | |
811 this.currentRunner_.beforeEach(beforeEachFunction); | |
812 } | |
813 }; | |
814 | |
815 jasmine.Env.prototype.currentRunner = function () { | |
816 return this.currentRunner_; | |
817 }; | |
818 | |
819 jasmine.Env.prototype.afterEach = function(afterEachFunction) { | |
820 if (this.currentSuite) { | |
821 this.currentSuite.afterEach(afterEachFunction); | |
822 } else { | |
823 this.currentRunner_.afterEach(afterEachFunction); | |
824 } | |
825 | |
826 }; | |
827 | |
828 jasmine.Env.prototype.xdescribe = function(desc, specDefinitions) { | |
829 return { | |
830 execute: function() { | |
831 } | |
832 }; | |
833 }; | |
834 | |
835 jasmine.Env.prototype.it = function(description, func) { | |
836 var spec = new jasmine.Spec(this, this.currentSuite, description); | |
837 this.currentSuite.add(spec); | |
838 this.currentSpec = spec; | |
839 | |
840 if (func) { | |
841 spec.runs(func); | |
842 } | |
843 | |
844 return spec; | |
845 }; | |
846 | |
847 jasmine.Env.prototype.xit = function(desc, func) { | |
848 return { | |
849 id: this.nextSpecId(), | |
850 runs: function() { | |
851 } | |
852 }; | |
853 }; | |
854 | |
855 jasmine.Env.prototype.compareObjects_ = function(a, b, mismatchKeys, mismatchValues) { | |
856 if (a.__Jasmine_been_here_before__ === b && b.__Jasmine_been_here_before__ === a) { | |
857 return true; | |
858 } | |
859 | |
860 a.__Jasmine_been_here_before__ = b; | |
861 b.__Jasmine_been_here_before__ = a; | |
862 | |
863 var hasKey = function(obj, keyName) { | |
864 return obj !== null && obj[keyName] !== jasmine.undefined; | |
865 }; | |
866 | |
867 for (var property in b) { | |
868 if (!hasKey(a, property) && hasKey(b, property)) { | |
869 mismatchKeys.push("expected has key '" + property + "', but missing from actual."); | |
870 } | |
871 } | |
872 for (property in a) { | |
873 if (!hasKey(b, property) && hasKey(a, property)) { | |
874 mismatchKeys.push("expected missing key '" + property + "', but present in actual."); | |
875 } | |
876 } | |
877 for (property in b) { | |
878 if (property == '__Jasmine_been_here_before__') continue; | |
879 if (!this.equals_(a[property], b[property], mismatchKeys, mismatchValues)) { | |
880 mismatchValues.push("'" + property + "' was '" + (b[property] ? jasmine.util.htmlEscape(b[property].toString()) : b[property]) + "' in expected, but was '" + (a[property] ? jasmine.util.htmlEscape(a[property].toString()) : a[property]) + "' in actual."); | |
881 } | |
882 } | |
883 | |
884 if (jasmine.isArray_(a) && jasmine.isArray_(b) && a.length != b.length) { | |
885 mismatchValues.push("arrays were not the same length"); | |
886 } | |
887 | |
888 delete a.__Jasmine_been_here_before__; | |
889 delete b.__Jasmine_been_here_before__; | |
890 return (mismatchKeys.length === 0 && mismatchValues.length === 0); | |
891 }; | |
892 | |
893 jasmine.Env.prototype.equals_ = function(a, b, mismatchKeys, mismatchValues) { | |
894 mismatchKeys = mismatchKeys || []; | |
895 mismatchValues = mismatchValues || []; | |
896 | |
897 for (var i = 0; i < this.equalityTesters_.length; i++) { | |
898 var equalityTester = this.equalityTesters_[i]; | |
899 var result = equalityTester(a, b, this, mismatchKeys, mismatchValues); | |
900 if (result !== jasmine.undefined) return result; | |
901 } | |
902 | |
903 if (a === b) return true; | |
904 | |
905 if (a === jasmine.undefined || a === null || b === jasmine.undefined || b === null) { | |
906 return (a == jasmine.undefined && b == jasmine.undefined); | |
907 } | |
908 | |
909 if (jasmine.isDomNode(a) && jasmine.isDomNode(b)) { | |
910 return a === b; | |
911 } | |
912 | |
913 if (a instanceof Date && b instanceof Date) { | |
914 return a.getTime() == b.getTime(); | |
915 } | |
916 | |
917 if (a instanceof jasmine.Matchers.Any) { | |
918 return a.matches(b); | |
919 } | |
920 | |
921 if (b instanceof jasmine.Matchers.Any) { | |
922 return b.matches(a); | |
923 } | |
924 | |
925 if (jasmine.isString_(a) && jasmine.isString_(b)) { | |
926 return (a == b); | |
927 } | |
928 | |
929 if (jasmine.isNumber_(a) && jasmine.isNumber_(b)) { | |
930 return (a == b); | |
931 } | |
932 | |
933 if (typeof a === "object" && typeof b === "object") { | |
934 return this.compareObjects_(a, b, mismatchKeys, mismatchValues); | |
935 } | |
936 | |
937 //Straight check | |
938 return (a === b); | |
939 }; | |
940 | |
941 jasmine.Env.prototype.contains_ = function(haystack, needle) { | |
942 if (jasmine.isArray_(haystack)) { | |
943 for (var i = 0; i < haystack.length; i++) { | |
944 if (this.equals_(haystack[i], needle)) return true; | |
945 } | |
946 return false; | |
947 } | |
948 return haystack.indexOf(needle) >= 0; | |
949 }; | |
950 | |
951 jasmine.Env.prototype.addEqualityTester = function(equalityTester) { | |
952 this.equalityTesters_.push(equalityTester); | |
953 }; | |
954 /** No-op base class for Jasmine reporters. | |
955 * | |
956 * @constructor | |
957 */ | |
958 jasmine.Reporter = function() { | |
959 }; | |
960 | |
961 //noinspection JSUnusedLocalSymbols | |
962 jasmine.Reporter.prototype.reportRunnerStarting = function(runner) { | |
963 }; | |
964 | |
965 //noinspection JSUnusedLocalSymbols | |
966 jasmine.Reporter.prototype.reportRunnerResults = function(runner) { | |
967 }; | |
968 | |
969 //noinspection JSUnusedLocalSymbols | |
970 jasmine.Reporter.prototype.reportSuiteResults = function(suite) { | |
971 }; | |
972 | |
973 //noinspection JSUnusedLocalSymbols | |
974 jasmine.Reporter.prototype.reportSpecStarting = function(spec) { | |
975 }; | |
976 | |
977 //noinspection JSUnusedLocalSymbols | |
978 jasmine.Reporter.prototype.reportSpecResults = function(spec) { | |
979 }; | |
980 | |
981 //noinspection JSUnusedLocalSymbols | |
982 jasmine.Reporter.prototype.log = function(str) { | |
983 }; | |
984 | |
985 /** | |
986 * Blocks are functions with executable code that make up a spec. | |
987 * | |
988 * @constructor | |
989 * @param {jasmine.Env} env | |
990 * @param {Function} func | |
991 * @param {jasmine.Spec} spec | |
992 */ | |
993 jasmine.Block = function(env, func, spec) { | |
994 this.env = env; | |
995 this.func = func; | |
996 this.spec = spec; | |
997 }; | |
998 | |
999 jasmine.Block.prototype.execute = function(onComplete) { | |
1000 try { | |
1001 this.func.apply(this.spec); | |
1002 } catch (e) { | |
1003 this.spec.fail(e); | |
1004 } | |
1005 onComplete(); | |
1006 }; | |
1007 /** JavaScript API reporter. | |
1008 * | |
1009 * @constructor | |
1010 */ | |
1011 jasmine.JsApiReporter = function() { | |
1012 this.started = false; | |
1013 this.finished = false; | |
1014 this.suites_ = []; | |
1015 this.results_ = {}; | |
1016 }; | |
1017 | |
1018 jasmine.JsApiReporter.prototype.reportRunnerStarting = function(runner) { | |
1019 this.started = true; | |
1020 var suites = runner.topLevelSuites(); | |
1021 for (var i = 0; i < suites.length; i++) { | |
1022 var suite = suites[i]; | |
1023 this.suites_.push(this.summarize_(suite)); | |
1024 } | |
1025 }; | |
1026 | |
1027 jasmine.JsApiReporter.prototype.suites = function() { | |
1028 return this.suites_; | |
1029 }; | |
1030 | |
1031 jasmine.JsApiReporter.prototype.summarize_ = function(suiteOrSpec) { | |
1032 var isSuite = suiteOrSpec instanceof jasmine.Suite; | |
1033 var summary = { | |
1034 id: suiteOrSpec.id, | |
1035 name: suiteOrSpec.description, | |
1036 type: isSuite ? 'suite' : 'spec', | |
1037 children: [] | |
1038 }; | |
1039 | |
1040 if (isSuite) { | |
1041 var children = suiteOrSpec.children(); | |
1042 for (var i = 0; i < children.length; i++) { | |
1043 summary.children.push(this.summarize_(children[i])); | |
1044 } | |
1045 } | |
1046 return summary; | |
1047 }; | |
1048 | |
1049 jasmine.JsApiReporter.prototype.results = function() { | |
1050 return this.results_; | |
1051 }; | |
1052 | |
1053 jasmine.JsApiReporter.prototype.resultsForSpec = function(specId) { | |
1054 return this.results_[specId]; | |
1055 }; | |
1056 | |
1057 //noinspection JSUnusedLocalSymbols | |
1058 jasmine.JsApiReporter.prototype.reportRunnerResults = function(runner) { | |
1059 this.finished = true; | |
1060 }; | |
1061 | |
1062 //noinspection JSUnusedLocalSymbols | |
1063 jasmine.JsApiReporter.prototype.reportSuiteResults = function(suite) { | |
1064 }; | |
1065 | |
1066 //noinspection JSUnusedLocalSymbols | |
1067 jasmine.JsApiReporter.prototype.reportSpecResults = function(spec) { | |
1068 this.results_[spec.id] = { | |
1069 messages: spec.results().getItems(), | |
1070 result: spec.results().failedCount > 0 ? "failed" : "passed" | |
1071 }; | |
1072 }; | |
1073 | |
1074 //noinspection JSUnusedLocalSymbols | |
1075 jasmine.JsApiReporter.prototype.log = function(str) { | |
1076 }; | |
1077 | |
1078 jasmine.JsApiReporter.prototype.resultsForSpecs = function(specIds){ | |
1079 var results = {}; | |
1080 for (var i = 0; i < specIds.length; i++) { | |
1081 var specId = specIds[i]; | |
1082 results[specId] = this.summarizeResult_(this.results_[specId]); | |
1083 } | |
1084 return results; | |
1085 }; | |
1086 | |
1087 jasmine.JsApiReporter.prototype.summarizeResult_ = function(result){ | |
1088 var summaryMessages = []; | |
1089 var messagesLength = result.messages.length; | |
1090 for (var messageIndex = 0; messageIndex < messagesLength; messageIndex++) { | |
1091 var resultMessage = result.messages[messageIndex]; | |
1092 summaryMessages.push({ | |
1093 text: resultMessage.type == 'log' ? resultMessage.toString() : jasmine.undefined, | |
1094 passed: resultMessage.passed ? resultMessage.passed() : true, | |
1095 type: resultMessage.type, | |
1096 message: resultMessage.message, | |
1097 trace: { | |
1098 stack: resultMessage.passed && !resultMessage.passed() ? resultMessage.trace.stack : jasmine.undefined | |
1099 } | |
1100 }); | |
1101 } | |
1102 | |
1103 return { | |
1104 result : result.result, | |
1105 messages : summaryMessages | |
1106 }; | |
1107 }; | |
1108 | |
1109 /** | |
1110 * @constructor | |
1111 * @param {jasmine.Env} env | |
1112 * @param actual | |
1113 * @param {jasmine.Spec} spec | |
1114 */ | |
1115 jasmine.Matchers = function(env, actual, spec, opt_isNot) { | |
1116 this.env = env; | |
1117 this.actual = actual; | |
1118 this.spec = spec; | |
1119 this.isNot = opt_isNot || false; | |
1120 this.reportWasCalled_ = false; | |
1121 }; | |
1122 | |
1123 // todo: @deprecated as of Jasmine 0.11, remove soon [xw] | |
1124 jasmine.Matchers.pp = function(str) { | |
1125 throw new Error("jasmine.Matchers.pp() is no longer supported, please use jasmine.pp() instead!"); | |
1126 }; | |
1127 | |
1128 // todo: @deprecated Deprecated as of Jasmine 0.10. Rewrite your custom matchers to return true or false. [xw] | |
1129 jasmine.Matchers.prototype.report = function(result, failing_message, details) { | |
1130 throw new Error("As of jasmine 0.11, custom matchers must be implemented differently -- please see jasmine docs"); | |
1131 }; | |
1132 | |
1133 jasmine.Matchers.wrapInto_ = function(prototype, matchersClass) { | |
1134 for (var methodName in prototype) { | |
1135 if (methodName == 'report') continue; | |
1136 var orig = prototype[methodName]; | |
1137 matchersClass.prototype[methodName] = jasmine.Matchers.matcherFn_(methodName, orig); | |
1138 } | |
1139 }; | |
1140 | |
1141 jasmine.Matchers.matcherFn_ = function(matcherName, matcherFunction) { | |
1142 return function() { | |
1143 var matcherArgs = jasmine.util.argsToArray(arguments); | |
1144 var result = matcherFunction.apply(this, arguments); | |
1145 | |
1146 if (this.isNot) { | |
1147 result = !result; | |
1148 } | |
1149 | |
1150 if (this.reportWasCalled_) return result; | |
1151 | |
1152 var message; | |
1153 if (!result) { | |
1154 if (this.message) { | |
1155 message = this.message.apply(this, arguments); | |
1156 if (jasmine.isArray_(message)) { | |
1157 message = message[this.isNot ? 1 : 0]; | |
1158 } | |
1159 } else { | |
1160 var englishyPredicate = matcherName.replace(/[A-Z]/g, function(s) { return ' ' + s.toLowerCase(); }); | |
1161 message = "Expected " + jasmine.pp(this.actual) + (this.isNot ? " not " : " ") + englishyPredicate; | |
1162 if (matcherArgs.length > 0) { | |
1163 for (var i = 0; i < matcherArgs.length; i++) { | |
1164 if (i > 0) message += ","; | |
1165 message += " " + jasmine.pp(matcherArgs[i]); | |
1166 } | |
1167 } | |
1168 message += "."; | |
1169 } | |
1170 } | |
1171 var expectationResult = new jasmine.ExpectationResult({ | |
1172 matcherName: matcherName, | |
1173 passed: result, | |
1174 expected: matcherArgs.length > 1 ? matcherArgs : matcherArgs[0], | |
1175 actual: this.actual, | |
1176 message: message | |
1177 }); | |
1178 this.spec.addMatcherResult(expectationResult); | |
1179 return jasmine.undefined; | |
1180 }; | |
1181 }; | |
1182 | |
1183 | |
1184 | |
1185 | |
1186 /** | |
1187 * toBe: compares the actual to the expected using === | |
1188 * @param expected | |
1189 */ | |
1190 jasmine.Matchers.prototype.toBe = function(expected) { | |
1191 return this.actual === expected; | |
1192 }; | |
1193 | |
1194 /** | |
1195 * toNotBe: compares the actual to the expected using !== | |
1196 * @param expected | |
1197 * @deprecated as of 1.0. Use not.toBe() instead. | |
1198 */ | |
1199 jasmine.Matchers.prototype.toNotBe = function(expected) { | |
1200 return this.actual !== expected; | |
1201 }; | |
1202 | |
1203 /** | |
1204 * toEqual: compares the actual to the expected using common sense equality. Handles Objects, Arrays, etc. | |
1205 * | |
1206 * @param expected | |
1207 */ | |
1208 jasmine.Matchers.prototype.toEqual = function(expected) { | |
1209 return this.env.equals_(this.actual, expected); | |
1210 }; | |
1211 | |
1212 /** | |
1213 * toNotEqual: compares the actual to the expected using the ! of jasmine.Matchers.toEqual | |
1214 * @param expected | |
1215 * @deprecated as of 1.0. Use not.toNotEqual() instead. | |
1216 */ | |
1217 jasmine.Matchers.prototype.toNotEqual = function(expected) { | |
1218 return !this.env.equals_(this.actual, expected); | |
1219 }; | |
1220 | |
1221 /** | |
1222 * Matcher that compares the actual to the expected using a regular expression. Constructs a RegExp, so takes | |
1223 * a pattern or a String. | |
1224 * | |
1225 * @param expected | |
1226 */ | |
1227 jasmine.Matchers.prototype.toMatch = function(expected) { | |
1228 return new RegExp(expected).test(this.actual); | |
1229 }; | |
1230 | |
1231 /** | |
1232 * Matcher that compares the actual to the expected using the boolean inverse of jasmine.Matchers.toMatch | |
1233 * @param expected | |
1234 * @deprecated as of 1.0. Use not.toMatch() instead. | |
1235 */ | |
1236 jasmine.Matchers.prototype.toNotMatch = function(expected) { | |
1237 return !(new RegExp(expected).test(this.actual)); | |
1238 }; | |
1239 | |
1240 /** | |
1241 * Matcher that compares the actual to jasmine.undefined. | |
1242 */ | |
1243 jasmine.Matchers.prototype.toBeDefined = function() { | |
1244 return (this.actual !== jasmine.undefined); | |
1245 }; | |
1246 | |
1247 /** | |
1248 * Matcher that compares the actual to jasmine.undefined. | |
1249 */ | |
1250 jasmine.Matchers.prototype.toBeUndefined = function() { | |
1251 return (this.actual === jasmine.undefined); | |
1252 }; | |
1253 | |
1254 /** | |
1255 * Matcher that compares the actual to null. | |
1256 */ | |
1257 jasmine.Matchers.prototype.toBeNull = function() { | |
1258 return (this.actual === null); | |
1259 }; | |
1260 | |
1261 /** | |
1262 * Matcher that boolean not-nots the actual. | |
1263 */ | |
1264 jasmine.Matchers.prototype.toBeTruthy = function() { | |
1265 return !!this.actual; | |
1266 }; | |
1267 | |
1268 | |
1269 /** | |
1270 * Matcher that boolean nots the actual. | |
1271 */ | |
1272 jasmine.Matchers.prototype.toBeFalsy = function() { | |
1273 return !this.actual; | |
1274 }; | |
1275 | |
1276 | |
1277 /** | |
1278 * Matcher that checks to see if the actual, a Jasmine spy, was called. | |
1279 */ | |
1280 jasmine.Matchers.prototype.toHaveBeenCalled = function() { | |
1281 if (arguments.length > 0) { | |
1282 throw new Error('toHaveBeenCalled does not take arguments, use toHaveBeenCalledWith'); | |
1283 } | |
1284 | |
1285 if (!jasmine.isSpy(this.actual)) { | |
1286 throw new Error('Expected a spy, but got ' + jasmine.pp(this.actual) + '.'); | |
1287 } | |
1288 | |
1289 this.message = function() { | |
1290 return [ | |
1291 "Expected spy " + this.actual.identity + " to have been called.", | |
1292 "Expected spy " + this.actual.identity + " not to have been called." | |
1293 ]; | |
1294 }; | |
1295 | |
1296 return this.actual.wasCalled; | |
1297 }; | |
1298 | |
1299 /** @deprecated Use expect(xxx).toHaveBeenCalled() instead */ | |
1300 jasmine.Matchers.prototype.wasCalled = jasmine.Matchers.prototype.toHaveBeenCalled; | |
1301 | |
1302 /** | |
1303 * Matcher that checks to see if the actual, a Jasmine spy, was not called. | |
1304 * | |
1305 * @deprecated Use expect(xxx).not.toHaveBeenCalled() instead | |
1306 */ | |
1307 jasmine.Matchers.prototype.wasNotCalled = function() { | |
1308 if (arguments.length > 0) { | |
1309 throw new Error('wasNotCalled does not take arguments'); | |
1310 } | |
1311 | |
1312 if (!jasmine.isSpy(this.actual)) { | |
1313 throw new Error('Expected a spy, but got ' + jasmine.pp(this.actual) + '.'); | |
1314 } | |
1315 | |
1316 this.message = function() { | |
1317 return [ | |
1318 "Expected spy " + this.actual.identity + " to not have been called.", | |
1319 "Expected spy " + this.actual.identity + " to have been called." | |
1320 ]; | |
1321 }; | |
1322 | |
1323 return !this.actual.wasCalled; | |
1324 }; | |
1325 | |
1326 /** | |
1327 * Matcher that checks to see if the actual, a Jasmine spy, was called with a set of parameters. | |
1328 * | |
1329 * @example | |
1330 * | |
1331 */ | |
1332 jasmine.Matchers.prototype.toHaveBeenCalledWith = function() { | |
1333 var expectedArgs = jasmine.util.argsToArray(arguments); | |
1334 if (!jasmine.isSpy(this.actual)) { | |
1335 throw new Error('Expected a spy, but got ' + jasmine.pp(this.actual) + '.'); | |
1336 } | |
1337 this.message = function() { | |
1338 if (this.actual.callCount === 0) { | |
1339 // todo: what should the failure message for .not.toHaveBeenCalledWith() be? is this right? test better. [xw] | |
1340 return [ | |
1341 "Expected spy " + this.actual.identity + " to have been called with " + jasmine.pp(expectedArgs) + " but it was never called.", | |
1342 "Expected spy " + this.actual.identity + " not to have been called with " + jasmine.pp(expectedArgs) + " but it was." | |
1343 ]; | |
1344 } else { | |
1345 return [ | |
1346 "Expected spy " + this.actual.identity + " to have been called with " + jasmine.pp(expectedArgs) + " but was called with " + jasmine.pp(this.actual.argsForCall), | |
1347 "Expected spy " + this.actual.identity + " not to have been called with " + jasmine.pp(expectedArgs) + " but was called with " + jasmine.pp(this.actual.argsForCall) | |
1348 ]; | |
1349 } | |
1350 }; | |
1351 | |
1352 return this.env.contains_(this.actual.argsForCall, expectedArgs); | |
1353 }; | |
1354 | |
1355 /** @deprecated Use expect(xxx).toHaveBeenCalledWith() instead */ | |
1356 jasmine.Matchers.prototype.wasCalledWith = jasmine.Matchers.prototype.toHaveBeenCalledWith; | |
1357 | |
1358 /** @deprecated Use expect(xxx).not.toHaveBeenCalledWith() instead */ | |
1359 jasmine.Matchers.prototype.wasNotCalledWith = function() { | |
1360 var expectedArgs = jasmine.util.argsToArray(arguments); | |
1361 if (!jasmine.isSpy(this.actual)) { | |
1362 throw new Error('Expected a spy, but got ' + jasmine.pp(this.actual) + '.'); | |
1363 } | |
1364 | |
1365 this.message = function() { | |
1366 return [ | |
1367 "Expected spy not to have been called with " + jasmine.pp(expectedArgs) + " but it was", | |
1368 "Expected spy to have been called with " + jasmine.pp(expectedArgs) + " but it was" | |
1369 ]; | |
1370 }; | |
1371 | |
1372 return !this.env.contains_(this.actual.argsForCall, expectedArgs); | |
1373 }; | |
1374 | |
1375 /** | |
1376 * Matcher that checks that the expected item is an element in the actual Array. | |
1377 * | |
1378 * @param {Object} expected | |
1379 */ | |
1380 jasmine.Matchers.prototype.toContain = function(expected) { | |
1381 return this.env.contains_(this.actual, expected); | |
1382 }; | |
1383 | |
1384 /** | |
1385 * Matcher that checks that the expected item is NOT an element in the actual Array. | |
1386 * | |
1387 * @param {Object} expected | |
1388 * @deprecated as of 1.0. Use not.toNotContain() instead. | |
1389 */ | |
1390 jasmine.Matchers.prototype.toNotContain = function(expected) { | |
1391 return !this.env.contains_(this.actual, expected); | |
1392 }; | |
1393 | |
1394 jasmine.Matchers.prototype.toBeLessThan = function(expected) { | |
1395 return this.actual < expected; | |
1396 }; | |
1397 | |
1398 jasmine.Matchers.prototype.toBeGreaterThan = function(expected) { | |
1399 return this.actual > expected; | |
1400 }; | |
1401 | |
1402 /** | |
1403 * Matcher that checks that the expected item is equal to the actual item | |
1404 * up to a given level of decimal precision (default 2). | |
1405 * | |
1406 * @param {Number} expected | |
1407 * @param {Number} precision | |
1408 */ | |
1409 jasmine.Matchers.prototype.toBeCloseTo = function(expected, precision) { | |
1410 if (!(precision === 0)) { | |
1411 precision = precision || 2; | |
1412 } | |
1413 var multiplier = Math.pow(10, precision); | |
1414 var actual = Math.round(this.actual * multiplier); | |
1415 expected = Math.round(expected * multiplier); | |
1416 return expected == actual; | |
1417 }; | |
1418 | |
1419 /** | |
1420 * Matcher that checks that the expected exception was thrown by the actual. | |
1421 * | |
1422 * @param {String} expected | |
1423 */ | |
1424 jasmine.Matchers.prototype.toThrow = function(expected) { | |
1425 var result = false; | |
1426 var exception; | |
1427 if (typeof this.actual != 'function') { | |
1428 throw new Error('Actual is not a function'); | |
1429 } | |
1430 try { | |
1431 this.actual(); | |
1432 } catch (e) { | |
1433 exception = e; | |
1434 } | |
1435 if (exception) { | |
1436 result = (expected === jasmine.undefined || this.env.equals_(exception.message || exception, expected.message || expected)); | |
1437 } | |
1438 | |
1439 var not = this.isNot ? "not " : ""; | |
1440 | |
1441 this.message = function() { | |
1442 if (exception && (expected === jasmine.undefined || !this.env.equals_(exception.message || exception, expected.message || expected))) { | |
1443 return ["Expected function " + not + "to throw", expected ? expected.message || expected : "an exception", ", but it threw", exception.message || exception].join(' '); | |
1444 } else { | |
1445 return "Expected function to throw an exception."; | |
1446 } | |
1447 }; | |
1448 | |
1449 return result; | |
1450 }; | |
1451 | |
1452 jasmine.Matchers.Any = function(expectedClass) { | |
1453 this.expectedClass = expectedClass; | |
1454 }; | |
1455 | |
1456 jasmine.Matchers.Any.prototype.matches = function(other) { | |
1457 if (this.expectedClass == String) { | |
1458 return typeof other == 'string' || other instanceof String; | |
1459 } | |
1460 | |
1461 if (this.expectedClass == Number) { | |
1462 return typeof other == 'number' || other instanceof Number; | |
1463 } | |
1464 | |
1465 if (this.expectedClass == Function) { | |
1466 return typeof other == 'function' || other instanceof Function; | |
1467 } | |
1468 | |
1469 if (this.expectedClass == Object) { | |
1470 return typeof other == 'object'; | |
1471 } | |
1472 | |
1473 return other instanceof this.expectedClass; | |
1474 }; | |
1475 | |
1476 jasmine.Matchers.Any.prototype.toString = function() { | |
1477 return '<jasmine.any(' + this.expectedClass + ')>'; | |
1478 }; | |
1479 | |
1480 /** | |
1481 * @constructor | |
1482 */ | |
1483 jasmine.MultiReporter = function() { | |
1484 this.subReporters_ = []; | |
1485 }; | |
1486 jasmine.util.inherit(jasmine.MultiReporter, jasmine.Reporter); | |
1487 | |
1488 jasmine.MultiReporter.prototype.addReporter = function(reporter) { | |
1489 this.subReporters_.push(reporter); | |
1490 }; | |
1491 | |
1492 (function() { | |
1493 var functionNames = [ | |
1494 "reportRunnerStarting", | |
1495 "reportRunnerResults", | |
1496 "reportSuiteResults", | |
1497 "reportSpecStarting", | |
1498 "reportSpecResults", | |
1499 "log" | |
1500 ]; | |
1501 for (var i = 0; i < functionNames.length; i++) { | |
1502 var functionName = functionNames[i]; | |
1503 jasmine.MultiReporter.prototype[functionName] = (function(functionName) { | |
1504 return function() { | |
1505 for (var j = 0; j < this.subReporters_.length; j++) { | |
1506 var subReporter = this.subReporters_[j]; | |
1507 if (subReporter[functionName]) { | |
1508 subReporter[functionName].apply(subReporter, arguments); | |
1509 } | |
1510 } | |
1511 }; | |
1512 })(functionName); | |
1513 } | |
1514 })(); | |
1515 /** | |
1516 * Holds results for a set of Jasmine spec. Allows for the results array to hold another jasmine.NestedResults | |
1517 * | |
1518 * @constructor | |
1519 */ | |
1520 jasmine.NestedResults = function() { | |
1521 /** | |
1522 * The total count of results | |
1523 */ | |
1524 this.totalCount = 0; | |
1525 /** | |
1526 * Number of passed results | |
1527 */ | |
1528 this.passedCount = 0; | |
1529 /** | |
1530 * Number of failed results | |
1531 */ | |
1532 this.failedCount = 0; | |
1533 /** | |
1534 * Was this suite/spec skipped? | |
1535 */ | |
1536 this.skipped = false; | |
1537 /** | |
1538 * @ignore | |
1539 */ | |
1540 this.items_ = []; | |
1541 }; | |
1542 | |
1543 /** | |
1544 * Roll up the result counts. | |
1545 * | |
1546 * @param result | |
1547 */ | |
1548 jasmine.NestedResults.prototype.rollupCounts = function(result) { | |
1549 this.totalCount += result.totalCount; | |
1550 this.passedCount += result.passedCount; | |
1551 this.failedCount += result.failedCount; | |
1552 }; | |
1553 | |
1554 /** | |
1555 * Adds a log message. | |
1556 * @param values Array of message parts which will be concatenated later. | |
1557 */ | |
1558 jasmine.NestedResults.prototype.log = function(values) { | |
1559 this.items_.push(new jasmine.MessageResult(values)); | |
1560 }; | |
1561 | |
1562 /** | |
1563 * Getter for the results: message & results. | |
1564 */ | |
1565 jasmine.NestedResults.prototype.getItems = function() { | |
1566 return this.items_; | |
1567 }; | |
1568 | |
1569 /** | |
1570 * Adds a result, tracking counts (total, passed, & failed) | |
1571 * @param {jasmine.ExpectationResult|jasmine.NestedResults} result | |
1572 */ | |
1573 jasmine.NestedResults.prototype.addResult = function(result) { | |
1574 if (result.type != 'log') { | |
1575 if (result.items_) { | |
1576 this.rollupCounts(result); | |
1577 } else { | |
1578 this.totalCount++; | |
1579 if (result.passed()) { | |
1580 this.passedCount++; | |
1581 } else { | |
1582 this.failedCount++; | |
1583 } | |
1584 } | |
1585 } | |
1586 this.items_.push(result); | |
1587 }; | |
1588 | |
1589 /** | |
1590 * @returns {Boolean} True if <b>everything</b> below passed | |
1591 */ | |
1592 jasmine.NestedResults.prototype.passed = function() { | |
1593 return this.passedCount === this.totalCount; | |
1594 }; | |
1595 /** | |
1596 * Base class for pretty printing for expectation results. | |
1597 */ | |
1598 jasmine.PrettyPrinter = function() { | |
1599 this.ppNestLevel_ = 0; | |
1600 }; | |
1601 | |
1602 /** | |
1603 * Formats a value in a nice, human-readable string. | |
1604 * | |
1605 * @param value | |
1606 */ | |
1607 jasmine.PrettyPrinter.prototype.format = function(value) { | |
1608 if (this.ppNestLevel_ > 40) { | |
1609 throw new Error('jasmine.PrettyPrinter: format() nested too deeply!'); | |
1610 } | |
1611 | |
1612 this.ppNestLevel_++; | |
1613 try { | |
1614 if (value === jasmine.undefined) { | |
1615 this.emitScalar('undefined'); | |
1616 } else if (value === null) { | |
1617 this.emitScalar('null'); | |
1618 } else if (value === jasmine.getGlobal()) { | |
1619 this.emitScalar('<global>'); | |
1620 } else if (value instanceof jasmine.Matchers.Any) { | |
1621 this.emitScalar(value.toString()); | |
1622 } else if (typeof value === 'string') { | |
1623 this.emitString(value); | |
1624 } else if (jasmine.isSpy(value)) { | |
1625 this.emitScalar("spy on " + value.identity); | |
1626 } else if (value instanceof RegExp) { | |
1627 this.emitScalar(value.toString()); | |
1628 } else if (typeof value === 'function') { | |
1629 this.emitScalar('Function'); | |
1630 } else if (typeof value.nodeType === 'number') { | |
1631 this.emitScalar('HTMLNode'); | |
1632 } else if (value instanceof Date) { | |
1633 this.emitScalar('Date(' + value + ')'); | |
1634 } else if (value.__Jasmine_been_here_before__) { | |
1635 this.emitScalar('<circular reference: ' + (jasmine.isArray_(value) ? 'Array' : 'Object') + '>'); | |
1636 } else if (jasmine.isArray_(value) || typeof value == 'object') { | |
1637 value.__Jasmine_been_here_before__ = true; | |
1638 if (jasmine.isArray_(value)) { | |
1639 this.emitArray(value); | |
1640 } else { | |
1641 this.emitObject(value); | |
1642 } | |
1643 delete value.__Jasmine_been_here_before__; | |
1644 } else { | |
1645 this.emitScalar(value.toString()); | |
1646 } | |
1647 } finally { | |
1648 this.ppNestLevel_--; | |
1649 } | |
1650 }; | |
1651 | |
1652 jasmine.PrettyPrinter.prototype.iterateObject = function(obj, fn) { | |
1653 for (var property in obj) { | |
1654 if (property == '__Jasmine_been_here_before__') continue; | |
1655 fn(property, obj.__lookupGetter__ ? (obj.__lookupGetter__(property) !== jasmine.undefined && | |
1656 obj.__lookupGetter__(property) !== null) : false); | |
1657 } | |
1658 }; | |
1659 | |
1660 jasmine.PrettyPrinter.prototype.emitArray = jasmine.unimplementedMethod_; | |
1661 jasmine.PrettyPrinter.prototype.emitObject = jasmine.unimplementedMethod_; | |
1662 jasmine.PrettyPrinter.prototype.emitScalar = jasmine.unimplementedMethod_; | |
1663 jasmine.PrettyPrinter.prototype.emitString = jasmine.unimplementedMethod_; | |
1664 | |
1665 jasmine.StringPrettyPrinter = function() { | |
1666 jasmine.PrettyPrinter.call(this); | |
1667 | |
1668 this.string = ''; | |
1669 }; | |
1670 jasmine.util.inherit(jasmine.StringPrettyPrinter, jasmine.PrettyPrinter); | |
1671 | |
1672 jasmine.StringPrettyPrinter.prototype.emitScalar = function(value) { | |
1673 this.append(value); | |
1674 }; | |
1675 | |
1676 jasmine.StringPrettyPrinter.prototype.emitString = function(value) { | |
1677 this.append("'" + value + "'"); | |
1678 }; | |
1679 | |
1680 jasmine.StringPrettyPrinter.prototype.emitArray = function(array) { | |
1681 this.append('[ '); | |
1682 for (var i = 0; i < array.length; i++) { | |
1683 if (i > 0) { | |
1684 this.append(', '); | |
1685 } | |
1686 this.format(array[i]); | |
1687 } | |
1688 this.append(' ]'); | |
1689 }; | |
1690 | |
1691 jasmine.StringPrettyPrinter.prototype.emitObject = function(obj) { | |
1692 var self = this; | |
1693 this.append('{ '); | |
1694 var first = true; | |
1695 | |
1696 this.iterateObject(obj, function(property, isGetter) { | |
1697 if (first) { | |
1698 first = false; | |
1699 } else { | |
1700 self.append(', '); | |
1701 } | |
1702 | |
1703 self.append(property); | |
1704 self.append(' : '); | |
1705 if (isGetter) { | |
1706 self.append('<getter>'); | |
1707 } else { | |
1708 self.format(obj[property]); | |
1709 } | |
1710 }); | |
1711 | |
1712 this.append(' }'); | |
1713 }; | |
1714 | |
1715 jasmine.StringPrettyPrinter.prototype.append = function(value) { | |
1716 this.string += value; | |
1717 }; | |
1718 jasmine.Queue = function(env) { | |
1719 this.env = env; | |
1720 this.blocks = []; | |
1721 this.running = false; | |
1722 this.index = 0; | |
1723 this.offset = 0; | |
1724 this.abort = false; | |
1725 }; | |
1726 | |
1727 jasmine.Queue.prototype.addBefore = function(block) { | |
1728 this.blocks.unshift(block); | |
1729 }; | |
1730 | |
1731 jasmine.Queue.prototype.add = function(block) { | |
1732 this.blocks.push(block); | |
1733 }; | |
1734 | |
1735 jasmine.Queue.prototype.insertNext = function(block) { | |
1736 this.blocks.splice((this.index + this.offset + 1), 0, block); | |
1737 this.offset++; | |
1738 }; | |
1739 | |
1740 jasmine.Queue.prototype.start = function(onComplete) { | |
1741 this.running = true; | |
1742 this.onComplete = onComplete; | |
1743 this.next_(); | |
1744 }; | |
1745 | |
1746 jasmine.Queue.prototype.isRunning = function() { | |
1747 return this.running; | |
1748 }; | |
1749 | |
1750 jasmine.Queue.LOOP_DONT_RECURSE = true; | |
1751 | |
1752 jasmine.Queue.prototype.next_ = function() { | |
1753 var self = this; | |
1754 var goAgain = true; | |
1755 | |
1756 while (goAgain) { | |
1757 goAgain = false; | |
1758 | |
1759 if (self.index < self.blocks.length && !this.abort) { | |
1760 var calledSynchronously = true; | |
1761 var completedSynchronously = false; | |
1762 | |
1763 var onComplete = function () { | |
1764 if (jasmine.Queue.LOOP_DONT_RECURSE && calledSynchronously) { | |
1765 completedSynchronously = true; | |
1766 return; | |
1767 } | |
1768 | |
1769 if (self.blocks[self.index].abort) { | |
1770 self.abort = true; | |
1771 } | |
1772 | |
1773 self.offset = 0; | |
1774 self.index++; | |
1775 | |
1776 var now = new Date().getTime(); | |
1777 if (self.env.updateInterval && now - self.env.lastUpdate > self.env.updateInterval) { | |
1778 self.env.lastUpdate = now; | |
1779 self.env.setTimeout(function() { | |
1780 self.next_(); | |
1781 }, 0); | |
1782 } else { | |
1783 if (jasmine.Queue.LOOP_DONT_RECURSE && completedSynchronously) { | |
1784 goAgain = true; | |
1785 } else { | |
1786 self.next_(); | |
1787 } | |
1788 } | |
1789 }; | |
1790 self.blocks[self.index].execute(onComplete); | |
1791 | |
1792 calledSynchronously = false; | |
1793 if (completedSynchronously) { | |
1794 onComplete(); | |
1795 } | |
1796 | |
1797 } else { | |
1798 self.running = false; | |
1799 if (self.onComplete) { | |
1800 self.onComplete(); | |
1801 } | |
1802 } | |
1803 } | |
1804 }; | |
1805 | |
1806 jasmine.Queue.prototype.results = function() { | |
1807 var results = new jasmine.NestedResults(); | |
1808 for (var i = 0; i < this.blocks.length; i++) { | |
1809 if (this.blocks[i].results) { | |
1810 results.addResult(this.blocks[i].results()); | |
1811 } | |
1812 } | |
1813 return results; | |
1814 }; | |
1815 | |
1816 | |
1817 /** | |
1818 * Runner | |
1819 * | |
1820 * @constructor | |
1821 * @param {jasmine.Env} env | |
1822 */ | |
1823 jasmine.Runner = function(env) { | |
1824 var self = this; | |
1825 self.env = env; | |
1826 self.queue = new jasmine.Queue(env); | |
1827 self.before_ = []; | |
1828 self.after_ = []; | |
1829 self.suites_ = []; | |
1830 }; | |
1831 | |
1832 jasmine.Runner.prototype.execute = function() { | |
1833 var self = this; | |
1834 if (self.env.reporter.reportRunnerStarting) { | |
1835 self.env.reporter.reportRunnerStarting(this); | |
1836 } | |
1837 self.queue.start(function () { | |
1838 self.finishCallback(); | |
1839 }); | |
1840 }; | |
1841 | |
1842 jasmine.Runner.prototype.beforeEach = function(beforeEachFunction) { | |
1843 beforeEachFunction.typeName = 'beforeEach'; | |
1844 this.before_.splice(0,0,beforeEachFunction); | |
1845 }; | |
1846 | |
1847 jasmine.Runner.prototype.afterEach = function(afterEachFunction) { | |
1848 afterEachFunction.typeName = 'afterEach'; | |
1849 this.after_.splice(0,0,afterEachFunction); | |
1850 }; | |
1851 | |
1852 | |
1853 jasmine.Runner.prototype.finishCallback = function() { | |
1854 this.env.reporter.reportRunnerResults(this); | |
1855 }; | |
1856 | |
1857 jasmine.Runner.prototype.addSuite = function(suite) { | |
1858 this.suites_.push(suite); | |
1859 }; | |
1860 | |
1861 jasmine.Runner.prototype.add = function(block) { | |
1862 if (block instanceof jasmine.Suite) { | |
1863 this.addSuite(block); | |
1864 } | |
1865 this.queue.add(block); | |
1866 }; | |
1867 | |
1868 jasmine.Runner.prototype.specs = function () { | |
1869 var suites = this.suites(); | |
1870 var specs = []; | |
1871 for (var i = 0; i < suites.length; i++) { | |
1872 specs = specs.concat(suites[i].specs()); | |
1873 } | |
1874 return specs; | |
1875 }; | |
1876 | |
1877 jasmine.Runner.prototype.suites = function() { | |
1878 return this.suites_; | |
1879 }; | |
1880 | |
1881 jasmine.Runner.prototype.topLevelSuites = function() { | |
1882 var topLevelSuites = []; | |
1883 for (var i = 0; i < this.suites_.length; i++) { | |
1884 if (!this.suites_[i].parentSuite) { | |
1885 topLevelSuites.push(this.suites_[i]); | |
1886 } | |
1887 } | |
1888 return topLevelSuites; | |
1889 }; | |
1890 | |
1891 jasmine.Runner.prototype.results = function() { | |
1892 return this.queue.results(); | |
1893 }; | |
1894 /** | |
1895 * Internal representation of a Jasmine specification, or test. | |
1896 * | |
1897 * @constructor | |
1898 * @param {jasmine.Env} env | |
1899 * @param {jasmine.Suite} suite | |
1900 * @param {String} description | |
1901 */ | |
1902 jasmine.Spec = function(env, suite, description) { | |
1903 if (!env) { | |
1904 throw new Error('jasmine.Env() required'); | |
1905 } | |
1906 if (!suite) { | |
1907 throw new Error('jasmine.Suite() required'); | |
1908 } | |
1909 var spec = this; | |
1910 spec.id = env.nextSpecId ? env.nextSpecId() : null; | |
1911 spec.env = env; | |
1912 spec.suite = suite; | |
1913 spec.description = description; | |
1914 spec.queue = new jasmine.Queue(env); | |
1915 | |
1916 spec.afterCallbacks = []; | |
1917 spec.spies_ = []; | |
1918 | |
1919 spec.results_ = new jasmine.NestedResults(); | |
1920 spec.results_.description = description; | |
1921 spec.matchersClass = null; | |
1922 }; | |
1923 | |
1924 jasmine.Spec.prototype.getFullName = function() { | |
1925 return this.suite.getFullName() + ' ' + this.description + '.'; | |
1926 }; | |
1927 | |
1928 | |
1929 jasmine.Spec.prototype.results = function() { | |
1930 return this.results_; | |
1931 }; | |
1932 | |
1933 /** | |
1934 * All parameters are pretty-printed and concatenated together, then written to the spec's output. | |
1935 * | |
1936 * Be careful not to leave calls to <code>jasmine.log</code> in production code. | |
1937 */ | |
1938 jasmine.Spec.prototype.log = function() { | |
1939 return this.results_.log(arguments); | |
1940 }; | |
1941 | |
1942 jasmine.Spec.prototype.runs = function (func) { | |
1943 var block = new jasmine.Block(this.env, func, this); | |
1944 this.addToQueue(block); | |
1945 return this; | |
1946 }; | |
1947 | |
1948 jasmine.Spec.prototype.addToQueue = function (block) { | |
1949 if (this.queue.isRunning()) { | |
1950 this.queue.insertNext(block); | |
1951 } else { | |
1952 this.queue.add(block); | |
1953 } | |
1954 }; | |
1955 | |
1956 /** | |
1957 * @param {jasmine.ExpectationResult} result | |
1958 */ | |
1959 jasmine.Spec.prototype.addMatcherResult = function(result) { | |
1960 this.results_.addResult(result); | |
1961 }; | |
1962 | |
1963 jasmine.Spec.prototype.expect = function(actual) { | |
1964 var positive = new (this.getMatchersClass_())(this.env, actual, this); | |
1965 positive.not = new (this.getMatchersClass_())(this.env, actual, this, true); | |
1966 return positive; | |
1967 }; | |
1968 | |
1969 /** | |
1970 * Waits a fixed time period before moving to the next block. | |
1971 * | |
1972 * @deprecated Use waitsFor() instead | |
1973 * @param {Number} timeout milliseconds to wait | |
1974 */ | |
1975 jasmine.Spec.prototype.waits = function(timeout) { | |
1976 var waitsFunc = new jasmine.WaitsBlock(this.env, timeout, this); | |
1977 this.addToQueue(waitsFunc); | |
1978 return this; | |
1979 }; | |
1980 | |
1981 /** | |
1982 * Waits for the latchFunction to return true before proceeding to the next block. | |
1983 * | |
1984 * @param {Function} latchFunction | |
1985 * @param {String} optional_timeoutMessage | |
1986 * @param {Number} optional_timeout | |
1987 */ | |
1988 jasmine.Spec.prototype.waitsFor = function(latchFunction, optional_timeoutMessage, optional_timeout) { | |
1989 var latchFunction_ = null; | |
1990 var optional_timeoutMessage_ = null; | |
1991 var optional_timeout_ = null; | |
1992 | |
1993 for (var i = 0; i < arguments.length; i++) { | |
1994 var arg = arguments[i]; | |
1995 switch (typeof arg) { | |
1996 case 'function': | |
1997 latchFunction_ = arg; | |
1998 break; | |
1999 case 'string': | |
2000 optional_timeoutMessage_ = arg; | |
2001 break; | |
2002 case 'number': | |
2003 optional_timeout_ = arg; | |
2004 break; | |
2005 } | |
2006 } | |
2007 | |
2008 var waitsForFunc = new jasmine.WaitsForBlock(this.env, optional_timeout_, latchFunction_, optional_timeoutMessage_, this); | |
2009 this.addToQueue(waitsForFunc); | |
2010 return this; | |
2011 }; | |
2012 | |
2013 jasmine.Spec.prototype.fail = function (e) { | |
2014 var expectationResult = new jasmine.ExpectationResult({ | |
2015 passed: false, | |
2016 message: e ? jasmine.util.formatException(e) : 'Exception', | |
2017 trace: { stack: e.stack } | |
2018 }); | |
2019 this.results_.addResult(expectationResult); | |
2020 }; | |
2021 | |
2022 jasmine.Spec.prototype.getMatchersClass_ = function() { | |
2023 return this.matchersClass || this.env.matchersClass; | |
2024 }; | |
2025 | |
2026 jasmine.Spec.prototype.addMatchers = function(matchersPrototype) { | |
2027 var parent = this.getMatchersClass_(); | |
2028 var newMatchersClass = function() { | |
2029 parent.apply(this, arguments); | |
2030 }; | |
2031 jasmine.util.inherit(newMatchersClass, parent); | |
2032 jasmine.Matchers.wrapInto_(matchersPrototype, newMatchersClass); | |
2033 this.matchersClass = newMatchersClass; | |
2034 }; | |
2035 | |
2036 jasmine.Spec.prototype.finishCallback = function() { | |
2037 this.env.reporter.reportSpecResults(this); | |
2038 }; | |
2039 | |
2040 jasmine.Spec.prototype.finish = function(onComplete) { | |
2041 this.removeAllSpies(); | |
2042 this.finishCallback(); | |
2043 if (onComplete) { | |
2044 onComplete(); | |
2045 } | |
2046 }; | |
2047 | |
2048 jasmine.Spec.prototype.after = function(doAfter) { | |
2049 if (this.queue.isRunning()) { | |
2050 this.queue.add(new jasmine.Block(this.env, doAfter, this)); | |
2051 } else { | |
2052 this.afterCallbacks.unshift(doAfter); | |
2053 } | |
2054 }; | |
2055 | |
2056 jasmine.Spec.prototype.execute = function(onComplete) { | |
2057 var spec = this; | |
2058 if (!spec.env.specFilter(spec)) { | |
2059 spec.results_.skipped = true; | |
2060 spec.finish(onComplete); | |
2061 return; | |
2062 } | |
2063 | |
2064 this.env.reporter.reportSpecStarting(this); | |
2065 | |
2066 spec.env.currentSpec = spec; | |
2067 | |
2068 spec.addBeforesAndAftersToQueue(); | |
2069 | |
2070 spec.queue.start(function () { | |
2071 spec.finish(onComplete); | |
2072 }); | |
2073 }; | |
2074 | |
2075 jasmine.Spec.prototype.addBeforesAndAftersToQueue = function() { | |
2076 var runner = this.env.currentRunner(); | |
2077 var i; | |
2078 | |
2079 for (var suite = this.suite; suite; suite = suite.parentSuite) { | |
2080 for (i = 0; i < suite.before_.length; i++) { | |
2081 this.queue.addBefore(new jasmine.Block(this.env, suite.before_[i], this)); | |
2082 } | |
2083 } | |
2084 for (i = 0; i < runner.before_.length; i++) { | |
2085 this.queue.addBefore(new jasmine.Block(this.env, runner.before_[i], this)); | |
2086 } | |
2087 for (i = 0; i < this.afterCallbacks.length; i++) { | |
2088 this.queue.add(new jasmine.Block(this.env, this.afterCallbacks[i], this)); | |
2089 } | |
2090 for (suite = this.suite; suite; suite = suite.parentSuite) { | |
2091 for (i = 0; i < suite.after_.length; i++) { | |
2092 this.queue.add(new jasmine.Block(this.env, suite.after_[i], this)); | |
2093 } | |
2094 } | |
2095 for (i = 0; i < runner.after_.length; i++) { | |
2096 this.queue.add(new jasmine.Block(this.env, runner.after_[i], this)); | |
2097 } | |
2098 }; | |
2099 | |
2100 jasmine.Spec.prototype.explodes = function() { | |
2101 throw 'explodes function should not have been called'; | |
2102 }; | |
2103 | |
2104 jasmine.Spec.prototype.spyOn = function(obj, methodName, ignoreMethodDoesntExist) { | |
2105 if (obj == jasmine.undefined) { | |
2106 throw "spyOn could not find an object to spy upon for " + methodName + "()"; | |
2107 } | |
2108 | |
2109 if (!ignoreMethodDoesntExist && obj[methodName] === jasmine.undefined) { | |
2110 throw methodName + '() method does not exist'; | |
2111 } | |
2112 | |
2113 if (!ignoreMethodDoesntExist && obj[methodName] && obj[methodName].isSpy) { | |
2114 throw new Error(methodName + ' has already been spied upon'); | |
2115 } | |
2116 | |
2117 var spyObj = jasmine.createSpy(methodName); | |
2118 | |
2119 this.spies_.push(spyObj); | |
2120 spyObj.baseObj = obj; | |
2121 spyObj.methodName = methodName; | |
2122 spyObj.originalValue = obj[methodName]; | |
2123 | |
2124 obj[methodName] = spyObj; | |
2125 | |
2126 return spyObj; | |
2127 }; | |
2128 | |
2129 jasmine.Spec.prototype.removeAllSpies = function() { | |
2130 for (var i = 0; i < this.spies_.length; i++) { | |
2131 var spy = this.spies_[i]; | |
2132 spy.baseObj[spy.methodName] = spy.originalValue; | |
2133 } | |
2134 this.spies_ = []; | |
2135 }; | |
2136 | |
2137 /** | |
2138 * Internal representation of a Jasmine suite. | |
2139 * | |
2140 * @constructor | |
2141 * @param {jasmine.Env} env | |
2142 * @param {String} description | |
2143 * @param {Function} specDefinitions | |
2144 * @param {jasmine.Suite} parentSuite | |
2145 */ | |
2146 jasmine.Suite = function(env, description, specDefinitions, parentSuite) { | |
2147 var self = this; | |
2148 self.id = env.nextSuiteId ? env.nextSuiteId() : null; | |
2149 self.description = description; | |
2150 self.queue = new jasmine.Queue(env); | |
2151 self.parentSuite = parentSuite; | |
2152 self.env = env; | |
2153 self.before_ = []; | |
2154 self.after_ = []; | |
2155 self.children_ = []; | |
2156 self.suites_ = []; | |
2157 self.specs_ = []; | |
2158 }; | |
2159 | |
2160 jasmine.Suite.prototype.getFullName = function() { | |
2161 var fullName = this.description; | |
2162 for (var parentSuite = this.parentSuite; parentSuite; parentSuite = parentSuite.parentSuite) { | |
2163 fullName = parentSuite.description + ' ' + fullName; | |
2164 } | |
2165 return fullName; | |
2166 }; | |
2167 | |
2168 jasmine.Suite.prototype.finish = function(onComplete) { | |
2169 this.env.reporter.reportSuiteResults(this); | |
2170 this.finished = true; | |
2171 if (typeof(onComplete) == 'function') { | |
2172 onComplete(); | |
2173 } | |
2174 }; | |
2175 | |
2176 jasmine.Suite.prototype.beforeEach = function(beforeEachFunction) { | |
2177 beforeEachFunction.typeName = 'beforeEach'; | |
2178 this.before_.unshift(beforeEachFunction); | |
2179 }; | |
2180 | |
2181 jasmine.Suite.prototype.afterEach = function(afterEachFunction) { | |
2182 afterEachFunction.typeName = 'afterEach'; | |
2183 this.after_.unshift(afterEachFunction); | |
2184 }; | |
2185 | |
2186 jasmine.Suite.prototype.results = function() { | |
2187 return this.queue.results(); | |
2188 }; | |
2189 | |
2190 jasmine.Suite.prototype.add = function(suiteOrSpec) { | |
2191 this.children_.push(suiteOrSpec); | |
2192 if (suiteOrSpec instanceof jasmine.Suite) { | |
2193 this.suites_.push(suiteOrSpec); | |
2194 this.env.currentRunner().addSuite(suiteOrSpec); | |
2195 } else { | |
2196 this.specs_.push(suiteOrSpec); | |
2197 } | |
2198 this.queue.add(suiteOrSpec); | |
2199 }; | |
2200 | |
2201 jasmine.Suite.prototype.specs = function() { | |
2202 return this.specs_; | |
2203 }; | |
2204 | |
2205 jasmine.Suite.prototype.suites = function() { | |
2206 return this.suites_; | |
2207 }; | |
2208 | |
2209 jasmine.Suite.prototype.children = function() { | |
2210 return this.children_; | |
2211 }; | |
2212 | |
2213 jasmine.Suite.prototype.execute = function(onComplete) { | |
2214 var self = this; | |
2215 this.queue.start(function () { | |
2216 self.finish(onComplete); | |
2217 }); | |
2218 }; | |
2219 jasmine.WaitsBlock = function(env, timeout, spec) { | |
2220 this.timeout = timeout; | |
2221 jasmine.Block.call(this, env, null, spec); | |
2222 }; | |
2223 | |
2224 jasmine.util.inherit(jasmine.WaitsBlock, jasmine.Block); | |
2225 | |
2226 jasmine.WaitsBlock.prototype.execute = function (onComplete) { | |
2227 if (jasmine.VERBOSE) { | |
2228 this.env.reporter.log('>> Jasmine waiting for ' + this.timeout + ' ms...'); | |
2229 } | |
2230 this.env.setTimeout(function () { | |
2231 onComplete(); | |
2232 }, this.timeout); | |
2233 }; | |
2234 /** | |
2235 * A block which waits for some condition to become true, with timeout. | |
2236 * | |
2237 * @constructor | |
2238 * @extends jasmine.Block | |
2239 * @param {jasmine.Env} env The Jasmine environment. | |
2240 * @param {Number} timeout The maximum time in milliseconds to wait for the condition to become true. | |
2241 * @param {Function} latchFunction A function which returns true when the desired condition has been met. | |
2242 * @param {String} message The message to display if the desired condition hasn't been met within the given time period. | |
2243 * @param {jasmine.Spec} spec The Jasmine spec. | |
2244 */ | |
2245 jasmine.WaitsForBlock = function(env, timeout, latchFunction, message, spec) { | |
2246 this.timeout = timeout || env.defaultTimeoutInterval; | |
2247 this.latchFunction = latchFunction; | |
2248 this.message = message; | |
2249 this.totalTimeSpentWaitingForLatch = 0; | |
2250 jasmine.Block.call(this, env, null, spec); | |
2251 }; | |
2252 jasmine.util.inherit(jasmine.WaitsForBlock, jasmine.Block); | |
2253 | |
2254 jasmine.WaitsForBlock.TIMEOUT_INCREMENT = 10; | |
2255 | |
2256 jasmine.WaitsForBlock.prototype.execute = function(onComplete) { | |
2257 if (jasmine.VERBOSE) { | |
2258 this.env.reporter.log('>> Jasmine waiting for ' + (this.message || 'something to happen')); | |
2259 } | |
2260 var latchFunctionResult; | |
2261 try { | |
2262 latchFunctionResult = this.latchFunction.apply(this.spec); | |
2263 } catch (e) { | |
2264 this.spec.fail(e); | |
2265 onComplete(); | |
2266 return; | |
2267 } | |
2268 | |
2269 if (latchFunctionResult) { | |
2270 onComplete(); | |
2271 } else if (this.totalTimeSpentWaitingForLatch >= this.timeout) { | |
2272 var message = 'timed out after ' + this.timeout + ' msec waiting for ' + (this.message || 'something to happen'); | |
2273 this.spec.fail({ | |
2274 name: 'timeout', | |
2275 message: message | |
2276 }); | |
2277 | |
2278 this.abort = true; | |
2279 onComplete(); | |
2280 } else { | |
2281 this.totalTimeSpentWaitingForLatch += jasmine.WaitsForBlock.TIMEOUT_INCREMENT; | |
2282 var self = this; | |
2283 this.env.setTimeout(function() { | |
2284 self.execute(onComplete); | |
2285 }, jasmine.WaitsForBlock.TIMEOUT_INCREMENT); | |
2286 } | |
2287 }; | |
2288 // Mock setTimeout, clearTimeout | |
2289 // Contributed by Pivotal Computer Systems, www.pivotalsf.com | |
2290 | |
2291 jasmine.FakeTimer = function() { | |
2292 this.reset(); | |
2293 | |
2294 var self = this; | |
2295 self.setTimeout = function(funcToCall, millis) { | |
2296 self.timeoutsMade++; | |
2297 self.scheduleFunction(self.timeoutsMade, funcToCall, millis, false); | |
2298 return self.timeoutsMade; | |
2299 }; | |
2300 | |
2301 self.setInterval = function(funcToCall, millis) { | |
2302 self.timeoutsMade++; | |
2303 self.scheduleFunction(self.timeoutsMade, funcToCall, millis, true); | |
2304 return self.timeoutsMade; | |
2305 }; | |
2306 | |
2307 self.clearTimeout = function(timeoutKey) { | |
2308 self.scheduledFunctions[timeoutKey] = jasmine.undefined; | |
2309 }; | |
2310 | |
2311 self.clearInterval = function(timeoutKey) { | |
2312 self.scheduledFunctions[timeoutKey] = jasmine.undefined; | |
2313 }; | |
2314 | |
2315 }; | |
2316 | |
2317 jasmine.FakeTimer.prototype.reset = function() { | |
2318 this.timeoutsMade = 0; | |
2319 this.scheduledFunctions = {}; | |
2320 this.nowMillis = 0; | |
2321 }; | |
2322 | |
2323 jasmine.FakeTimer.prototype.tick = function(millis) { | |
2324 var oldMillis = this.nowMillis; | |
2325 var newMillis = oldMillis + millis; | |
2326 this.runFunctionsWithinRange(oldMillis, newMillis); | |
2327 this.nowMillis = newMillis; | |
2328 }; | |
2329 | |
2330 jasmine.FakeTimer.prototype.runFunctionsWithinRange = function(oldMillis, nowMillis) { | |
2331 var scheduledFunc; | |
2332 var funcsToRun = []; | |
2333 for (var timeoutKey in this.scheduledFunctions) { | |
2334 scheduledFunc = this.scheduledFunctions[timeoutKey]; | |
2335 if (scheduledFunc != jasmine.undefined && | |
2336 scheduledFunc.runAtMillis >= oldMillis && | |
2337 scheduledFunc.runAtMillis <= nowMillis) { | |
2338 funcsToRun.push(scheduledFunc); | |
2339 this.scheduledFunctions[timeoutKey] = jasmine.undefined; | |
2340 } | |
2341 } | |
2342 | |
2343 if (funcsToRun.length > 0) { | |
2344 funcsToRun.sort(function(a, b) { | |
2345 return a.runAtMillis - b.runAtMillis; | |
2346 }); | |
2347 for (var i = 0; i < funcsToRun.length; ++i) { | |
2348 try { | |
2349 var funcToRun = funcsToRun[i]; | |
2350 this.nowMillis = funcToRun.runAtMillis; | |
2351 funcToRun.funcToCall(); | |
2352 if (funcToRun.recurring) { | |
2353 this.scheduleFunction(funcToRun.timeoutKey, | |
2354 funcToRun.funcToCall, | |
2355 funcToRun.millis, | |
2356 true); | |
2357 } | |
2358 } catch(e) { | |
2359 } | |
2360 } | |
2361 this.runFunctionsWithinRange(oldMillis, nowMillis); | |
2362 } | |
2363 }; | |
2364 | |
2365 jasmine.FakeTimer.prototype.scheduleFunction = function(timeoutKey, funcToCall, millis, recurring) { | |
2366 this.scheduledFunctions[timeoutKey] = { | |
2367 runAtMillis: this.nowMillis + millis, | |
2368 funcToCall: funcToCall, | |
2369 recurring: recurring, | |
2370 timeoutKey: timeoutKey, | |
2371 millis: millis | |
2372 }; | |
2373 }; | |
2374 | |
2375 /** | |
2376 * @namespace | |
2377 */ | |
2378 jasmine.Clock = { | |
2379 defaultFakeTimer: new jasmine.FakeTimer(), | |
2380 | |
2381 reset: function() { | |
2382 jasmine.Clock.assertInstalled(); | |
2383 jasmine.Clock.defaultFakeTimer.reset(); | |
2384 }, | |
2385 | |
2386 tick: function(millis) { | |
2387 jasmine.Clock.assertInstalled(); | |
2388 jasmine.Clock.defaultFakeTimer.tick(millis); | |
2389 }, | |
2390 | |
2391 runFunctionsWithinRange: function(oldMillis, nowMillis) { | |
2392 jasmine.Clock.defaultFakeTimer.runFunctionsWithinRange(oldMillis, nowMillis); | |
2393 }, | |
2394 | |
2395 scheduleFunction: function(timeoutKey, funcToCall, millis, recurring) { | |
2396 jasmine.Clock.defaultFakeTimer.scheduleFunction(timeoutKey, funcToCall, millis, recurring); | |
2397 }, | |
2398 | |
2399 useMock: function() { | |
2400 if (!jasmine.Clock.isInstalled()) { | |
2401 var spec = jasmine.getEnv().currentSpec; | |
2402 spec.after(jasmine.Clock.uninstallMock); | |
2403 | |
2404 jasmine.Clock.installMock(); | |
2405 } | |
2406 }, | |
2407 | |
2408 installMock: function() { | |
2409 jasmine.Clock.installed = jasmine.Clock.defaultFakeTimer; | |
2410 }, | |
2411 | |
2412 uninstallMock: function() { | |
2413 jasmine.Clock.assertInstalled(); | |
2414 jasmine.Clock.installed = jasmine.Clock.real; | |
2415 }, | |
2416 | |
2417 real: { | |
2418 setTimeout: jasmine.getGlobal().setTimeout, | |
2419 clearTimeout: jasmine.getGlobal().clearTimeout, | |
2420 setInterval: jasmine.getGlobal().setInterval, | |
2421 clearInterval: jasmine.getGlobal().clearInterval | |
2422 }, | |
2423 | |
2424 assertInstalled: function() { | |
2425 if (!jasmine.Clock.isInstalled()) { | |
2426 throw new Error("Mock clock is not installed, use jasmine.Clock.useMock()"); | |
2427 } | |
2428 }, | |
2429 | |
2430 isInstalled: function() { | |
2431 return jasmine.Clock.installed == jasmine.Clock.defaultFakeTimer; | |
2432 }, | |
2433 | |
2434 installed: null | |
2435 }; | |
2436 jasmine.Clock.installed = jasmine.Clock.real; | |
2437 | |
2438 //else for IE support | |
2439 jasmine.getGlobal().setTimeout = function(funcToCall, millis) { | |
2440 if (jasmine.Clock.installed.setTimeout.apply) { | |
2441 return jasmine.Clock.installed.setTimeout.apply(this, arguments); | |
2442 } else { | |
2443 return jasmine.Clock.installed.setTimeout(funcToCall, millis); | |
2444 } | |
2445 }; | |
2446 | |
2447 jasmine.getGlobal().setInterval = function(funcToCall, millis) { | |
2448 if (jasmine.Clock.installed.setInterval.apply) { | |
2449 return jasmine.Clock.installed.setInterval.apply(this, arguments); | |
2450 } else { | |
2451 return jasmine.Clock.installed.setInterval(funcToCall, millis); | |
2452 } | |
2453 }; | |
2454 | |
2455 jasmine.getGlobal().clearTimeout = function(timeoutKey) { | |
2456 if (jasmine.Clock.installed.clearTimeout.apply) { | |
2457 return jasmine.Clock.installed.clearTimeout.apply(this, arguments); | |
2458 } else { | |
2459 return jasmine.Clock.installed.clearTimeout(timeoutKey); | |
2460 } | |
2461 }; | |
2462 | |
2463 jasmine.getGlobal().clearInterval = function(timeoutKey) { | |
2464 if (jasmine.Clock.installed.clearTimeout.apply) { | |
2465 return jasmine.Clock.installed.clearInterval.apply(this, arguments); | |
2466 } else { | |
2467 return jasmine.Clock.installed.clearInterval(timeoutKey); | |
2468 } | |
2469 }; | |
2470 | |
2471 jasmine.version_= { | |
2472 "major": 1, | |
2473 "minor": 1, | |
2474 "build": 0, | |
2475 "revision": 1315677058 | |
2476 }; |