jasmine.Matchers = function(env, actual, results) { this.env = env; this.actual = actual; this.passing_message = 'Passed.'; this.results_ = results || new jasmine.NestedResults(); }; jasmine.Matchers.pp = function(str) { return jasmine.util.htmlEscape(jasmine.pp(str)); }; /** @deprecated */ jasmine.Matchers.prototype.getResults = function() { return this.results_; }; jasmine.Matchers.prototype.results = function() { return this.results_; }; jasmine.Matchers.prototype.report = function(result, failing_message, details) { this.results_.addResult(new jasmine.ExpectationResult(result, result ? this.passing_message : failing_message, details)); return result; }; /** * Matcher that compares the actual to the expected using ===. * * @param expected */ jasmine.Matchers.prototype.toBe = function(expected) { return this.report(this.actual === expected, 'Expected

' + jasmine.Matchers.pp(expected) + '

to be the same object as

' + jasmine.Matchers.pp(this.actual) + '
'); }; /** * Matcher that compares the actual to the expected using !== * @param expected */ jasmine.Matchers.prototype.toNotBe = function(expected) { return this.report(this.actual !== expected, 'Expected

' + jasmine.Matchers.pp(expected) + '

to be a different object from actual, but they were the same.'); }; /** * Matcher that compares the actual to the expected using common sense equality. Handles Objects, Arrays, etc. * * @param expected */ jasmine.Matchers.prototype.toEqual = function(expected) { var mismatchKeys = []; var mismatchValues = []; var formatMismatches = function(name, array) { if (array.length == 0) return ''; var errorOutput = '

Different ' + name + ':
'; for (var i = 0; i < array.length; i++) { errorOutput += array[i] + '
'; } return errorOutput; }; return this.report(this.env.equals_(this.actual, expected, mismatchKeys, mismatchValues), 'Expected

' + jasmine.Matchers.pp(expected) + '

but got

' + jasmine.Matchers.pp(this.actual) + '
' + formatMismatches('Keys', mismatchKeys) + formatMismatches('Values', mismatchValues), { matcherName: 'toEqual', expected: expected, actual: this.actual }); }; /** @deprecated */ jasmine.Matchers.prototype.should_equal = jasmine.Matchers.prototype.toEqual; /** * Matcher that compares the actual to the expected using the ! of jasmine.Matchers.toEqual * @param expected */ jasmine.Matchers.prototype.toNotEqual = function(expected) { return this.report(!this.env.equals_(this.actual, expected), 'Expected ' + jasmine.Matchers.pp(expected) + ' to not equal ' + jasmine.Matchers.pp(this.actual) + ', but it does.'); }; /** @deprecated */ jasmine.Matchers.prototype.should_not_equal = jasmine.Matchers.prototype.toNotEqual; /** * Matcher that compares the actual to the expected using a regular expression. Constructs a RegExp, so takes * a pattern or a String. * * @param reg_exp */ jasmine.Matchers.prototype.toMatch = function(reg_exp) { return this.report((new RegExp(reg_exp).test(this.actual)), 'Expected ' + jasmine.Matchers.pp(this.actual) + ' to match ' + reg_exp + '.'); }; /** @deprecated */ jasmine.Matchers.prototype.should_match = jasmine.Matchers.prototype.toMatch; /** * Matcher that compares the actual to the expected using the boolean inverse of jasmine.Matchers.toMatch * @param reg_exp */ jasmine.Matchers.prototype.toNotMatch = function(reg_exp) { return this.report((!new RegExp(reg_exp).test(this.actual)), 'Expected ' + jasmine.Matchers.pp(this.actual) + ' to not match ' + reg_exp + '.'); }; /** @deprecated */ jasmine.Matchers.prototype.should_not_match = jasmine.Matchers.prototype.toNotMatch; /** * Matcher that compares the acutal to undefined. */ jasmine.Matchers.prototype.toBeDefined = function() { return this.report((this.actual !== undefined), 'Expected a value to be defined but it was undefined.'); }; /** @deprecated */ jasmine.Matchers.prototype.should_be_defined = jasmine.Matchers.prototype.toBeDefined; /** * Matcher that compares the actual to null. * */ jasmine.Matchers.prototype.toBeNull = function() { return this.report((this.actual === null), 'Expected a value to be null but it was ' + jasmine.Matchers.pp(this.actual) + '.'); }; /** @deprecated */ jasmine.Matchers.prototype.should_be_null = jasmine.Matchers.prototype.toBeNull; /** * Matcher that boolean not-nots the actual. */ jasmine.Matchers.prototype.toBeTruthy = function() { return this.report(!!this.actual, 'Expected a value to be truthy but it was ' + jasmine.Matchers.pp(this.actual) + '.'); }; /** @deprecated */ jasmine.Matchers.prototype.should_be_truthy = jasmine.Matchers.prototype.toBeTruthy; /** * Matcher that boolean nots the actual. */ jasmine.Matchers.prototype.toBeFalsy = function() { return this.report(!this.actual, 'Expected a value to be falsy but it was ' + jasmine.Matchers.pp(this.actual) + '.'); }; /** @deprecated */ jasmine.Matchers.prototype.should_be_falsy = jasmine.Matchers.prototype.toBeFalsy; /** * Matcher that checks to see if the acutal, a Jasmine spy, was called. */ jasmine.Matchers.prototype.wasCalled = function() { if (!this.actual || !this.actual.isSpy) { return this.report(false, 'Expected a spy, but got ' + jasmine.Matchers.pp(this.actual) + '.'); } if (arguments.length > 0) { return this.report(false, 'wasCalled matcher does not take arguments'); } return this.report((this.actual.wasCalled), 'Expected spy "' + this.actual.identity + '" to have been called, but it was not.'); }; /** @deprecated */ jasmine.Matchers.prototype.was_called = jasmine.Matchers.prototype.wasCalled; /** * Matcher that checks to see if the acutal, a Jasmine spy, was not called. */ jasmine.Matchers.prototype.wasNotCalled = function() { if (!this.actual || !this.actual.isSpy) { return this.report(false, 'Expected a spy, but got ' + jasmine.Matchers.pp(this.actual) + '.'); } return this.report((!this.actual.wasCalled), 'Expected spy "' + this.actual.identity + '" to not have been called, but it was.'); }; /** @deprecated */ jasmine.Matchers.prototype.was_not_called = jasmine.Matchers.prototype.wasNotCalled; /** * Matcher that checks to see if the acutal, a Jasmine spy, was called with a set of parameters. * * @example * */ jasmine.Matchers.prototype.wasCalledWith = function() { if (!this.actual || !this.actual.isSpy) { return this.report(false, 'Expected a spy, but got ' + jasmine.Matchers.pp(this.actual) + '.', { matcherName: 'wasCalledWith' }); } var args = jasmine.util.argsToArray(arguments); return this.report(this.env.contains_(this.actual.argsForCall, args), 'Expected ' + jasmine.Matchers.pp(this.actual.argsForCall) + ' to contain ' + jasmine.Matchers.pp(args) + ', but it does not.', { matcherName: 'wasCalledWith', expected: args, actual: this.actual.argsForCall }); }; /** * Matcher that checks that the expected item is an element in the actual Array. * * @param {Object} item */ jasmine.Matchers.prototype.toContain = function(item) { return this.report(this.env.contains_(this.actual, item), 'Expected ' + jasmine.Matchers.pp(this.actual) + ' to contain ' + jasmine.Matchers.pp(item) + ', but it does not.', { matcherName: 'toContain', expected: item, actual: this.actual }); }; /** * Matcher that checks that the expected item is NOT an element in the actual Array. * * @param {Object} item */ jasmine.Matchers.prototype.toNotContain = function(item) { return this.report(!this.env.contains_(this.actual, item), 'Expected ' + jasmine.Matchers.pp(this.actual) + ' not to contain ' + jasmine.Matchers.pp(item) + ', but it does.'); }; jasmine.Matchers.prototype.toBeLessThan = function(expected) { return this.report(this.actual < expected, 'Expected ' + jasmine.Matchers.pp(this.actual) + ' to be less than ' + jasmine.Matchers.pp(expected) + ', but it was not.'); }; jasmine.Matchers.prototype.toBeGreaterThan = function(expected) { return this.report(this.actual > expected, 'Expected ' + jasmine.Matchers.pp(this.actual) + ' to be greater than ' + jasmine.Matchers.pp(expected) + ', but it was not.'); }; /** * Matcher that checks that the expected exception was thrown by the actual. * * @param {String} expectedException */ jasmine.Matchers.prototype.toThrow = function(expectedException) { var exception = null; try { this.actual(); } catch (e) { exception = e; } if (expectedException !== undefined) { if (exception == null) { return this.report(false, "Expected function to throw " + jasmine.Matchers.pp(expectedException) + ", but it did not."); } return this.report( this.env.equals_( exception.message || exception, expectedException.message || expectedException), "Expected function to throw " + jasmine.Matchers.pp(expectedException) + ", but it threw " + jasmine.Matchers.pp(exception) + "."); } else { return this.report(exception != null, "Expected function to throw an exception, but it did not."); } }; jasmine.Matchers.Any = function(expectedClass) { this.expectedClass = expectedClass; }; jasmine.Matchers.Any.prototype.matches = function(other) { if (this.expectedClass == String) { return typeof other == 'string' || other instanceof String; } if (this.expectedClass == Number) { return typeof other == 'number' || other instanceof Number; } if (this.expectedClass == Function) { return typeof other == 'function' || other instanceof Function; } if (this.expectedClass == Object) { return typeof other == 'object'; } return other instanceof this.expectedClass; }; jasmine.Matchers.Any.prototype.toString = function() { return ''; };