jasmine-core 1.3.1 → 2.0.0.rc2

data/lib/jasmine-core/spec/core/CustomMatchersSpec.js

@@ -1,97 +1,96 @@
-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']]);
-  });
-});
+////TODO: matchers should be add-able to the env, not to the spec.
+//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 results = spec.results().getItems();
+//    expect(results[0].message).toEqual("Passed.");
+//    expect(results[1].message).toEqual("Expected false to be true.");
+//  });
+//
+//  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/lib/jasmine-core/spec/core/DelayedFunctionSchedulerSpec.js

@@ -0,0 +1,179 @@
+describe("DelayedFunctionScheduler", function() {
+  it("schedules a function for later execution", function() {
+    var scheduler = new j$.DelayedFunctionScheduler(),
+      fn = jasmine.createSpy('fn');
+
+    scheduler.scheduleFunction(fn, 0);
+
+    expect(fn).not.toHaveBeenCalled();
+
+    scheduler.tick(0);
+
+    expect(fn).toHaveBeenCalled();
+  });
+
+  it("schedules a string for later execution", function() {
+    var scheduler = new j$.DelayedFunctionScheduler(),
+        strfn = "horrible = true;";
+
+    scheduler.scheduleFunction(strfn, 0);
+
+    scheduler.tick(0);
+
+    expect(horrible).toEqual(true);
+  });
+
+  it("#tick defaults to 0", function() {
+    var scheduler = new j$.DelayedFunctionScheduler(),
+      fn = jasmine.createSpy('fn');
+
+    scheduler.scheduleFunction(fn, 0);
+
+    expect(fn).not.toHaveBeenCalled();
+
+    scheduler.tick();
+
+    expect(fn).toHaveBeenCalled();
+  });
+
+  it("defaults delay to 0", function() {
+    var scheduler = new j$.DelayedFunctionScheduler(),
+      fn = jasmine.createSpy('fn');
+
+    scheduler.scheduleFunction(fn);
+
+    expect(fn).not.toHaveBeenCalled();
+
+    scheduler.tick(0);
+
+    expect(fn).toHaveBeenCalled();
+  });
+
+  it("optionally passes params to scheduled functions", function() {
+    var scheduler = new j$.DelayedFunctionScheduler(),
+      fn = jasmine.createSpy('fn');
+
+    scheduler.scheduleFunction(fn, 0, ['foo', 'bar']);
+
+    expect(fn).not.toHaveBeenCalled();
+
+    scheduler.tick(0);
+
+    expect(fn).toHaveBeenCalledWith('foo', 'bar');
+  });
+
+  it("scheduled fns can optionally reoccur", function() {
+    var scheduler = new j$.DelayedFunctionScheduler(),
+      fn = jasmine.createSpy('fn');
+
+    scheduler.scheduleFunction(fn, 20, [], true);
+
+    expect(fn).not.toHaveBeenCalled();
+
+    scheduler.tick(20);
+
+    expect(fn.calls.count()).toBe(1);
+
+    scheduler.tick(40);
+
+    expect(fn.calls.count()).toBe(3);
+
+    scheduler.tick(21);
+
+    expect(fn.calls.count()).toBe(4);
+
+  });
+
+  it("increments scheduled fns ids unless one is passed", function() {
+    var scheduler = new j$.DelayedFunctionScheduler();
+
+    expect(scheduler.scheduleFunction(function() {
+    }, 0)).toBe(1);
+    expect(scheduler.scheduleFunction(function() {
+    }, 0)).toBe(2);
+    expect(scheduler.scheduleFunction(function() {
+    }, 0, [], false, 123)).toBe(123);
+    expect(scheduler.scheduleFunction(function() {
+    }, 0)).toBe(3);
+  });
+
+  it("#removeFunctionWithId removes a previously scheduled function with a given id", function() {
+    var scheduler = new j$.DelayedFunctionScheduler(),
+      fn = jasmine.createSpy('fn'),
+      timeoutKey;
+
+    timeoutKey = scheduler.scheduleFunction(fn, 0);
+
+    expect(fn).not.toHaveBeenCalled();
+
+    scheduler.removeFunctionWithId(timeoutKey);
+
+    scheduler.tick(0);
+
+    expect(fn).not.toHaveBeenCalled();
+  });
+
+  it("reset removes scheduled functions", function() {
+    var scheduler = new j$.DelayedFunctionScheduler(),
+      fn = jasmine.createSpy('fn');
+
+    scheduler.scheduleFunction(fn, 0);
+
+    expect(fn).not.toHaveBeenCalled();
+
+    scheduler.reset();
+
+    scheduler.tick(0);
+
+    expect(fn).not.toHaveBeenCalled();
+  });
+
+  it("reset resets the returned ids", function() {
+    var scheduler = new j$.DelayedFunctionScheduler();
+    expect(scheduler.scheduleFunction(function() { }, 0)).toBe(1);
+    expect(scheduler.scheduleFunction(function() { }, 0, [], false, 123)).toBe(123);
+
+    scheduler.reset();
+    expect(scheduler.scheduleFunction(function() { }, 0)).toBe(1);
+    expect(scheduler.scheduleFunction(function() { }, 0, [], false, 123)).toBe(123);
+  });
+
+  it("reset resets the current tick time", function() {
+    var scheduler = new j$.DelayedFunctionScheduler(),
+      fn = jasmine.createSpy('fn');
+
+    expect(fn).not.toHaveBeenCalled();
+
+    scheduler.tick(15);
+    scheduler.reset();
+
+    scheduler.scheduleFunction(fn, 20, [], false, 1, 20);
+
+    scheduler.tick(5);
+
+    expect(fn).not.toHaveBeenCalled();
+  });
+
+  it("executes recurring functions interleaved with regular functions in the correct order", function() {
+    var scheduler = new j$.DelayedFunctionScheduler(),
+      fn = jasmine.createSpy('fn'),
+      recurringCallCount = 0,
+      recurring = jasmine.createSpy('recurring').and.callFake(function() {
+        recurringCallCount++;
+        if (recurringCallCount < 5) {
+          expect(fn).not.toHaveBeenCalled();
+        }
+      });
+
+    scheduler.scheduleFunction(recurring, 10, [], true);
+    scheduler.scheduleFunction(fn, 50);
+
+    scheduler.tick(60);
+
+    expect(recurring).toHaveBeenCalled();
+    expect(recurring.calls.count()).toBe(6);
+    expect(fn).toHaveBeenCalled();
+  });
+
+});
+

