jasmine-core 1.1.0.rc1

data/spec/core/BaseSpec.js

@@ -0,0 +1,27 @@
+describe("base.js", function() {
+  describe("jasmine.MessageResult", function() {
+    it("#toString should pretty-print and concatenate each part of the message", function() {
+      var values = ["log", "message", 123, {key: "value"}, "FTW!"];
+      var messageResult = new jasmine.MessageResult(values);
+      expect(messageResult.toString()).toEqual("log message 123 { key : 'value' } FTW!");
+    });
+  });
+
+  describe("jasmine.log", function() {
+    it("should accept n arguments", function() {
+      spyOn(jasmine.getEnv().currentSpec, 'log');
+      jasmine.log(1, 2, 3);
+      expect(jasmine.getEnv().currentSpec.log).toHaveBeenCalledWith(1, 2, 3);
+    });
+  });
+
+  describe("jasmine.getGlobal", function() {
+    it("should return the global object", function() {
+      var globalObject = (function() {
+        return this;
+      })();
+
+      expect(jasmine.getGlobal()).toBe(globalObject);
+    });
+  });
+});

data/spec/core/CustomMatchersSpec.js

@@ -0,0 +1,97 @@
+describe("Custom Matchers", function() {
+  var env;
+  var fakeTimer;
+
+  beforeEach(function() {
+    env = new jasmine.Env();
+    env.updateInterval = 0;
+  });
+
+  it("should be easy to add more matchers local to a spec, suite, etc.", function() {
+    var spec1, spec2, spec1Matcher, spec2Matcher;
+    var suite = env.describe('some suite', function() {
+      env.beforeEach(function() {
+        this.addMatchers({
+          matcherForSuite: function(expected) {
+            this.message = "matcherForSuite: actual: " + this.actual + "; expected: " + expected;
+            return true;
+          }
+        });
+      });
+
+      spec1 = env.it('spec with an expectation').runs(function () {
+        this.addMatchers({
+          matcherForSpec: function(expected) {
+            this.message = "matcherForSpec: actual: " + this.actual + "; expected: " + expected;
+            return true;
+          }
+        });
+        spec1Matcher = this.expect("xxx");
+      });
+
+      spec2 = env.it('spec with failing expectation').runs(function () {
+        spec2Matcher = this.expect("yyy");
+      });
+    });
+
+    suite.execute();
+
+    spec1Matcher.matcherForSuite("expected");
+    expect(spec1Matcher.message).toEqual("matcherForSuite: actual: xxx; expected: expected");
+    spec1Matcher.matcherForSpec("expected");
+    expect(spec1Matcher.message).toEqual("matcherForSpec: actual: xxx; expected: expected");
+
+    spec2Matcher.matcherForSuite("expected");
+    expect(spec2Matcher.message).toEqual("matcherForSuite: actual: yyy; expected: expected");
+    expect(spec2Matcher.matcherForSpec).toBe(jasmine.undefined);
+  });
+
+  it("should generate messages with the same rules as for regular matchers when this.report() is not called", function() {
+    var spec;
+    var suite = env.describe('some suite', function() {
+      spec = env.it('spec with an expectation').runs(function () {
+        this.addMatchers({
+          toBeTrue: function() {
+            return this.actual === true;
+          }
+        });
+        this.expect(true).toBeTrue();
+        this.expect(false).toBeTrue();
+      });
+    });
+
+    suite.execute();
+    var passResult = new jasmine.ExpectationResult({passed: true, matcherName: 'toBeTrue',
+      actual: true, expected: jasmine.undefined, message: "Passed." });
+    var failResult = new jasmine.ExpectationResult({passed: false, matcherName: 'toBeTrue',
+      actual: false, expected: jasmine.undefined, message: "Expected false to be true." });
+    failResult.trace = jasmine.any(Object);
+    expect(spec.results().getItems()).toEqual([passResult, failResult]);
+  });
+
+  it("should pass args", function() {
+    var matcherCallArgs = [];
+    var spec;
+    var suite = env.describe('some suite', function() {
+      spec = env.it('spec with an expectation').runs(function () {
+        this.addMatchers({
+          toBeTrue: function() {
+            matcherCallArgs.push(jasmine.util.argsToArray(arguments));
+            return this.actual === true;
+          }
+        });
+        this.expect(true).toBeTrue();
+        this.expect(false).toBeTrue('arg');
+        this.expect(true).toBeTrue('arg1', 'arg2');
+      });
+    });
+
+    suite.execute();
+    var results = spec.results().getItems();
+    expect(results[0].expected).toEqual(jasmine.undefined);
+    expect(results[1].expected).toEqual('arg');
+    expect(results[2].expected).toEqual(['arg1', 'arg2']);
+
+    expect(matcherCallArgs).toEqual([[], ['arg'], ['arg1', 'arg2']]);
+  });
+});

