describe("jasmine.Matchers", function() { var env, mockSpec; beforeEach(function() { env = new jasmine.Env(); env.updateInterval = 0; mockSpec = jasmine.createSpyObj('spec', ['addMatcherResult']); }); function match(value) { return new env.matchersClass(env, value, mockSpec); } it("toEqual with primitives, objects, dates, html nodes, etc.", function() { expect(match(true).toEqual(true)).toEqual(true); expect(match({foo:'bar'}).toEqual(null)).toEqual(false); var functionA = function() { return 'hi'; }; var functionB = function() { return 'hi'; }; expect(match({foo:functionA}).toEqual({foo:functionB})).toEqual(false); expect(match({foo:functionA}).toEqual({foo:functionA})).toEqual(true); expect((match(false).toEqual(true))).toEqual(false); var circularGraph = {}; circularGraph.referenceToSelf = circularGraph; expect((match(circularGraph).toEqual(circularGraph))).toEqual(true); var nodeA = document.createElement('div'); var nodeB = document.createElement('div'); expect((match(nodeA).toEqual(nodeA))).toEqual(true); expect((match(nodeA).toEqual(nodeB))).toEqual(false); expect((match(new Date(2008, 1, 3, 15, 17, 19, 1234)).toEqual(new Date(2009, 1, 3, 15, 17, 19, 1234)))).toEqual(false); expect((match(new Date(2008, 1, 3, 15, 17, 19, 1234)).toEqual(new Date(2008, 1, 3, 15, 17, 19, 1234)))).toEqual(true); expect(match(true).toNotEqual(false)).toEqual(true); expect((match(true).toNotEqual(true))).toEqual(false); expect((match(['a', 'b']).toEqual(['a', undefined]))).toEqual(false); expect((match(['a', 'b']).toEqual(['a', 'b', undefined]))).toEqual(false); }); it("toEqual to build an Expectation Result", function() { var actual = 'a'; var matcher = match(actual); var expected = 'b'; matcher.toEqual(expected); var result = mockSpec.addMatcherResult.mostRecentCall.args[0]; expect(result.matcherName).toEqual("toEqual"); expect(result.passed()).toEqual(false); expect(result.message).toMatch(jasmine.pp(actual)); expect(result.message).toMatch(jasmine.pp(expected)); expect(result.expected).toEqual(expected); expect(result.actual).toEqual(actual); }); it("toNotEqual to build an Expectation Result", function() { var str = 'a'; var matcher = match(str); matcher.toNotEqual(str); var result = mockSpec.addMatcherResult.mostRecentCall.args[0]; expect(result.matcherName).toEqual("toNotEqual"); expect(result.passed()).toEqual(false); expect(result.message).toMatch(jasmine.pp(str)); expect(result.message).toMatch('not'); expect(result.expected).toEqual(str); expect(result.actual).toEqual(str); }); it('toBe should return true only if the expected and actual items === each other', function() { var a = {}; var b = {}; //noinspection UnnecessaryLocalVariableJS var c = a; expect((match(a).toBe(b))).toEqual(false); expect((match(a).toBe(a))).toEqual(true); expect((match(a).toBe(c))).toEqual(true); expect((match(a).toNotBe(b))).toEqual(true); expect((match(a).toNotBe(a))).toEqual(false); expect((match(a).toNotBe(c))).toEqual(false); }); it("toBe to build an ExpectationResult", function() { var expected = 'b'; var actual = 'a'; var matcher = match(actual); matcher.toBe(expected); var result = mockSpec.addMatcherResult.mostRecentCall.args[0]; expect(result.matcherName).toEqual("toBe"); expect(result.passed()).toEqual(false); expect(result.message).toMatch(jasmine.pp(actual)); expect(result.message).toMatch(jasmine.pp(expected)); expect(result.expected).toEqual(expected); expect(result.actual).toEqual(actual); }); it("toNotBe to build an ExpectationResult", function() { var str = 'a'; var matcher = match(str); matcher.toNotBe(str); var result = mockSpec.addMatcherResult.mostRecentCall.args[0]; expect(result.matcherName).toEqual("toNotBe"); expect(result.passed()).toEqual(false); expect(result.message).toMatch(str); expect(result.expected).toEqual(str); expect(result.actual).toEqual(str); }); it("toMatch and #toNotMatch should perform regular expression matching on strings", function() { expect((match('foobarbel').toMatch(/bar/))).toEqual(true); expect((match('foobazbel').toMatch(/bar/))).toEqual(false); expect((match('foobarbel').toMatch("bar"))).toEqual(true); expect((match('foobazbel').toMatch("bar"))).toEqual(false); expect((match('foobarbel').toNotMatch(/bar/))).toEqual(false); expect((match('foobazbel').toNotMatch(/bar/))).toEqual(true); expect((match('foobarbel').toNotMatch("bar"))).toEqual(false); expect((match('foobazbel').toNotMatch("bar"))).toEqual(true); }); it("toMatch w/ RegExp to build an ExpectationResult", function() { var actual = 'a'; var matcher = match(actual); var expected = /b/; matcher.toMatch(expected); var result = mockSpec.addMatcherResult.mostRecentCall.args[0]; expect(result.matcherName).toEqual("toMatch"); expect(result.passed()).toEqual(false); expect(result.message).toMatch(jasmine.pp(actual)); expect(result.message).toMatch(expected.toString()); expect(result.expected).toEqual(expected); expect(result.actual).toEqual(actual); }); it("toMatch w/ String to build an ExpectationResult", function() { var actual = 'a'; var matcher = match(actual); var expected = 'b'; matcher.toMatch(expected); var result = mockSpec.addMatcherResult.mostRecentCall.args[0]; expect(result.matcherName).toEqual("toMatch"); expect(result.passed()).toEqual(false); expect(result.message).toEqual("Expected 'a' to match 'b'."); expect(result.expected).toEqual(expected); expect(result.actual).toEqual(actual); }); it("toNotMatch w/ RegExp to build an ExpectationResult", function() { var actual = 'a'; var matcher = match(actual); var expected = /a/; matcher.toNotMatch(expected); var result = mockSpec.addMatcherResult.mostRecentCall.args[0]; expect(result.matcherName).toEqual("toNotMatch"); expect(result.passed()).toEqual(false); expect(result.message).toEqual("Expected 'a' to not match /a/."); expect(result.expected).toEqual(expected); expect(result.actual).toEqual(actual); }); it("toNotMatch w/ String to build an ExpectationResult", function() { var str = 'a'; var matcher = match(str); matcher.toNotMatch(str); var result = mockSpec.addMatcherResult.mostRecentCall.args[0]; expect(result.matcherName).toEqual("toNotMatch"); expect(result.passed()).toEqual(false); expect(result.message).toEqual("Expected 'a' to not match 'a'."); expect(result.expected).toEqual(str); expect(result.actual).toEqual(str); }); it("toBeDefined", function() { expect(match('foo').toBeDefined()).toEqual(true); expect(match(undefined).toBeDefined()).toEqual(false); }); it("toBeDefined to build an ExpectationResult", function() { var matcher = match(undefined); matcher.toBeDefined(); var result = mockSpec.addMatcherResult.mostRecentCall.args[0]; expect(result.matcherName).toEqual("toBeDefined"); expect(result.passed()).toEqual(false); expect(result.message).toEqual('Expected undefined to be defined.'); expect(result.actual).toEqual(undefined); }); it("toBeUndefined", function() { expect(match('foo').toBeUndefined()).toEqual(false); expect(match(undefined).toBeUndefined()).toEqual(true); }); it("toBeNull", function() { expect(match(null).toBeNull()).toEqual(true); expect(match(undefined).toBeNull()).toEqual(false); expect(match("foo").toBeNull()).toEqual(false); }); it("toBeNull w/ String to build an ExpectationResult", function() { var actual = 'a'; var matcher = match(actual); matcher.toBeNull(); var result = mockSpec.addMatcherResult.mostRecentCall.args[0]; expect(result.matcherName).toEqual("toBeNull"); expect(result.passed()).toEqual(false); expect(result.message).toMatch(jasmine.pp(actual)); expect(result.message).toMatch('null'); expect(result.actual).toEqual(actual); }); it("toBeNull w/ Object to build an ExpectationResult", function() { var actual = {a: 'b'}; var matcher = match(actual); matcher.toBeNull(); var result = mockSpec.addMatcherResult.mostRecentCall.args[0]; expect(result.matcherName).toEqual("toBeNull"); expect(result.passed()).toEqual(false); expect(result.message).toMatch(jasmine.pp(actual)); expect(result.message).toMatch('null'); expect(result.actual).toEqual(actual); }); it("toBeFalsy", function() { expect(match(false).toBeFalsy()).toEqual(true); expect(match(true).toBeFalsy()).toEqual(false); expect(match(undefined).toBeFalsy()).toEqual(true); expect(match(0).toBeFalsy()).toEqual(true); expect(match("").toBeFalsy()).toEqual(true); }); it("toBeFalsy to build an ExpectationResult", function() { var actual = 'a'; var matcher = match(actual); matcher.toBeFalsy(); var result = mockSpec.addMatcherResult.mostRecentCall.args[0]; expect(result.matcherName).toEqual("toBeFalsy"); expect(result.passed()).toEqual(false); expect(result.message).toMatch(jasmine.pp(actual)); expect(result.message).toMatch('falsy'); expect(result.actual).toEqual(actual); }); it("toBeTruthy", function() { expect(match(false).toBeTruthy()).toEqual(false); expect(match(true).toBeTruthy()).toEqual(true); expect(match(undefined).toBeTruthy()).toEqual(false); expect(match(0).toBeTruthy()).toEqual(false); expect(match("").toBeTruthy()).toEqual(false); expect(match("hi").toBeTruthy()).toEqual(true); expect(match(5).toBeTruthy()).toEqual(true); expect(match({foo: 1}).toBeTruthy()).toEqual(true); }); it("toBeTruthy to build an ExpectationResult", function() { var matcher = match(false); matcher.toBeTruthy(); var result = mockSpec.addMatcherResult.mostRecentCall.args[0]; expect(result.matcherName).toEqual("toBeTruthy"); expect(result.passed()).toEqual(false); expect(result.message).toEqual("Expected false to be truthy."); expect(result.actual).toEqual(false); }); it("toEqual", function() { expect(match(undefined).toEqual(undefined)).toEqual(true); expect(match({foo:'bar'}).toEqual({foo:'bar'})).toEqual(true); expect(match("foo").toEqual({bar: undefined})).toEqual(false); expect(match({foo: undefined}).toEqual("goo")).toEqual(false); expect(match({foo: {bar :undefined}}).toEqual("goo")).toEqual(false); }); it("toEqual with jasmine.any()", function() { expect(match("foo").toEqual(jasmine.any(String))).toEqual(true); expect(match(3).toEqual(jasmine.any(Number))).toEqual(true); expect(match("foo").toEqual(jasmine.any(Function))).toEqual(false); expect(match("foo").toEqual(jasmine.any(Object))).toEqual(false); expect(match({someObj:'foo'}).toEqual(jasmine.any(Object))).toEqual(true); expect(match({someObj:'foo'}).toEqual(jasmine.any(Function))).toEqual(false); expect(match(function() { }).toEqual(jasmine.any(Object))).toEqual(false); expect(match(["foo", "goo"]).toEqual(["foo", jasmine.any(String)])).toEqual(true); expect(match(function() { }).toEqual(jasmine.any(Function))).toEqual(true); expect(match(["a", function() { }]).toEqual(["a", jasmine.any(Function)])).toEqual(true); }); it("toEqual handles circular objects ok", function() { expect(match({foo: "bar", baz: undefined}).toEqual({foo: "bar", baz: undefined})).toEqual(true); expect(match({foo:['bar','baz','quux']}).toEqual({foo:['bar','baz','quux']})).toEqual(true); expect(match({foo: {bar:'baz'}, quux:'corge'}).toEqual({foo:{bar:'baz'}, quux:'corge'})).toEqual(true); var circularObject = {}; var secondCircularObject = {}; circularObject.field = circularObject; secondCircularObject.field = secondCircularObject; expect(match(circularObject).toEqual(secondCircularObject)).toEqual(true); }); it("toNotEqual as slightly surprising behavior, but is it intentional?", function() { expect(match({x:"x", y:"y", z:"w"}).toNotEqual({x:"x", y:"y", z:"z"})).toEqual(true); expect(match({x:"x", y:"y", w:"z"}).toNotEqual({x:"x", y:"y", z:"z"})).toEqual(true); expect(match({x:"x", y:"y", z:"z"}).toNotEqual({w: "w", x:"x", y:"y", z:"z"})).toEqual(true); expect(match({w: "w", x:"x", y:"y", z:"z"}).toNotEqual({x:"x", y:"y", z:"z"})).toEqual(true); }); it("toEqual handles arrays", function() { expect(match([1, "A"]).toEqual([1, "A"])).toEqual(true); }); it("toContain and toNotContain", function() { expect(match('ABC').toContain('A')).toEqual(true); expect(match('ABC').toContain('X')).toEqual(false); expect(match(['A', 'B', 'C']).toContain('A')).toEqual(true); expect(match(['A', 'B', 'C']).toContain('F')).toEqual(false); expect(match(['A', 'B', 'C']).toNotContain('F')).toEqual(true); expect(match(['A', 'B', 'C']).toNotContain('A')).toEqual(false); expect(match(['A', {some:'object'}, 'C']).toContain({some:'object'})).toEqual(true); expect(match(['A', {some:'object'}, 'C']).toContain({some:'other object'})).toEqual(false); }); it("toContain to build an ExpectationResult", function() { var actual = ['a','b','c']; var matcher = match(actual); var expected = 'x'; matcher.toContain(expected); var result = mockSpec.addMatcherResult.mostRecentCall.args[0]; expect(result.matcherName).toEqual("toContain"); expect(result.passed()).toEqual(false); expect(result.message).toMatch(jasmine.pp(actual)); expect(result.message).toMatch('contain'); expect(result.message).toMatch(jasmine.pp(expected)); expect(result.actual).toEqual(actual); expect(result.expected).toEqual(expected); }); it("toNotContain to build an ExpectationResult", function() { var actual = ['a','b','c']; var matcher = match(actual); var expected = 'b'; matcher.toNotContain(expected); var result = mockSpec.addMatcherResult.mostRecentCall.args[0]; expect(result.matcherName).toEqual("toNotContain"); expect(result.passed()).toEqual(false); expect(result.message).toMatch(jasmine.pp(actual)); expect(result.message).toMatch('not contain'); expect(result.message).toMatch(jasmine.pp(expected)); expect(result.actual).toEqual(actual); expect(result.expected).toEqual(expected); }); it("toBeLessThan should pass if actual is less than expected", function() { expect(match(37).toBeLessThan(42)).toEqual(true); expect(match(37).toBeLessThan(-42)).toEqual(false); expect(match(37).toBeLessThan(37)).toEqual(false); }); it("toBeLessThan to build an ExpectationResult", function() { var actual = 3; var matcher = match(actual); var expected = 1; matcher.toBeLessThan(expected); var result = mockSpec.addMatcherResult.mostRecentCall.args[0]; expect(result.matcherName).toEqual("toBeLessThan"); expect(result.passed()).toEqual(false); expect(result.message).toMatch(jasmine.pp(actual) + ' to be less than'); expect(result.message).toMatch(jasmine.pp(expected)); expect(result.actual).toEqual(actual); expect(result.expected).toEqual(expected); }); it("toBeGreaterThan should pass if actual is greater than expected", function() { expect(match(37).toBeGreaterThan(42)).toEqual(false); expect(match(37).toBeGreaterThan(-42)).toEqual(true); expect(match(37).toBeGreaterThan(37)).toEqual(false); }); it("toBeGreaterThan to build an ExpectationResult", function() { var actual = 1; var matcher = match(actual); var expected = 3; matcher.toBeGreaterThan(expected); var result = mockSpec.addMatcherResult.mostRecentCall.args[0]; expect(result.matcherName).toEqual("toBeGreaterThan"); expect(result.passed()).toEqual(false); expect(result.message).toMatch(jasmine.pp(actual) + ' to be greater than'); expect(result.message).toMatch(jasmine.pp(expected)); expect(result.actual).toEqual(actual); expect(result.expected).toEqual(expected); }); it("toThrow", function() { var expected = match(function() { throw new Error("Fake Error"); }); expect(expected.toThrow()).toEqual(true); expect(expected.toThrow("Fake Error")).toEqual(true); expect(expected.toThrow(new Error("Fake Error"))).toEqual(true); expect(expected.toThrow("Other Error")).toEqual(false); var result = mockSpec.addMatcherResult.mostRecentCall.args[0]; expect(result.message).toMatch("Other Error"); expect(expected.toThrow(new Error("Other Error"))).toEqual(false); result = mockSpec.addMatcherResult.mostRecentCall.args[0]; expect(result.message).toMatch("Other Error"); var exception; try { (function () { new jasmine.Matchers(env, 'not-a-function', mockSpec).toThrow(); })(); } catch (e) { exception = e; } expect(exception).toBeDefined(); expect(exception.message).toEqual('Actual is not a function'); expect(match(function() { }).toThrow()).toEqual(false); result = mockSpec.addMatcherResult.mostRecentCall.args[0]; expect(result.message).toEqual('Expected function to throw an exception.'); }); describe("spy matchers >>", function() { var TestClass; beforeEach(function() { TestClass = { normalFunction: function() { }, spyFunction: jasmine.createSpy("My spy") }; }); function shouldThrowAnExceptionWhenInvokedOnANonSpy(methodName) { return function() { expect(function() { match(TestClass.normalFunction)[methodName](); }).toThrow('Expected a spy, but got Function.'); expect(function() { match(undefined)[methodName](); }).toThrow('Expected a spy, but got undefined.'); expect(function() { match({some:'object'})[methodName](); }).toThrow('Expected a spy, but got { some : \'object\' }.'); }; } describe("wasCalled", function() { it("should pass iff the spy was called", function() { expect(match(TestClass.spyFunction).wasCalled()).toEqual(false); TestClass.spyFunction(); expect(match(TestClass.spyFunction).wasCalled()).toEqual(true); }); it("should throw an exception when invoked with any arguments", function() { expect(function() { match(TestClass.normalFunction).wasCalled("unwanted argument"); }).toThrow('wasCalled does not take arguments, use wasCalledWith'); }); it('should throw an exception when invoked on a non-spy', shouldThrowAnExceptionWhenInvokedOnANonSpy('wasCalled')); }); describe("wasNotCalled", function() { it("should pass iff the spy was not called", function() { expect(match(TestClass.spyFunction).wasNotCalled()).toEqual(true); TestClass.spyFunction(); expect(match(TestClass.spyFunction).wasNotCalled()).toEqual(false); }); it("should throw an exception when invoked with any arguments", function() { expect(function() { match(TestClass.normalFunction).wasNotCalled("unwanted argument"); }).toThrow('wasNotCalled does not take arguments'); }); it('should throw an exception when invoked on a non-spy', shouldThrowAnExceptionWhenInvokedOnANonSpy('wasNotCalled')); }); describe("wasCalledWith", function() { it('wasCalledWith should return true if it was called with the expected args', function() { TestClass.spyFunction('a', 'b', 'c'); expect(match(TestClass.spyFunction).wasCalledWith('a', 'b', 'c')).toEqual(true); }); it('should return false if it was not called with the expected args', function() { TestClass.spyFunction('a', 'b', 'c'); var expected = match(TestClass.spyFunction); expect(expected.wasCalledWith('c', 'b', 'a')).toEqual(false); var result = mockSpec.addMatcherResult.mostRecentCall.args[0]; expect(result.passed()).toEqual(false); expect(result.expected).toEqual(['c', 'b', 'a']); expect(result.actual.mostRecentCall.args).toEqual(['a', 'b', 'c']); }); it('should allow matches across multiple calls', function() { var expected = match(TestClass.spyFunction); TestClass.spyFunction('a', 'b', 'c'); TestClass.spyFunction('d', 'e', 'f'); expect(expected.wasCalledWith('a', 'b', 'c')).toEqual(true); expect(expected.wasCalledWith('d', 'e', 'f')).toEqual(true); expect(expected.wasCalledWith('x', 'y', 'z')).toEqual(false); }); it('should throw an exception when invoked on a non-spy', shouldThrowAnExceptionWhenInvokedOnANonSpy('wasCalledWith')); describe("to build an ExpectationResult", function () { beforeEach(function() { var currentSuite; var spec; currentSuite = env.describe('default current suite', function() { spec = env.it(); }, spec); TestClass = { someFunction: function(a, b) { } }; spec.spyOn(TestClass, 'someFunction'); }); it("should should handle the case of a spy", function() { TestClass.someFunction('a', 'c'); var matcher = match(TestClass.someFunction); matcher.wasCalledWith('a', 'b'); var result = mockSpec.addMatcherResult.mostRecentCall.args[0]; expect(result.matcherName).toEqual("wasCalledWith"); expect(result.passed()).toEqual(false); expect(result.message).toMatch("['a', 'b']"); expect(result.message).toMatch("['a', 'c']"); expect(result.actual).toEqual(TestClass.someFunction); expect(result.expected).toEqual(['a','b']); }); }); }); }); });