source: main/trunk/greenstone3/web/interfaces/oran/js/annotator/lib/vendor/jasmine-2.0.0rc1/jasmine.js@ 24771

Last change on this file since 24771 was 24771, checked in by papitha, 13 years ago

Changes to JS

File size: 65.2 KB
Line 
1var isCommonJS = typeof window == "undefined";
2
3/**
4 * Top level namespace for Jasmine, a lightweight JavaScript BDD/spec/testing framework.
5 *
6 * @namespace
7 */
8var jasmine = {};
9if (isCommonJS) exports.jasmine = jasmine;
10/**
11 * @private
12 */
13jasmine.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 */
23jasmine.undefined = jasmine.___undefined___;
24
25/**
26 * Show diagnostic messages in the console if set to true
27 *
28 */
29jasmine.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 */
35jasmine.DEFAULT_UPDATE_INTERVAL = 250;
36
37/**
38 * Default timeout interval in milliseconds for waitsFor() blocks.
39 */
40jasmine.DEFAULT_TIMEOUT_INTERVAL = 5000;
41
42jasmine.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 */
58jasmine.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
70jasmine.setTimeout = jasmine.bindOriginal_(jasmine.getGlobal(), 'setTimeout');
71jasmine.clearTimeout = jasmine.bindOriginal_(jasmine.getGlobal(), 'clearTimeout');
72jasmine.setInterval = jasmine.bindOriginal_(jasmine.getGlobal(), 'setInterval');
73jasmine.clearInterval = jasmine.bindOriginal_(jasmine.getGlobal(), 'clearInterval');
74
75jasmine.MessageResult = function(values) {
76 this.type = 'log';
77 this.values = values;
78 this.trace = new Error(); // todo: test better
79};
80
81jasmine.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
94jasmine.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
106jasmine.ExpectationResult.prototype.toString = function () {
107 return this.message;
108};
109
110jasmine.ExpectationResult.prototype.passed = function () {
111 return this.passed_;
112};
113
114/**
115 * Getter for the Jasmine environment. Ensures one gets created
116 */
117jasmine.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 */
128jasmine.isArray_ = function(value) {
129 return jasmine.isA_("Array", value);
130};
131
132/**
133 * @ignore
134 * @private
135 * @param value
136 * @returns {Boolean}
137 */
138jasmine.isString_ = function(value) {
139 return jasmine.isA_("String", value);
140};
141
142/**
143 * @ignore
144 * @private
145 * @param value
146 * @returns {Boolean}
147 */
148jasmine.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 */
159jasmine.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 */
169jasmine.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 */
181jasmine.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 */
195jasmine.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 */
243jasmine.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 */
291jasmine.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 */
308jasmine.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 */
327jasmine.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 */
349jasmine.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 */
368jasmine.Spy.prototype.reset = function() {
369 this.wasCalled = false;
370 this.callCount = 0;
371 this.argsForCall = [];
372 this.calls = [];
373 this.mostRecentCall = {};
374};
375
376jasmine.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 */
406jasmine.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 */
417jasmine.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 */
433jasmine.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 */
453var spyOn = function(obj, methodName) {
454 return jasmine.getEnv().currentSpec.spyOn(obj, methodName);
455};
456if (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 */
471var it = function(desc, func) {
472 return jasmine.getEnv().it(desc, func);
473};
474if (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 */
484var xit = function(desc, func) {
485 return jasmine.getEnv().xit(desc, func);
486};
487if (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 */
497var expect = function(actual) {
498 return jasmine.getEnv().currentSpec.expect(actual);
499};
500if (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 */
507var runs = function(func) {
508 jasmine.getEnv().currentSpec.runs(func);
509};
510if (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 */
518var waits = function(timeout) {
519 jasmine.getEnv().currentSpec.waits(timeout);
520};
521if (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 */
530var waitsFor = function(latchFunction, optional_timeoutMessage, optional_timeout) {
531 jasmine.getEnv().currentSpec.waitsFor.apply(jasmine.getEnv().currentSpec, arguments);
532};
533if (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 */
542var beforeEach = function(beforeEachFunction) {
543 jasmine.getEnv().beforeEach(beforeEachFunction);
544};
545if (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 */
554var afterEach = function(afterEachFunction) {
555 jasmine.getEnv().afterEach(afterEachFunction);
556};
557if (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 */
574var describe = function(description, specDefinitions) {
575 return jasmine.getEnv().describe(description, specDefinitions);
576};
577if (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 */
585var xdescribe = function(description, specDefinitions) {
586 return jasmine.getEnv().xdescribe(description, specDefinitions);
587};
588if (isCommonJS) exports.xdescribe = xdescribe;
589
590
591// Provide the XMLHttpRequest class for IE 5.x-6.x:
592jasmine.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 */
621jasmine.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 */
630jasmine.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
640jasmine.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
667jasmine.util.htmlEscape = function(str) {
668 if (!str) return str;
669 return str.replace(/&/g, '&amp;')
670 .replace(/</g, '&lt;')
671 .replace(/>/g, '&gt;');
672};
673
674jasmine.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
680jasmine.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 */
690jasmine.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
718jasmine.Env.prototype.setTimeout = jasmine.setTimeout;
719jasmine.Env.prototype.clearTimeout = jasmine.clearTimeout;
720jasmine.Env.prototype.setInterval = jasmine.setInterval;
721jasmine.Env.prototype.clearInterval = jasmine.clearInterval;
722
723/**
724 * @returns an object containing jasmine version build info, if set.
725 */
726jasmine.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 */
737jasmine.Env.prototype.versionString = function() {
738 if (jasmine.version_) {
739 var version = this.version();
740 var versionString = version.major + "." + version.minor + "." + version.build;
741 if (version.release_candidate) {
742 versionString += ".rc" + version.release_candidate
743 }
744 versionString += " revision " + version.revision
745 return versionString;
746 } else {
747 return "version unknown";
748 }
749};
750
751/**
752 * @returns a sequential integer starting at 0
753 */
754jasmine.Env.prototype.nextSpecId = function () {
755 return this.nextSpecId_++;
756};
757
758/**
759 * @returns a sequential integer starting at 0
760 */
761jasmine.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 */
769jasmine.Env.prototype.addReporter = function(reporter) {
770 this.reporter.addReporter(reporter);
771};
772
773jasmine.Env.prototype.execute = function() {
774 this.currentRunner_.execute();
775};
776
777jasmine.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
807jasmine.Env.prototype.beforeEach = function(beforeEachFunction) {
808 if (this.currentSuite) {
809 this.currentSuite.beforeEach(beforeEachFunction);
810 } else {
811 this.currentRunner_.beforeEach(beforeEachFunction);
812 }
813};
814
815jasmine.Env.prototype.currentRunner = function () {
816 return this.currentRunner_;
817};
818
819jasmine.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
828jasmine.Env.prototype.xdescribe = function(desc, specDefinitions) {
829 return {
830 execute: function() {
831 }
832 };
833};
834
835jasmine.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
847jasmine.Env.prototype.xit = function(desc, func) {
848 return {
849 id: this.nextSpecId(),
850 runs: function() {
851 }
852 };
853};
854
855jasmine.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
893jasmine.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
941jasmine.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
951jasmine.Env.prototype.addEqualityTester = function(equalityTester) {
952 this.equalityTesters_.push(equalityTester);
953};
954/** No-op base class for Jasmine reporters.
955 *
956 * @constructor
957 */
958jasmine.Reporter = function() {
959};
960
961//noinspection JSUnusedLocalSymbols
962jasmine.Reporter.prototype.reportRunnerStarting = function(runner) {
963};
964
965//noinspection JSUnusedLocalSymbols
966jasmine.Reporter.prototype.reportRunnerResults = function(runner) {
967};
968
969//noinspection JSUnusedLocalSymbols
970jasmine.Reporter.prototype.reportSuiteResults = function(suite) {
971};
972
973//noinspection JSUnusedLocalSymbols
974jasmine.Reporter.prototype.reportSpecStarting = function(spec) {
975};
976
977//noinspection JSUnusedLocalSymbols
978jasmine.Reporter.prototype.reportSpecResults = function(spec) {
979};
980
981//noinspection JSUnusedLocalSymbols
982jasmine.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 */
993jasmine.Block = function(env, func, spec) {
994 this.env = env;
995 this.func = func;
996 this.spec = spec;
997};
998
999jasmine.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 */
1011jasmine.JsApiReporter = function() {
1012 this.started = false;
1013 this.finished = false;
1014 this.suites_ = [];
1015 this.results_ = {};
1016};
1017
1018jasmine.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
1027jasmine.JsApiReporter.prototype.suites = function() {
1028 return this.suites_;
1029};
1030
1031jasmine.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
1049jasmine.JsApiReporter.prototype.results = function() {
1050 return this.results_;
1051};
1052
1053jasmine.JsApiReporter.prototype.resultsForSpec = function(specId) {
1054 return this.results_[specId];
1055};
1056
1057//noinspection JSUnusedLocalSymbols
1058jasmine.JsApiReporter.prototype.reportRunnerResults = function(runner) {
1059 this.finished = true;
1060};
1061
1062//noinspection JSUnusedLocalSymbols
1063jasmine.JsApiReporter.prototype.reportSuiteResults = function(suite) {
1064};
1065
1066//noinspection JSUnusedLocalSymbols
1067jasmine.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
1075jasmine.JsApiReporter.prototype.log = function(str) {
1076};
1077
1078jasmine.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
1087jasmine.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 */
1115jasmine.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]
1124jasmine.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]
1129jasmine.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
1133jasmine.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
1141jasmine.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 */
1190jasmine.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 */
1199jasmine.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 */
1208jasmine.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 */
1217jasmine.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 */
1227jasmine.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 */
1236jasmine.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 */
1243jasmine.Matchers.prototype.toBeDefined = function() {
1244 return (this.actual !== jasmine.undefined);
1245};
1246
1247/**
1248 * Matcher that compares the actual to jasmine.undefined.
1249 */
1250jasmine.Matchers.prototype.toBeUndefined = function() {
1251 return (this.actual === jasmine.undefined);
1252};
1253
1254/**
1255 * Matcher that compares the actual to null.
1256 */
1257jasmine.Matchers.prototype.toBeNull = function() {
1258 return (this.actual === null);
1259};
1260
1261/**
1262 * Matcher that boolean not-nots the actual.
1263 */
1264jasmine.Matchers.prototype.toBeTruthy = function() {
1265 return !!this.actual;
1266};
1267
1268
1269/**
1270 * Matcher that boolean nots the actual.
1271 */
1272jasmine.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 */
1280jasmine.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 */
1300jasmine.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 */
1307jasmine.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 */
1332jasmine.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 */
1356jasmine.Matchers.prototype.wasCalledWith = jasmine.Matchers.prototype.toHaveBeenCalledWith;
1357
1358/** @deprecated Use expect(xxx).not.toHaveBeenCalledWith() instead */
1359jasmine.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 */
1380jasmine.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 */
1390jasmine.Matchers.prototype.toNotContain = function(expected) {
1391 return !this.env.contains_(this.actual, expected);
1392};
1393
1394jasmine.Matchers.prototype.toBeLessThan = function(expected) {
1395 return this.actual < expected;
1396};
1397
1398jasmine.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 */
1409jasmine.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 */
1424jasmine.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
1452jasmine.Matchers.Any = function(expectedClass) {
1453 this.expectedClass = expectedClass;
1454};
1455
1456jasmine.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
1476jasmine.Matchers.Any.prototype.toString = function() {
1477 return '<jasmine.any(' + this.expectedClass + ')>';
1478};
1479
1480/**
1481 * @constructor
1482 */
1483jasmine.MultiReporter = function() {
1484 this.subReporters_ = [];
1485};
1486jasmine.util.inherit(jasmine.MultiReporter, jasmine.Reporter);
1487
1488jasmine.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 */
1520jasmine.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 */
1548jasmine.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 */
1558jasmine.NestedResults.prototype.log = function(values) {
1559 this.items_.push(new jasmine.MessageResult(values));
1560};
1561
1562/**
1563 * Getter for the results: message & results.
1564 */
1565jasmine.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 */
1573jasmine.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 */
1592jasmine.NestedResults.prototype.passed = function() {
1593 return this.passedCount === this.totalCount;
1594};
1595/**
1596 * Base class for pretty printing for expectation results.
1597 */
1598jasmine.PrettyPrinter = function() {
1599 this.ppNestLevel_ = 0;
1600};
1601
1602/**
1603 * Formats a value in a nice, human-readable string.
1604 *
1605 * @param value
1606 */
1607jasmine.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
1652jasmine.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
1660jasmine.PrettyPrinter.prototype.emitArray = jasmine.unimplementedMethod_;
1661jasmine.PrettyPrinter.prototype.emitObject = jasmine.unimplementedMethod_;
1662jasmine.PrettyPrinter.prototype.emitScalar = jasmine.unimplementedMethod_;
1663jasmine.PrettyPrinter.prototype.emitString = jasmine.unimplementedMethod_;
1664
1665jasmine.StringPrettyPrinter = function() {
1666 jasmine.PrettyPrinter.call(this);
1667
1668 this.string = '';
1669};
1670jasmine.util.inherit(jasmine.StringPrettyPrinter, jasmine.PrettyPrinter);
1671
1672jasmine.StringPrettyPrinter.prototype.emitScalar = function(value) {
1673 this.append(value);
1674};
1675
1676jasmine.StringPrettyPrinter.prototype.emitString = function(value) {
1677 this.append("'" + value + "'");
1678};
1679
1680jasmine.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
1691jasmine.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
1715jasmine.StringPrettyPrinter.prototype.append = function(value) {
1716 this.string += value;
1717};
1718jasmine.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
1727jasmine.Queue.prototype.addBefore = function(block) {
1728 this.blocks.unshift(block);
1729};
1730
1731jasmine.Queue.prototype.add = function(block) {
1732 this.blocks.push(block);
1733};
1734
1735jasmine.Queue.prototype.insertNext = function(block) {
1736 this.blocks.splice((this.index + this.offset + 1), 0, block);
1737 this.offset++;
1738};
1739
1740jasmine.Queue.prototype.start = function(onComplete) {
1741 this.running = true;
1742 this.onComplete = onComplete;
1743 this.next_();
1744};
1745
1746jasmine.Queue.prototype.isRunning = function() {
1747 return this.running;
1748};
1749
1750jasmine.Queue.LOOP_DONT_RECURSE = true;
1751
1752jasmine.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
1806jasmine.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 */
1823jasmine.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
1832jasmine.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
1842jasmine.Runner.prototype.beforeEach = function(beforeEachFunction) {
1843 beforeEachFunction.typeName = 'beforeEach';
1844 this.before_.splice(0,0,beforeEachFunction);
1845};
1846
1847jasmine.Runner.prototype.afterEach = function(afterEachFunction) {
1848 afterEachFunction.typeName = 'afterEach';
1849 this.after_.splice(0,0,afterEachFunction);
1850};
1851
1852
1853jasmine.Runner.prototype.finishCallback = function() {
1854 this.env.reporter.reportRunnerResults(this);
1855};
1856
1857jasmine.Runner.prototype.addSuite = function(suite) {
1858 this.suites_.push(suite);
1859};
1860
1861jasmine.Runner.prototype.add = function(block) {
1862 if (block instanceof jasmine.Suite) {
1863 this.addSuite(block);
1864 }
1865 this.queue.add(block);
1866};
1867
1868jasmine.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
1877jasmine.Runner.prototype.suites = function() {
1878 return this.suites_;
1879};
1880
1881jasmine.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
1891jasmine.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 */
1902jasmine.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
1924jasmine.Spec.prototype.getFullName = function() {
1925 return this.suite.getFullName() + ' ' + this.description + '.';
1926};
1927
1928
1929jasmine.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 */
1938jasmine.Spec.prototype.log = function() {
1939 return this.results_.log(arguments);
1940};
1941
1942jasmine.Spec.prototype.runs = function (func) {
1943 var block = new jasmine.Block(this.env, func, this);
1944 this.addToQueue(block);
1945 return this;
1946};
1947
1948jasmine.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 */
1959jasmine.Spec.prototype.addMatcherResult = function(result) {
1960 this.results_.addResult(result);
1961};
1962
1963jasmine.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 */
1975jasmine.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 */
1988jasmine.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
2013jasmine.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
2022jasmine.Spec.prototype.getMatchersClass_ = function() {
2023 return this.matchersClass || this.env.matchersClass;
2024};
2025
2026jasmine.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
2036jasmine.Spec.prototype.finishCallback = function() {
2037 this.env.reporter.reportSpecResults(this);
2038};
2039
2040jasmine.Spec.prototype.finish = function(onComplete) {
2041 this.removeAllSpies();
2042 this.finishCallback();
2043 if (onComplete) {
2044 onComplete();
2045 }
2046};
2047
2048jasmine.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
2056jasmine.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
2075jasmine.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
2100jasmine.Spec.prototype.explodes = function() {
2101 throw 'explodes function should not have been called';
2102};
2103
2104jasmine.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
2129jasmine.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 */
2146jasmine.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
2160jasmine.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
2168jasmine.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
2176jasmine.Suite.prototype.beforeEach = function(beforeEachFunction) {
2177 beforeEachFunction.typeName = 'beforeEach';
2178 this.before_.unshift(beforeEachFunction);
2179};
2180
2181jasmine.Suite.prototype.afterEach = function(afterEachFunction) {
2182 afterEachFunction.typeName = 'afterEach';
2183 this.after_.unshift(afterEachFunction);
2184};
2185
2186jasmine.Suite.prototype.results = function() {
2187 return this.queue.results();
2188};
2189
2190jasmine.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
2201jasmine.Suite.prototype.specs = function() {
2202 return this.specs_;
2203};
2204
2205jasmine.Suite.prototype.suites = function() {
2206 return this.suites_;
2207};
2208
2209jasmine.Suite.prototype.children = function() {
2210 return this.children_;
2211};
2212
2213jasmine.Suite.prototype.execute = function(onComplete) {
2214 var self = this;
2215 this.queue.start(function () {
2216 self.finish(onComplete);
2217 });
2218};
2219jasmine.WaitsBlock = function(env, timeout, spec) {
2220 this.timeout = timeout;
2221 jasmine.Block.call(this, env, null, spec);
2222};
2223
2224jasmine.util.inherit(jasmine.WaitsBlock, jasmine.Block);
2225
2226jasmine.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 */
2245jasmine.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};
2252jasmine.util.inherit(jasmine.WaitsForBlock, jasmine.Block);
2253
2254jasmine.WaitsForBlock.TIMEOUT_INCREMENT = 10;
2255
2256jasmine.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
2291jasmine.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
2317jasmine.FakeTimer.prototype.reset = function() {
2318 this.timeoutsMade = 0;
2319 this.scheduledFunctions = {};
2320 this.nowMillis = 0;
2321};
2322
2323jasmine.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
2330jasmine.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
2365jasmine.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 */
2378jasmine.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};
2436jasmine.Clock.installed = jasmine.Clock.real;
2437
2438//else for IE support
2439jasmine.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
2447jasmine.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
2455jasmine.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
2463jasmine.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
2472jasmine.version_= {
2473 "major": 2,
2474 "minor": 0,
2475 "build": 0,
2476 "revision": 1307766763,
2477 "release_candidate": 1
2478};
2479
Note: See TracBrowser for help on using the repository browser.