data/spec/core/EnvSpec.js

@@ -0,0 +1,159 @@
+describe("jasmine.Env", function() {
+  var env;
+  beforeEach(function() {
+    env = new jasmine.Env();
+    env.updateInterval = 0;
+  });
+
+  describe('ids', function () {
+    it('nextSpecId should return consecutive integers, starting at 0', function () {
+      expect(env.nextSpecId()).toEqual(0);
+      expect(env.nextSpecId()).toEqual(1);
+      expect(env.nextSpecId()).toEqual(2);
+    });
+  });
+
+  describe("reporting", function() {
+    var fakeReporter;
+
+    beforeEach(function() {
+      fakeReporter = jasmine.createSpyObj("fakeReporter", ["log"]);
+    });
+
+    describe('version', function () {
+      var oldVersion;
+
+      beforeEach(function () {
+        oldVersion = jasmine.version_;
+      });
+
+      afterEach(function () {
+        jasmine.version_ = oldVersion;
+      });
+
+      it('should raise an error if version is not set', function () {
+        jasmine.version_ = null;
+        var exception;
+        try {
+          env.version();
+        }
+        catch (e) {
+          exception = e;
+        }
+        expect(exception.message).toEqual('Version not set');
+      });
+
+      it("version should return the current version as an int", function() {
+        jasmine.version_ = {
+          "major": 1,
+          "minor": 9,
+          "build": 7,
+          "revision": 8
+        };
+        expect(env.version()).toEqual({
+          "major": 1,
+          "minor": 9,
+          "build": 7,
+          "revision": 8
+        });
+      });
+
+      describe("versionString", function() {
+        it("should return a stringified version number", function() {
+          jasmine.version_ = {
+            "major": 1,
+            "minor": 9,
+            "build": 7,
+            "release_candidate": "1",
+            "revision": 8
+          };
+          expect(env.versionString()).toEqual("1.9.7.rc1 revision 8");
+        });
+
+        it("should return a nice string when version is unknown", function() {
+          jasmine.version_ = null;
+          expect(env.versionString()).toEqual("version unknown");
+        });
+      });
+    });
+
+    it("should allow reporters to be registered", function() {
+      env.addReporter(fakeReporter);
+      env.reporter.log("message");
+      expect(fakeReporter.log).toHaveBeenCalledWith("message");
+    });
+  });
+
+  describe("equality testing", function() {
+    describe("with custom equality testers", function() {
+      var aObj, bObj, isEqual;
+
+      beforeEach(function() {
+        env.addEqualityTester(function(a, b) {
+          aObj = a;
+          bObj = b;
+          return isEqual;
+        });
+      });
+
+      it("should call the custom equality tester with two objects for comparison", function() {
+        env.equals_("1", "2");
+        expect(aObj).toEqual("1");
+        expect(bObj).toEqual("2");
+      });
+
+      describe("when the custom equality tester returns false", function() {
+        beforeEach(function() {
+          isEqual = false;
+        });
+
+        it("should give custom equality testers precedence", function() {
+          expect(env.equals_('abc', 'abc')).toBeFalsy();
+          var o = {};
+          expect(env.equals_(o, o)).toBeFalsy();
+        });
+      });
+
+
+      describe("when the custom equality tester returns true", function() {
+        beforeEach(function() {
+          isEqual = true;
+        });
+
+        it("should give custom equality testers precedence", function() {
+          expect(env.equals_('abc', 'def')).toBeTruthy();
+          expect(env.equals_(true, false)).toBeTruthy();
+        });
+      });
+
+      describe("when the custom equality tester returns undefined", function() {
+        beforeEach(function() {
+          isEqual = jasmine.undefined;
+        });
+
+        it("should use normal equality rules", function() {
+          expect(env.equals_('abc', 'abc')).toBeTruthy();
+          expect(env.equals_('abc', 'def')).toBeFalsy();
+        });
+
+        describe("even if there are several", function() {
+          beforeEach(function() {
+            env.addEqualityTester(function(a, b) { return jasmine.undefined; });
+            env.addEqualityTester(function(a, b) { return jasmine.undefined; });
+          });
+
+          it("should use normal equality rules", function() {
+            expect(env.equals_('abc', 'abc')).toBeTruthy();
+            expect(env.equals_('abc', 'def')).toBeFalsy();
+          });
+        });
+      });
+
+      it("should evaluate custom equality testers in the order they are declared", function() {
+        isEqual = false;
+        env.addEqualityTester(function(a, b) { return true; });
+        expect(env.equals_('abc', 'abc')).toBeFalsy();
+      });
+    });
+  });
+});