data/lib/jasmine-core/spec/core/EnvSpec.js

@@ -1,12 +1,13 @@
-describe("jasmine.Env", function() {
+// TODO: Fix these unit tests!
+describe("Env", function() {
   var env;
   beforeEach(function() {
-    env = new jasmine.Env();
+    env = new j$.Env();
     env.updateInterval = 0;
   });
 
-  describe('ids', function () {
-    it('nextSpecId should return consecutive integers, starting at 0', function () {
+  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);
@@ -17,143 +18,494 @@ describe("jasmine.Env", function() {
     var fakeReporter;
 
     beforeEach(function() {
-      fakeReporter = jasmine.createSpyObj("fakeReporter", ["log"]);
+      fakeReporter = jasmine.createSpyObj("fakeReporter", ["jasmineStarted"]);
     });
 
-    describe('version', function () {
-      var oldVersion;
+    it("should allow reporters to be registered", function() {
+      env.addReporter(fakeReporter);
+      env.reporter.jasmineStarted();
+      expect(fakeReporter.jasmineStarted).toHaveBeenCalled();
+    });
+  });
+  
+  it('removes all spies when env is executed', function(done) {
+    originalFoo = function() {},
+    testObj = {
+      foo: originalFoo
+    },
+    firstSpec = jasmine.createSpy('firstSpec').and.callFake(function() {
+      env.spyOn(testObj, 'foo');
+    }),
+    secondSpec = jasmine.createSpy('secondSpec').and.callFake(function() {
+      expect(testObj.foo).toBe(originalFoo);
+    });
+    env.describe('test suite', function() {
+      env.it('spec 0', firstSpec);
+      env.it('spec 1', secondSpec);
+    });
 
-      beforeEach(function () {
-        oldVersion = jasmine.version_;
-      });
+    var assertions = function() {
+      expect(firstSpec).toHaveBeenCalled();
+      expect(secondSpec).toHaveBeenCalled();
+      done();
+    };
 
-      afterEach(function () {
-        jasmine.version_ = oldVersion;
-      });
+    env.addReporter({ jasmineDone: assertions });
+
+    env.execute();
+  });
+
+  describe("#spyOn", function() {
+    it("checks for the existance of the object", function() {
+      expect(function() {
+        env.spyOn(void 0, 'pants');
+      }).toThrowError(/could not find an object/);
+    });
+
+    it("checks for the existance of the method", function() {
+      var subject = {};
+
+      expect(function() {
+        env.spyOn(subject, 'pants');
+      }).toThrowError(/method does not exist/);
+    });
+
+    it("checks if it has already been spied upon", function() {
+      var subject = { spiedFunc: function() {} };
+
+      env.spyOn(subject, 'spiedFunc');
+
+      expect(function() {
+        env.spyOn(subject, 'spiedFunc');
+      }).toThrowError(/has already been spied upon/);
+    });
 
-      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("overrides the method on the object and returns the spy", function() {
+      var originalFunctionWasCalled = false;
+      var subject = { spiedFunc: function() { originalFunctionWasCalled = true; } };
+
+      originalFunc = subject.spiedFunc;
+      
+      var spy = env.spyOn(subject, 'spiedFunc');
+
+      expect(subject.spiedFunc).toEqual(spy);
+      
+      expect(subject.spiedFunc.calls.any()).toEqual(false);
+      expect(subject.spiedFunc.calls.count()).toEqual(0);
+
+      subject.spiedFunc('foo');
+
+      expect(subject.spiedFunc.calls.any()).toEqual(true);
+      expect(subject.spiedFunc.calls.count()).toEqual(1);
+      expect(subject.spiedFunc.calls.mostRecent().args).toEqual(['foo']);
+      expect(subject.spiedFunc.calls.mostRecent().object).toEqual(subject);
+      expect(originalFunctionWasCalled).toEqual(false);
+
+      subject.spiedFunc('bar');
+      expect(subject.spiedFunc.calls.count()).toEqual(2);
+      expect(subject.spiedFunc.calls.mostRecent().args).toEqual(['bar']);
+    });
+  });
+
+  describe("#catchException", function() {
+    it("returns true if the exception is a pending spec exception", function() {
+      env.catchExceptions(false);
+
+      expect(env.catchException(new Error(j$.Spec.pendingSpecExceptionMessage))).toBe(true);
+    });
+
+    it("returns false if the exception is not a pending spec exception and not catching exceptions", function() {
+      env.catchExceptions(false);
+
+      expect(env.catchException(new Error("external error"))).toBe(false);
+      expect(env.catchException(new Error(j$.Spec.pendingSpecExceptionMessage))).toBe(true);
+    });
+  });
+
+  describe("#pending", function() {
+    it("throws the Pending Spec exception", function() {
+      expect(function() {
+        env.pending();
+      }).toThrow(j$.Spec.pendingSpecExceptionMessage);
+    });
+  });
+
+});
+
+// TODO: move these into a separate file
+describe("Env integration", function() {
+
+  it("Suites execute as expected (no nesting)", function(done) {
+    var env = new j$.Env(),
+        calls = [];
+
+    var assertions = function() {
+      expect(calls).toEqual([
+        "with a spec",
+        "and another spec"
+      ]);
+
+      done();
+    };
+
+    env.addReporter({ jasmineDone: assertions});
+
+    env.describe("A Suite", function() {
+      env.it("with a spec", function() {
+        calls.push("with a spec");
+      });
+      env.it("and another spec", function() {
+        calls.push("and another spec");
       });
+    });
+
+    env.execute();
+  });
 
-      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
+  it("Nested Suites execute as expected", function(done) {
+    var env = new j$.Env(),
+        calls = [];
+
+    var assertions = function() {
+      expect(calls).toEqual([
+        'an outer spec',
+        'an inner spec',
+        'another inner spec'
+      ]);
+
+      done();
+    };
+
+    env.addReporter({ jasmineDone: assertions });
+
+    env.describe("Outer suite", function() {
+      env.it("an outer spec", function() {
+        calls.push('an outer spec')
+      });
+      env.describe("Inner suite", function() {
+        env.it("an inner spec", function() {
+          calls.push('an inner spec');
+        });
+        env.it("another inner spec", function() {
+          calls.push('another inner spec');
         });
       });
+    });
 
-      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");
-        });
+    env.execute();
+  });
 
-        it("should return a nice string when version is unknown", function() {
-          jasmine.version_ = null;
-          expect(env.versionString()).toEqual("version unknown");
+  it("Multiple top-level Suites execute as expected", function(done) {
+    var env = new j$.Env(),
+        calls = [];
+
+    var assertions = function() {
+      expect(calls).toEqual([
+        'an outer spec',
+        'an inner spec',
+        'another inner spec',
+        'a 2nd outer spec'
+      ]);
+
+      done();
+    };
+
+    env.addReporter({ jasmineDone: assertions });
+
+
+    env.describe("Outer suite", function() {
+      env.it("an outer spec", function() {
+        calls.push('an outer spec')
+      });
+      env.describe("Inner suite", function() {
+        env.it("an inner spec", function() {
+          calls.push('an inner spec');
+        });
+        env.it("another inner spec", function() {
+          calls.push('another inner spec');
         });
       });
     });
 
-    it("should allow reporters to be registered", function() {
-      env.addReporter(fakeReporter);
-      env.reporter.log("message");
-      expect(fakeReporter.log).toHaveBeenCalledWith("message");
+    env.describe("Another outer suite", function() {
+      env.it("a 2nd outer spec", function() {
+        calls.push('a 2nd outer spec')
+      });
     });
+
+    env.execute();
   });
 
-  describe("equality testing", function() {
-    describe("with custom equality testers", function() {
-      var aObj, bObj, isEqual;
+  it("Mock clock can be installed and used in tests", function(done) {
+    var globalSetTimeout = jasmine.createSpy('globalSetTimeout'),
+        delayedFunctionForGlobalClock = jasmine.createSpy('delayedFunctionForGlobalClock'),
+        delayedFunctionForMockClock = jasmine.createSpy('delayedFunctionForMockClock'),
+        env = new j$.Env({global: { setTimeout: globalSetTimeout }});
 
-      beforeEach(function() {
-        env.addEqualityTester(function(a, b) {
-          aObj = a;
-          bObj = b;
-          return isEqual;
-        });
+    var assertions = function() {
+      expect(delayedFunctionForMockClock).toHaveBeenCalled();
+      expect(globalSetTimeout).toHaveBeenCalledWith(delayedFunctionForGlobalClock, 100);
+
+      done();
+    };
+
+    env.addReporter({ jasmineDone: assertions });
+
+    env.describe("tests", function() {
+      env.it("test with mock clock", function() {
+        env.clock.install();
+        env.clock.setTimeout(delayedFunctionForMockClock, 100);
+        env.clock.tick(100);
+      });
+      env.it("test without mock clock", function() {
+        env.clock.setTimeout(delayedFunctionForGlobalClock, 100);
+      });
+    });
+
+    expect(globalSetTimeout).not.toHaveBeenCalled();
+    expect(delayedFunctionForMockClock).not.toHaveBeenCalled();
+
+    env.execute();
+  });
+
+  it("should run async specs in order, waiting for them to complete", function(done) {
+    var env = new j$.Env(), mutatedVar;
+
+    env.describe("tests", function() {
+      env.beforeEach(function() {
+        mutatedVar = 2;
       });
 
-      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");
+      env.it("async spec", function(underTestCallback) {
+        setTimeout(function() {
+          expect(mutatedVar).toEqual(2);
+          underTestCallback();
+          done();
+        }, 0);
       });
 
-      describe("when the custom equality tester returns false", function() {
-        beforeEach(function() {
-          isEqual = false;
-        });
+      env.it("after async spec", function() {
+        mutatedVar = 3;
+      });
+    });
 
-        it("should give custom equality testers precedence", function() {
-          expect(env.equals_('abc', 'abc')).toBeFalsy();
-          var o = {};
-          expect(env.equals_(o, o)).toBeFalsy();
-        });
+    env.execute();
+  });
+
+  describe("with a mock clock", function() {
+      beforeEach(function() {
+          jasmine.getEnv().clock.install();
       });
 
+      afterEach(function() {
+          jasmine.getEnv().clock.uninstall();
+      });
 
-      describe("when the custom equality tester returns true", function() {
-        beforeEach(function() {
-          isEqual = true;
-        });
+      it("should not hang on async specs that forget to call done()", function(done) {
+          var env = new j$.Env(),
+          reporter = jasmine.createSpyObj('fakeReporter', [
+              "jasmineStarted",
+              "jasmineDone",
+              "suiteStarted",
+              "suiteDone",
+              "specStarted",
+              "specDone"
+              ]);
 
-        it("should give custom equality testers precedence", function() {
-          expect(env.equals_('abc', 'def')).toBeTruthy();
-          expect(env.equals_(true, false)).toBeTruthy();
-        });
+          env.addReporter(reporter);
+
+          env.describe("tests", function() {
+              env.it("async spec that will hang", function(underTestCallback) {
+                  env.expect(true).toBeTruthy();
+              });
+
+              env.it("after async spec", function() {
+                  env.expect(true).toBeTruthy();
+              });
+          });
+
+          env.execute();
+
+          reporter.jasmineDone.and.callFake(function() {
+              expect(reporter.jasmineStarted).toHaveBeenCalledWith({
+                  totalSpecsDefined: 2
+              });
+
+              expect(reporter.specDone).toHaveBeenCalledWith(jasmine.objectContaining({status: 'passed'}));
+              expect(reporter.specDone).toHaveBeenCalledWith(jasmine.objectContaining({status: 'failed'}));
+
+              done();
+          });
+
+          jasmine.getEnv().clock.tick(60001);
       });
+  });
 
-      describe("when the custom equality tester returns undefined", function() {
-        beforeEach(function() {
-          isEqual = jasmine.undefined;
-        });
+  // TODO: something is wrong with this spec
+  it("should report as expected", function(done) {
+    var env = new j$.Env(),
+        reporter = jasmine.createSpyObj('fakeReporter', [
+          "jasmineStarted",
+          "jasmineDone",
+          "suiteStarted",
+          "suiteDone",
+          "specStarted",
+          "specDone"
+        ]);
+
+    reporter.jasmineDone.and.callFake(function() {
+      expect(reporter.jasmineStarted).toHaveBeenCalledWith({
+        totalSpecsDefined: 3
+      });
+      var suiteResult = reporter.suiteStarted.calls.first().args[0];
+      expect(suiteResult.description).toEqual("A Suite");
+      expect(reporter.jasmineDone).toHaveBeenCalled();
 
-        it("should use normal equality rules", function() {
-          expect(env.equals_('abc', 'abc')).toBeTruthy();
-          expect(env.equals_('abc', 'def')).toBeFalsy();
+      done();
+    });
+
+    env.addReporter(reporter);
+
+    env.describe("A Suite", function() {
+      env.it("with a top level spec", function() {
+        env.expect(true).toBe(true);
+      });
+      env.describe("with a nested suite", function() {
+        env.xit("with a pending spec", function() {
+          env.expect(true).toBe(true);
+        });
+        env.it("with a spec", function() {
+          env.expect(true).toBe(false);
         });
+      });
+    });
 
-        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; });
-          });
+    env.execute();
+  });
 
-          it("should use normal equality rules", function() {
-            expect(env.equals_('abc', 'abc')).toBeTruthy();
-            expect(env.equals_('abc', 'def')).toBeFalsy();
+  it("should be possible to get full name from a spec", function() {
+    var env = new j$.Env({global: { setTimeout: setTimeout }}),
+        topLevelSpec, nestedSpec, doublyNestedSpec;
+
+    env.describe("my tests", function() {
+      topLevelSpec = env.it("are sometimes top level", function() {
+      });
+      env.describe("are sometimes", function() {
+        nestedSpec = env.it("singly nested", function() {
+        });
+        env.describe("even", function() {
+          doublyNestedSpec = env.it("doubly nested", function() {
           });
         });
       });
+    });
+
+    expect(topLevelSpec.getFullName()).toBe("my tests are sometimes top level.");
+    expect(nestedSpec.getFullName()).toBe("my tests are sometimes singly nested.");
+    expect(doublyNestedSpec.getFullName()).toBe("my tests are sometimes even doubly nested.");
+  });
+
+  it("Custom equality testers should be per spec", function(done) {
+    var env = new j$.Env({global: { setTimeout: setTimeout }}),
+        reporter = jasmine.createSpyObj('fakeReproter', [
+          "jasmineStarted",
+          "jasmineDone",
+          "suiteStarted",
+          "suiteDone",
+          "specStarted",
+          "specDone"
+        ]);
+
+    reporter.jasmineDone.and.callFake(function() {
+      var firstSpecResult = reporter.specDone.calls.first().args[0],
+          secondSpecResult = reporter.specDone.calls.mostRecent().args[0];
 
-      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();
+      expect(firstSpecResult.status).toEqual("passed");
+      expect(secondSpecResult.status).toEqual("failed");
+
+      done();
+    });
+
+    env.addReporter(reporter);
+
+    env.describe("testing custom equality testers", function() {
+      env.it("with a custom tester", function() {
+        env.addCustomEqualityTester(function(a, b) { return true; });
+        env.expect("a").toEqual("b");
+      });
+
+      env.it("without a custom tester", function() {
+        env.expect("a").toEqual("b");
       });
     });
+
+    env.execute();
+  });
+
+  it("Custom matchers should be per spec", function() {
+    var env = new j$.Env({global: { setTimeout: setTimeout }}),
+        matchers = {
+          toFoo: function() {}
+        },
+        reporter = jasmine.createSpyObj('fakeReproter', [
+          "jasmineStarted",
+          "jasmineDone",
+          "suiteStarted",
+          "suiteDone",
+          "specStarted",
+          "specDone"
+        ]);
+
+    env.addReporter(reporter);
+
+    env.describe("testing custom matchers", function() {
+      env.it("with a custom matcher", function() {
+        env.addMatchers(matchers);
+        expect(env.expect().toFoo).toBeDefined();
+      });
+
+      env.it("without a custom matcher", function() {
+        expect(env.expect().toFoo).toBeUndefined();
+      });
+    });
+
+    env.execute();
+  });
+
+  it("Custom equality testers for toContain should be per spec", function(done) {
+    var env = new j$.Env({global: { setTimeout: setTimeout }}),
+        reporter = jasmine.createSpyObj('fakeReproter', [
+          "jasmineStarted",
+          "jasmineDone",
+          "suiteStarted",
+          "suiteDone",
+          "specStarted",
+          "specDone"
+        ]);
+
+    reporter.jasmineDone.and.callFake(function() {
+      var firstSpecResult = reporter.specDone.calls.first().args[0],
+          secondSpecResult = reporter.specDone.calls.mostRecent().args[0];
+
+      expect(firstSpecResult.status).toEqual("passed");
+      expect(secondSpecResult.status).toEqual("failed");
+
+      done();
+    });
+
+    env.addReporter(reporter);
+
+    env.describe("testing custom equality testers", function() {
+      env.it("with a custom tester", function() {
+        env.addCustomEqualityTester(function(a, b) { return true; });
+        env.expect(["a"]).toContain("b");
+      });
+
+      env.it("without a custom tester", function() {
+        env.expect("a").toContain("b");
+      });
+    });
+
+    env.execute();
   });
 });