data/spec/core/ExceptionsSpec.js

@@ -0,0 +1,149 @@
+describe('Exceptions:', function() {
+  var env;
+
+  beforeEach(function() {
+    env = new jasmine.Env();
+    env.updateInterval = 0;
+  });
+
+  it('jasmine.formatException formats Firefox exception messages as expected', function() {
+    var sampleFirefoxException = {
+      fileName: 'foo.js',
+      line: '1978',
+      message: 'you got your foo in my bar',
+      name: 'A Classic Mistake'
+    };
+
+    var expected = 'A Classic Mistake: you got your foo in my bar in foo.js (line 1978)';
+
+    expect(jasmine.util.formatException(sampleFirefoxException)).toEqual(expected);
+  });
+
+  it('jasmine.formatException formats Webkit exception messages as expected', function() {
+    var sampleWebkitException = {
+      sourceURL: 'foo.js',
+      lineNumber: '1978',
+      message: 'you got your foo in my bar',
+      name: 'A Classic Mistake'
+    };
+
+    var expected = 'A Classic Mistake: you got your foo in my bar in foo.js (line 1978)';
+
+    expect(jasmine.util.formatException(sampleWebkitException)).toEqual(expected);
+  });
+
+  it('should handle exceptions thrown, but continue', function() {
+    var fakeTimer = new jasmine.FakeTimer();
+    env.setTimeout = fakeTimer.setTimeout;
+    env.clearTimeout = fakeTimer.clearTimeout;
+    env.setInterval = fakeTimer.setInterval;
+    env.clearInterval = fakeTimer.clearInterval;
+    
+    //we run two exception tests to make sure we continue after throwing an exception
+    var suite = env.describe('Suite for handles exceptions', function () {
+      env.it('should be a test that fails because it throws an exception', function() {
+        throw new Error('fake error 1');
+      });
+
+      env.it('should be another test that fails because it throws an exception', function() {
+        this.runs(function () {
+          throw new Error('fake error 2');
+        });
+        this.runs(function () {
+          this.expect(true).toEqual(true);
+        });
+      });
+
+      env.it('should be a passing test that runs after exceptions are thrown', function() {
+        this.expect(true).toEqual(true);
+      });
+
+      env.it('should be another test that fails because it throws an exception after a wait', function() {
+        this.runs(function () {
+          var foo = 'foo';
+        });
+        this.waits(250);
+        this.runs(function () {
+          throw new Error('fake error 3');
+        });
+      });
+
+      env.it('should be a passing test that runs after exceptions are thrown from a async test', function() {
+        this.expect(true).toEqual(true);
+      });
+    });
+
+    var runner = env.currentRunner();
+    suite.execute();
+    fakeTimer.tick(2500);
+
+    var suiteResults = suite.results();
+    var specResults = suiteResults.getItems();
+
+    expect(suiteResults.passed()).toEqual(false);
+    //
+    expect(specResults.length).toEqual(5);
+    expect(specResults[0].passed()).toMatch(false);
+    var blockResults = specResults[0].getItems();
+    expect(blockResults[0].passed()).toEqual(false);
+    expect(blockResults[0].message).toMatch(/fake error 1/);
+
+    expect(specResults[1].passed()).toEqual(false);
+    blockResults = specResults[1].getItems();
+    expect(blockResults[0].passed()).toEqual(false);
+    expect(blockResults[0].message).toMatch(/fake error 2/);
+    expect(blockResults[1].passed()).toEqual(true);
+
+    expect(specResults[2].passed()).toEqual(true);
+
+    expect(specResults[3].passed()).toEqual(false);
+    blockResults = specResults[3].getItems();
+    expect(blockResults[0].message).toMatch(/fake error 3/);
+
+    expect(specResults[4].passed()).toEqual(true);
+  });
+
+
+  it("should handle exceptions thrown directly in top-level describe blocks and continue", function () {
+     var suite = env.describe("a top level describe block that throws an exception", function () {
+       env.it("is a test that should pass", function () {
+         this.expect(true).toEqual(true);
+       });
+
+       throw new Error("top level error");
+     });
+
+     suite.execute();
+     var suiteResults = suite.results();
+     var specResults = suiteResults.getItems();
+
+     expect(suiteResults.passed()).toEqual(false);
+     expect(specResults.length).toEqual(2);
+
+     expect(specResults[1].description).toMatch(/encountered a declaration exception/);
+   });
+
+   it("should handle exceptions thrown directly in nested describe blocks and continue", function () {
+     var suite = env.describe("a top level describe", function () {
+       env.describe("a mid-level describe that throws an exception", function () {
+         env.it("is a test that should pass", function () {
+           this.expect(true).toEqual(true);
+         });
+
+         throw new Error("a mid-level error");
+       });
+     });
+
+     suite.execute();
+     var suiteResults = suite.results();
+     var specResults = suiteResults.getItems();
+
+     expect(suiteResults.passed()).toEqual(false);
+     expect(specResults.length).toEqual(1);
+
+     var nestedSpecResults = specResults[0].getItems();
+
+     expect(nestedSpecResults.length).toEqual(2);
+     expect(nestedSpecResults[1].description).toMatch(/encountered a declaration exception/);
+   });
+});

data/spec/core/JsApiReporterSpec.js

@@ -0,0 +1,103 @@
+describe('jasmine.jsApiReporter', function() {
+  describe('results', function () {
+    var reporter, spec1, spec2, spec3, expectedSpec1Results, expectedSpec2Results;
+    var env;
+    var suite, nestedSuite, nestedSpec;
+
+    beforeEach(function() {
+      env = new jasmine.Env();
+      env.updateInterval = 0;
+
+      suite = env.describe("top-level suite", function() {
+        spec1 = env.it("spec 1", function() {
+          this.expect(true).toEqual(true);
+
+        });
+
+        spec2 = env.it("spec 2", function() {
+          this.expect(true).toEqual(false);
+        });
+
+        nestedSuite = env.describe("nested suite", function() {
+          nestedSpec = env.it("nested spec", function() {
+            expect(true).toEqual(true);
+          });
+        });
+
+        spec3 = env.it("spec 3", function() {
+          this.log('some debug message');
+        });
+      });
+
+      reporter = new jasmine.JsApiReporter();
+      env.addReporter(reporter);
+
+      env.execute();
+
+      expectedSpec1Results = {
+        messages: spec1.results().getItems(),
+        result: "passed"
+      };
+      expectedSpec2Results = {
+        messages: spec2.results().getItems(),
+        result: "failed"
+      };
+    });
+
+    it('resultForSpec() should return the result for the given spec', function () {
+      expect(reporter.resultsForSpec(spec1.id)).toEqual(expectedSpec1Results);
+      expect(reporter.resultsForSpec(spec2.id)).toEqual(expectedSpec2Results);
+    });
+
+    it('results() should return a hash of all results, indexed by spec id', function () {
+      expect(reporter.results()[spec1.id]).toEqual(expectedSpec1Results);
+      expect(reporter.results()[spec2.id]).toEqual(expectedSpec2Results);
+    });
+
+    it("should return nested suites as children of their parents", function() {
+      expect(reporter.suites()).toEqual([
+        { id: 0, name: 'top-level suite', type: 'suite',
+          children: [
+            { id: 0, name: 'spec 1', type: 'spec', children: [ ] },
+            { id: 1, name: 'spec 2', type: 'spec', children: [ ] },
+            { id: 1, name: 'nested suite', type: 'suite',
+              children: [
+                { id: 2, name: 'nested spec', type: 'spec', children: [ ] }
+              ]
+            },
+            { id: 3, name: 'spec 3', type: 'spec', children: [ ] }
+          ]
+        }
+      ]);
+    });
+
+    describe("#summarizeResult_", function() {
+      it("should summarize a passing result", function() {
+        var result = reporter.results()[spec1.id];
+        var summarizedResult = reporter.summarizeResult_(result);
+        expect(summarizedResult.result).toEqual('passed');
+        expect(summarizedResult.messages.length).toEqual(1);
+        expect(summarizedResult.messages[0].message).toEqual(result.messages[0].message);
+        expect(summarizedResult.messages[0].passed).toBeTruthy();
+        expect(summarizedResult.messages[0].type).toEqual('expect');
+        expect(summarizedResult.messages[0].text).toBeUndefined();
+        expect(summarizedResult.messages[0].trace.stack).toBeUndefined();
+      });
+
+      it("should have a stack trace for failing specs", function() {
+        var result = reporter.results()[spec2.id];
+        var summarizedResult = reporter.summarizeResult_(result);
+        expect(summarizedResult.result).toEqual('failed');
+        expect(summarizedResult.messages[0].trace.stack).toEqual(result.messages[0].trace.stack);
+      });
+
+      it("should have messages for specs with messages", function() {
+        var result = reporter.results()[spec3.id];
+        var summarizedResult = reporter.summarizeResult_(result);
+        expect(summarizedResult.result).toEqual('passed');
+        expect(summarizedResult.messages[0].type).toEqual('log');
+        expect(summarizedResult.messages[0].text).toEqual('some debug message');
+      });
+    });
+  });
+});