chai/chai.js

2981 lines
67 KiB
JavaScript
Raw Normal View History

!function (name, definition) {
if (typeof define == 'function' && typeof define.amd == 'object') define(definition);
else this[name] = definition();
}('chai', function () {
2011-12-07 06:10:58 +00:00
// CommonJS require()
function require(p){
var path = require.resolve(p)
, mod = require.modules[path];
if (!mod) throw new Error('failed to require "' + p + '"');
if (!mod.exports) {
mod.exports = {};
mod.call(mod.exports, mod, mod.exports, require.relative(path));
}
return mod.exports;
}
require.modules = {};
require.resolve = function (path){
var orig = path
, reg = path + '.js'
, index = path + '/index.js';
return require.modules[reg] && reg
|| require.modules[index] && index
|| orig;
};
require.register = function (path, fn){
require.modules[path] = fn;
};
require.relative = function (parent) {
return function(p){
if ('.' != p[0]) return require(p);
var path = parent.split('/')
, segs = p.split('/');
path.pop();
for (var i = 0; i < segs.length; i++) {
var seg = segs[i];
if ('..' == seg) path.pop();
else if ('.' != seg) path.push(seg);
}
return require(path.join('/'));
};
};
require.register("assertion.js", function(module, exports, require){
2011-12-15 13:02:26 +00:00
/*!
* chai
2012-03-18 21:42:08 +00:00
* Copyright(c) 2011-2012 Jake Luer <jake@alogicalparadox.com>
2011-12-15 13:02:26 +00:00
* MIT Licensed
*
* Primarily a refactor of: should.js
* https://github.com/visionmedia/should.js
* Copyright(c) 2011 TJ Holowaychuk <tj@vision-media.ca>
* MIT Licensed
*/
2011-12-07 06:10:58 +00:00
2011-12-16 11:14:47 +00:00
/**
* ### BDD Style Introduction
*
* The BDD style is exposed through `expect` or `should` interfaces. In both
* scenarios, you chain together natural language assertions.
*
* // expect
* var expect = require('chai').expect;
* expect(foo).to.equal('bar');
*
* // should
* var should = require('chai').should();
* foo.should.equal('bar');
*
* #### Differences
*
* The `expect` interface provides a function as a starting point for chaining
2012-02-28 18:00:08 +00:00
* your language assertions. It works on node.js and in all browsers.
2011-12-16 11:14:47 +00:00
*
* The `should` interface extends `Object.prototype` to provide a single getter as
2012-02-28 18:00:08 +00:00
* the starting point for your language assertions. It works on node.js and in
* all browsers except Internet Explorer.
*
* #### Configuration
*
* By default, Chai does not show stack traces upon an AssertionError. This can
* be changed by modifying the `includeStack` parameter for chai.Assertion. For example:
*
* var chai = require('chai');
* chai.Assertion.includeStack = true; // defaults to false
2011-12-16 11:14:47 +00:00
*/
/*!
* Module dependencies.
*/
2012-03-18 21:42:08 +00:00
var AssertionError = require('./browser/error')
2012-02-25 18:43:57 +00:00
, toString = Object.prototype.toString
2012-03-18 21:42:08 +00:00
, util = require('./utils')
2012-04-11 17:31:26 +00:00
, flag = util.flag;
2011-12-07 06:10:58 +00:00
/*!
* Module export.
*/
2011-12-07 06:10:58 +00:00
module.exports = Assertion;
/*!
* # Assertion Constructor
*
* Creates object for chaining.
*
* @api private
*/
function Assertion (obj, msg, stack) {
2012-04-11 17:31:26 +00:00
flag(this, 'ssfi', stack || arguments.callee);
flag(this, 'object', obj);
flag(this, 'message', msg);
2011-12-07 06:10:58 +00:00
}
/*!
* ## Assertion.includeStack
*
* User configurable property, influences whether stack trace
* is included in Assertion error message. Default of false
* suppresses stack trace in the error message
*
* Assertion.includeStack = true; // enable stack on error
*
* @api public
*/
Assertion.includeStack = false;
/*!
2012-03-14 21:01:37 +00:00
* # .assert(expression, message, negateMessage, expected, actual)
*
* Executes an expression and check expectations. Throws AssertionError for reporting if test doesn't pass.
*
* @name assert
* @param {Philosophical} expression to be tested
* @param {String} message to display if fails
* @param {String} negatedMessage to display if negated expression fails
2012-04-11 17:31:26 +00:00
* @param {Mixed} expected value (remember to check for negation)
* @param {Mixed} actual (optional) will default to `this.obj`
* @api private
*/
2012-04-11 17:31:26 +00:00
Assertion.prototype.assert = function (expr, msg, negateMsg, expected, _actual) {
var msg = util.getMessage(this, arguments)
, actual = util.getActual(this, arguments)
, ok = util.test(this, arguments);
2011-12-07 06:10:58 +00:00
if (!ok) {
throw new AssertionError({
2012-04-11 17:31:26 +00:00
message: msg
2012-03-07 16:39:27 +00:00
, actual: actual
, expected: expected
2012-04-11 17:31:26 +00:00
, stackStartFunction: (Assertion.includeStack) ? this.assert : flag(this, 'ssfi')
2011-12-07 06:10:58 +00:00
});
}
};
/**
* # to
*
* Language chain.
*
* @name to
* @api public
*/
2011-12-15 13:02:26 +00:00
Object.defineProperty(Assertion.prototype, 'to',
{ get: function () {
return this;
2012-03-02 00:27:58 +00:00
}
, configurable: true
2011-12-07 06:10:58 +00:00
});
/**
* # be
*
* Language chain.
*
* @name be
* @api public
*/
Object.defineProperty(Assertion.prototype, 'be',
{ get: function () {
return this;
2012-03-02 00:27:58 +00:00
}
, configurable: true
2011-12-07 06:10:58 +00:00
});
2012-02-02 03:04:48 +00:00
/**
* # been
*
2012-02-02 05:56:04 +00:00
* Language chain. Also tests `tense` to past for addon
* modules that use the tense feature.
2012-02-02 03:04:48 +00:00
*
* @name been
* @api public
*/
Object.defineProperty(Assertion.prototype, 'been',
{ get: function () {
2012-04-11 17:31:26 +00:00
flag(this, 'tense', 'past');
2012-02-02 03:04:48 +00:00
return this;
2012-03-02 00:27:58 +00:00
}
, configurable: true
2012-02-02 03:04:48 +00:00
});
/**
2012-04-22 19:27:03 +00:00
* # .a(type)
*
2012-04-22 19:27:03 +00:00
* Assert typeof. Also can be used as a language chain.
*
* expect('test').to.be.a('string');
* expect(foo).to.be.an.instanceof(Foo);
*
2012-04-22 19:27:03 +00:00
* @name a
* @alias an
* @param {String} type
* @api public
*/
2012-04-22 19:27:03 +00:00
var an = function () {
var assert = function(type) {
var obj = flag(this, 'object')
, klass = type.charAt(0).toUpperCase() + type.slice(1);
this.assert(
'[object ' + klass + ']' === toString.call(obj)
, 'expected #{this} to be a ' + type
, 'expected #{this} not to be a ' + type
, '[object ' + klass + ']'
, toString.call(obj)
);
return this;
};
assert.__proto__ = this;
return assert;
};
Object.defineProperty(Assertion.prototype, 'an',
2012-04-22 19:27:03 +00:00
{ get: an
, configurable: true
});
Object.defineProperty(Assertion.prototype, 'a',
{ get: an
2012-03-02 00:27:58 +00:00
, configurable: true
2011-12-07 06:10:58 +00:00
});
2012-04-22 19:27:03 +00:00
/**
* # .include(value)
*
* Assert the inclusion of an object in an Array or substring in string.
* Also toggles the `contain` flag for the `keys` assertion if used as property.
*
* expect([1,2,3]).to.include(2);
*
* @name include
* @alias contain
* @param {Object|String|Number} obj
* @api public
*/
var include = function () {
flag(this, 'contains', true);
var assert = function(val) {
var obj = flag(this, 'object')
this.assert(
~obj.indexOf(val)
, 'expected #{this} to include ' + util.inspect(val)
, 'expected #{this} to not include ' + util.inspect(val));
return this;
};
assert.__proto__ = this;
return assert;
};
Object.defineProperty(Assertion.prototype, 'contain',
{ get: include
, configurable: true
});
Object.defineProperty(Assertion.prototype, 'include',
{ get: include
, configurable: true
});
/**
* # is
*
* Language chain.
*
* @name is
* @api public
*/
Object.defineProperty(Assertion.prototype, 'is',
{ get: function () {
return this;
2012-03-02 00:27:58 +00:00
}
, configurable: true
2011-12-07 06:10:58 +00:00
});
/**
* # and
*
* Language chain.
*
* @name and
* @api public
*/
Object.defineProperty(Assertion.prototype, 'and',
{ get: function () {
return this;
2012-03-02 00:27:58 +00:00
}
, configurable: true
2011-12-07 06:10:58 +00:00
});
/**
* # have
*
* Language chain.
*
* @name have
* @api public
*/
Object.defineProperty(Assertion.prototype, 'have',
{ get: function () {
return this;
2012-03-02 00:27:58 +00:00
}
, configurable: true
2011-12-07 06:10:58 +00:00
});
/**
* # with
*
* Language chain.
*
* @name with
* @api public
*/
2011-12-15 12:07:27 +00:00
Object.defineProperty(Assertion.prototype, 'with',
{ get: function () {
return this;
2012-03-02 00:27:58 +00:00
}
, configurable: true
2011-12-07 06:10:58 +00:00
});
/**
* # .not
*
* Negates any of assertions following in the chain.
*
* @name not
* @api public
*/
Object.defineProperty(Assertion.prototype, 'not',
{ get: function () {
2012-04-11 17:31:26 +00:00
flag(this, 'negate', true);
return this;
2012-03-02 00:27:58 +00:00
}
, configurable: true
2011-12-07 06:10:58 +00:00
});
/**
* # .ok
*
* Assert object truthiness.
*
* expect('everthing').to.be.ok;
* expect(false).to.not.be.ok;
* expect(undefined).to.not.be.ok;
* expect(null).to.not.be.ok;
*
* @name ok
* @api public
*/
Object.defineProperty(Assertion.prototype, 'ok',
{ get: function () {
this.assert(
2012-04-11 17:31:26 +00:00
flag(this, 'object')
, 'expected #{this} to be truthy'
, 'expected #{this} to be falsy');
2011-12-07 06:10:58 +00:00
return this;
2012-03-02 00:27:58 +00:00
}
, configurable: true
2011-12-07 06:10:58 +00:00
});
/**
* # .true
*
* Assert object is true
*
* @name true
* @api public
*/
Object.defineProperty(Assertion.prototype, 'true',
{ get: function () {
this.assert(
2012-04-11 17:31:26 +00:00
true === flag(this, 'object')
, 'expected #{this} to be true'
, 'expected #{this} to be false'
2012-03-02 00:27:58 +00:00
, this.negate ? false : true
);
2011-12-07 06:10:58 +00:00
return this;
2012-03-02 00:27:58 +00:00
}
, configurable: true
2011-12-07 06:10:58 +00:00
});
/**
* # .false
*
* Assert object is false
*
* @name false
* @api public
*/
Object.defineProperty(Assertion.prototype, 'false',
{ get: function () {
this.assert(
2012-04-11 17:31:26 +00:00
false === flag(this, 'object')
, 'expected #{this} to be false'
, 'expected #{this} to be true'
2012-03-02 00:27:58 +00:00
, this.negate ? true : false
);
2011-12-07 06:10:58 +00:00
return this;
2012-03-02 00:27:58 +00:00
}
, configurable: true
2011-12-07 06:10:58 +00:00
});
/**
* # .exist
*
* Assert object exists (null).
*
* var foo = 'hi'
* , bar;
* expect(foo).to.exist;
* expect(bar).to.not.exist;
*
* @name exist
* @api public
*/
Object.defineProperty(Assertion.prototype, 'exist',
{ get: function () {
this.assert(
2012-04-11 17:31:26 +00:00
null != flag(this, 'object')
, 'expected #{this} to exist'
, 'expected #{this} to not exist'
2012-03-02 00:27:58 +00:00
);
2011-12-07 06:10:58 +00:00
return this;
2012-03-02 00:27:58 +00:00
}
, configurable: true
2011-12-07 06:10:58 +00:00
});
/**
* # .empty
*
* Assert object's length to be 0.
*
* expect([]).to.be.empty;
*
* @name empty
* @api public
*/
Object.defineProperty(Assertion.prototype, 'empty',
{ get: function () {
2012-04-11 17:31:26 +00:00
var obj = flag(this, 'object')
, expected = obj;
2012-02-29 19:58:06 +00:00
2012-04-11 17:31:26 +00:00
if (Array.isArray(obj)) {
expected = obj.length;
} else if (typeof obj === 'object') {
expected = Object.keys(obj).length;
2012-02-29 19:58:06 +00:00
}
2011-12-07 06:10:58 +00:00
this.assert(
2012-02-29 19:58:06 +00:00
!expected
2012-04-11 17:31:26 +00:00
, 'expected #{this} to be empty'
, 'expected #{this} not to be empty');
2011-12-07 06:10:58 +00:00
return this;
2012-03-02 00:27:58 +00:00
}
, configurable: true
2011-12-07 06:10:58 +00:00
});
/**
* # .arguments
*
* Assert object is an instanceof arguments.
*
* function test () {
* expect(arguments).to.be.arguments;
* }
*
* @name arguments
* @api public
*/
Object.defineProperty(Assertion.prototype, 'arguments',
{ get: function () {
2012-04-11 17:31:26 +00:00
var obj = flag(this, 'object');
this.assert(
2012-04-11 17:31:26 +00:00
'[object Arguments]' == Object.prototype.toString.call(obj)
, 'expected #{this} to be arguments'
, 'expected #{this} to not be arguments'
2012-03-02 00:27:58 +00:00
, '[object Arguments]'
2012-04-11 17:31:26 +00:00
, Object.prototype.toString.call(obj)
2012-03-02 00:27:58 +00:00
);
return this;
2012-03-02 00:27:58 +00:00
}
, configurable: true
});
/**
* # .equal(value)
*
* Assert strict equality.
*
* expect('hello').to.equal('hello');
*
* @name equal
* @param {*} value
* @api public
*/
2011-12-07 06:10:58 +00:00
Assertion.prototype.equal = function (val) {
this.assert(
2012-04-11 17:31:26 +00:00
val === flag(this, 'object')
, 'expected #{this} to equal #{exp}'
, 'expected #{this} to not equal #{exp}'
2012-03-02 00:27:58 +00:00
, val );
2011-12-07 06:10:58 +00:00
return this;
};
/**
* # .eql(value)
*
* Assert deep equality.
*
* expect({ foo: 'bar' }).to.eql({ foo: 'bar' });
*
* @name eql
* @param {*} value
* @api public
*/
2011-12-07 08:03:47 +00:00
Assertion.prototype.eql = function (obj) {
2011-12-14 20:58:24 +00:00
this.assert(
2012-04-11 17:31:26 +00:00
util.eql(obj, flag(this, 'object'))
, 'expected #{this} to equal #{exp}'
, 'expected #{this} to not equal #{exp}'
2012-03-02 00:27:58 +00:00
, obj );
2011-12-07 08:03:47 +00:00
return this;
};
/**
* # .above(value)
*
* Assert greater than `value`.
*
* expect(10).to.be.above(5);
*
* @name above
* @param {Number} value
* @api public
*/
2011-12-07 06:10:58 +00:00
Assertion.prototype.above = function (val) {
this.assert(
2012-04-11 17:31:26 +00:00
flag(this, 'object') > val
, 'expected #{this} to be above ' + val
, 'expected #{this} to be below ' + val);
2011-12-07 06:10:58 +00:00
return this;
};
/**
* # .below(value)
*
* Assert less than `value`.
*
* expect(5).to.be.below(10);
*
* @name below
* @param {Number} value
* @api public
*/
2011-12-07 06:10:58 +00:00
Assertion.prototype.below = function (val) {
this.assert(
2012-04-11 17:31:26 +00:00
flag(this, 'object') < val
, 'expected #{this} to be below ' + val
, 'expected #{this} to be above ' + val);
2011-12-07 06:10:58 +00:00
return this;
};
/**
* # .within(start, finish)
*
* Assert that a number is within a range.
*
* expect(7).to.be.within(5,10);
*
* @name within
* @param {Number} start lowerbound inclusive
* @param {Number} finish upperbound inclusive
* @api public
*/
Assertion.prototype.within = function (start, finish) {
2012-04-11 17:31:26 +00:00
var obj = flag(this, 'object')
, range = start + '..' + finish;
this.assert(
2012-04-11 17:31:26 +00:00
obj >= start && obj <= finish
, 'expected #{this} to be within ' + range
, 'expected #{this} to not be within ' + range);
return this;
};
/**
* # .instanceof(constructor)
*
* Assert instanceof.
*
* var Tea = function (name) { this.name = name; }
* , Chai = new Tea('chai');
*
* expect(Chai).to.be.an.instanceOf(Tea);
*
* @name instanceof
* @param {Constructor}
2012-01-25 19:07:31 +00:00
* @alias instanceOf
* @api public
*/
2011-12-07 06:10:58 +00:00
Assertion.prototype.instanceof = function (constructor) {
2012-04-22 19:27:03 +00:00
var name = util.getName(constructor);
2011-12-07 06:10:58 +00:00
this.assert(
2012-04-11 17:31:26 +00:00
flag(this, 'object') instanceof constructor
, 'expected #{this} to be an instance of ' + name
, 'expected #{this} to not be an instance of ' + name);
2011-12-07 06:10:58 +00:00
return this;
};
/**
* # .property(name, [value])
*
* Assert that property of `name` exists, optionally with `value`.
*
* var obj = { foo: 'bar' }
* expect(obj).to.have.property('foo');
* expect(obj).to.have.property('foo', 'bar');
* expect(obj).to.have.property('foo').to.be.a('string');
*
* @name property
* @param {String} name
* @param {*} value (optional)
* @returns value of property for chaining
* @api public
*/
2011-12-14 20:58:24 +00:00
Assertion.prototype.property = function (name, val) {
2012-04-11 17:31:26 +00:00
var obj = flag(this, 'object')
, value = util.getPathValue(name, obj)
, negate = flag(this, 'negate');
if (negate && undefined !== val) {
if (undefined === value) {
throw new Error(util.inspect(obj) + ' has no property ' + util.inspect(name));
2011-12-15 12:07:27 +00:00
}
2011-12-14 20:58:24 +00:00
} else {
this.assert(
2012-04-11 17:31:26 +00:00
undefined !== value
, 'expected #{this} to have a property ' + util.inspect(name)
, 'expected #{this} to not have property ' + util.inspect(name));
2011-12-15 12:07:27 +00:00
}
if (undefined !== val) {
this.assert(
2012-04-11 17:31:26 +00:00
val === value
, 'expected #{this} to have a property ' + util.inspect(name) + ' of #{exp}, but got #{act}'
, 'expected #{this} to not have a property ' + util.inspect(name) + ' of #{act}'
2012-03-02 00:27:58 +00:00
, val
2012-04-11 17:31:26 +00:00
, value
2012-03-02 00:27:58 +00:00
);
2011-12-14 20:58:24 +00:00
}
2011-12-07 06:10:58 +00:00
2012-04-11 17:31:26 +00:00
flag(this, 'object', value);
2011-12-07 06:10:58 +00:00
return this;
};
/**
* # .ownProperty(name)
*
* Assert that has own property by `name`.
*
* expect('test').to.have.ownProperty('length');
*
* @name ownProperty
* @alias haveOwnProperty
* @param {String} name
* @api public
*/
2011-12-15 12:07:27 +00:00
Assertion.prototype.ownProperty = function (name) {
2012-04-11 17:31:26 +00:00
var obj = flag(this, 'object');
2011-12-15 12:07:27 +00:00
this.assert(
2012-04-11 17:31:26 +00:00
obj.hasOwnProperty(name)
, 'expected #{this} to have own property ' + util.inspect(name)
, 'expected #{this} to not have own property ' + util.inspect(name));
2011-12-15 12:07:27 +00:00
return this;
};
/**
* # .length(val)
*
* Assert that object has expected length.
*
* expect([1,2,3]).to.have.length(3);
* expect('foobar').to.have.length(6);
*
* @name length
* @alias lengthOf
* @param {Number} length
* @api public
*/
2011-12-07 06:10:58 +00:00
Assertion.prototype.length = function (n) {
2012-04-11 17:31:26 +00:00
var obj = flag(this, 'object');
new Assertion(obj).to.have.property('length');
var len = obj.length;
2011-12-07 06:10:58 +00:00
this.assert(
len == n
2012-04-11 17:31:26 +00:00
, 'expected #{this} to have a length of #{exp} but got #{act}'
, 'expected #{this} to not have a length of #{act}'
2012-03-02 00:27:58 +00:00
, n
, len
);
2011-12-07 06:10:58 +00:00
return this;
};
/**
* # .match(regexp)
*
* Assert that matches regular expression.
*
* expect('foobar').to.match(/^foo/);
*
* @name match
* @param {RegExp} RegularExpression
* @api public
*/
2011-12-07 06:10:58 +00:00
Assertion.prototype.match = function (re) {
2012-04-11 17:31:26 +00:00
var obj = flag(this, 'object');
2011-12-07 06:10:58 +00:00
this.assert(
2012-04-11 17:31:26 +00:00
re.exec(obj)
, 'expected #{this} to match ' + re
, 'expected #{this} not to match ' + re);
2011-12-07 06:10:58 +00:00
return this;
};
/**
* # .string(string)
*
* Assert inclusion of string in string.
*
2012-02-23 05:09:29 +00:00
* expect('foobar').to.have.string('bar');
*
* @name string
* @param {String} string
* @api public
*/
2011-12-15 12:07:27 +00:00
2011-12-07 06:10:58 +00:00
Assertion.prototype.string = function (str) {
2012-04-11 17:31:26 +00:00
var obj = flag(this, 'object');
new Assertion(obj).is.a('string');
2011-12-07 06:10:58 +00:00
this.assert(
2012-04-11 17:31:26 +00:00
~obj.indexOf(str)
, 'expected #{this} to contain ' + util.inspect(str)
, 'expected #{this} to not contain ' + util.inspect(str));
2011-12-07 06:10:58 +00:00
return this;
};
/**
* # .keys(key1, [key2], [...])
*
* Assert exact keys or the inclusing of keys using the `contain` modifier.
*
* expect({ foo: 1, bar: 2 }).to.have.keys(['foo', 'bar']);
2011-12-18 12:02:18 +00:00
* expect({ foo: 1, bar: 2, baz: 3 }).to.contain.keys('foo', 'bar');
*
* @name keys
* @alias key
* @param {String|Array} Keys
* @api public
*/
2011-12-15 12:07:27 +00:00
Assertion.prototype.keys = function(keys) {
2012-04-11 17:31:26 +00:00
var obj = flag(this, 'object')
, str
2011-12-15 12:07:27 +00:00
, ok = true;
keys = keys instanceof Array
? keys
: Array.prototype.slice.call(arguments);
if (!keys.length) throw new Error('keys required');
2012-04-11 17:31:26 +00:00
var actual = Object.keys(obj)
2011-12-15 12:07:27 +00:00
, len = keys.length;
// Inclusion
ok = keys.every(function(key){
return ~actual.indexOf(key);
});
// Strict
2012-04-11 17:31:26 +00:00
if (!flag(this, 'negate') && !flag(this, 'contains')) {
2011-12-15 12:07:27 +00:00
ok = ok && keys.length == actual.length;
}
// Key string
if (len > 1) {
keys = keys.map(function(key){
2012-04-11 17:31:26 +00:00
return util.inspect(key);
2011-12-15 12:07:27 +00:00
});
var last = keys.pop();
str = keys.join(', ') + ', and ' + last;
} else {
2012-04-11 17:31:26 +00:00
str = util.inspect(keys[0]);
2011-12-15 12:07:27 +00:00
}
// Form
str = (len > 1 ? 'keys ' : 'key ') + str;
// Have / include
2012-04-11 17:31:26 +00:00
str = (flag(this, 'contains') ? 'contain ' : 'have ') + str;
2011-12-15 12:07:27 +00:00
// Assertion
this.assert(
ok
2012-04-11 17:31:26 +00:00
, 'expected #{this} to ' + str
, 'expected #{this} to not ' + str
2012-03-02 00:27:58 +00:00
, keys
2012-04-11 17:31:26 +00:00
, Object.keys(obj)
2012-03-02 00:27:58 +00:00
);
2011-12-15 12:07:27 +00:00
return this;
}
/**
* # .throw(constructor)
*
2012-04-11 17:31:26 +00:00
* Assert that a function will throw a specific type of error, or specific type of error
* (as determined using `instanceof`), optionally with a RegExp or string inclusion test
* for the error's message.
*
2012-04-11 17:31:26 +00:00
* var err = new ReferenceError('This is a bad function.');
* var fn = function () { throw err; }
* expect(fn).to.throw(ReferenceError);
2012-04-11 17:31:26 +00:00
* expect(fn).to.throw(Error);
2012-03-07 16:39:27 +00:00
* expect(fn).to.throw(/bad function/);
* expect(fn).to.not.throw('good function');
* expect(fn).to.throw(ReferenceError, /bad function/);
2012-04-11 17:31:26 +00:00
* expect(fn).to.throw(err);
* expect(fn).to.not.throw(new RangeError('Out of range.'));
2012-03-07 16:39:27 +00:00
*
* Please note that when a throw expectation is negated, it will check each
2012-04-11 17:31:26 +00:00
* parameter independently, starting with error constructor type. The appropriate way
2012-03-07 16:39:27 +00:00
* to check for the existence of a type of error but for a message that does not match
* is to use `and`.
*
* expect(fn).to.throw(ReferenceError).and.not.throw(/good function/);
*
* @name throw
* @alias throws
2012-01-30 01:27:13 +00:00
* @alias Throw
* @param {ErrorConstructor} constructor
* @see https://developer.mozilla.org/en/JavaScript/Reference/Global_Objects/Error#Error_types
* @api public
*/
2012-03-07 16:39:27 +00:00
Assertion.prototype.throw = function (constructor, msg) {
2012-04-11 17:31:26 +00:00
var obj = flag(this, 'object');
new Assertion(obj).is.a('function');
2011-12-07 06:10:58 +00:00
2012-04-11 17:31:26 +00:00
var thrown = false
2012-04-22 19:27:03 +00:00
, desiredError = null
, name = null;
2011-12-07 06:10:58 +00:00
2012-03-07 16:39:27 +00:00
if (arguments.length === 0) {
msg = null;
constructor = null;
} else if (constructor && (constructor instanceof RegExp || 'string' === typeof constructor)) {
msg = constructor;
constructor = null;
2012-04-11 17:31:26 +00:00
} else if (constructor && constructor instanceof Error) {
desiredError = constructor;
constructor = null;
msg = null;
2012-04-22 19:27:03 +00:00
} else if (typeof constructor === 'function') {
name = (new constructor()).name;
} else {
constructor = null;
2012-03-07 16:39:27 +00:00
}
2011-12-07 06:10:58 +00:00
try {
2012-04-11 17:31:26 +00:00
obj();
2011-12-07 06:10:58 +00:00
} catch (err) {
2012-04-11 17:31:26 +00:00
// first, check desired error
if (desiredError) {
this.assert(
err === desiredError
, 'expected #{this} to throw ' + util.inspect(desiredError) + ' but ' + util.inspect(err) + ' was thrown'
, 'expected #{this} to not throw ' + util.inspect(desiredError)
);
return this;
}
2012-04-22 19:27:03 +00:00
// next, check constructor
if (constructor) {
2011-12-18 12:02:18 +00:00
this.assert(
2012-04-11 17:31:26 +00:00
err instanceof constructor
, 'expected #{this} to throw ' + name + ' but a ' + err.name + ' was thrown'
, 'expected #{this} to not throw ' + name );
2012-03-07 16:39:27 +00:00
if (!msg) return this;
}
// next, check message
if (err.message && msg && msg instanceof RegExp) {
this.assert(
msg.exec(err.message)
2012-04-11 17:31:26 +00:00
, 'expected #{this} to throw error matching ' + msg + ' but got ' + util.inspect(err.message)
, 'expected #{this} to throw error not matching ' + msg
2012-03-07 16:39:27 +00:00
);
2012-02-07 21:57:49 +00:00
return this;
2012-03-07 16:39:27 +00:00
} else if (err.message && msg && 'string' === typeof msg) {
2012-02-07 21:57:49 +00:00
this.assert(
2012-03-07 16:39:27 +00:00
~err.message.indexOf(msg)
2012-04-11 17:31:26 +00:00
, 'expected #{this} to throw error including #{exp} but got #{act}'
, 'expected #{this} to throw error not including #{act}'
, msg
, err.message
2012-03-07 16:39:27 +00:00
);
2011-12-18 12:02:18 +00:00
return this;
} else {
thrown = true;
}
2011-12-07 06:10:58 +00:00
}
2012-04-22 19:27:03 +00:00
var expectedThrown = name ? name : desiredError ? util.inspect(desiredError) : 'an error';
2011-12-18 12:02:18 +00:00
2011-12-07 06:10:58 +00:00
this.assert(
thrown === true
2012-04-11 17:31:26 +00:00
, 'expected #{this} to throw ' + expectedThrown
, 'expected #{this} to not throw ' + expectedThrown);
2011-12-18 12:02:18 +00:00
return this;
2011-12-07 06:10:58 +00:00
};
2011-12-15 12:07:27 +00:00
2012-02-24 19:55:30 +00:00
/**
* # .respondTo(method)
*
* Assert that object/class will respond to a method.
*
* expect(Klass).to.respondTo('bar');
* expect(obj).to.respondTo('bar');
*
* @name respondTo
* @param {String} method
* @api public
*/
Assertion.prototype.respondTo = function (method) {
2012-04-11 17:31:26 +00:00
var obj = flag(this, 'object')
, context = ('function' === typeof obj)
? obj.prototype[method]
: obj[method];
2012-02-24 19:55:30 +00:00
this.assert(
'function' === typeof context
2012-04-11 17:31:26 +00:00
, 'expected #{this} to respond to ' + util.inspect(method)
, 'expected #{this} to not respond to ' + util.inspect(method)
2012-03-02 00:27:58 +00:00
, 'function'
, typeof context
);
2012-02-24 20:37:14 +00:00
return this;
};
/**
* # .satisfy(method)
*
* Assert that passes a truth test.
*
2012-02-24 20:46:29 +00:00
* expect(1).to.satisfy(function(num) { return num > 0; });
2012-02-24 20:37:14 +00:00
*
* @name satisfy
* @param {Function} matcher
* @api public
*/
Assertion.prototype.satisfy = function (matcher) {
2012-04-11 17:31:26 +00:00
var obj = flag(this, 'object');
2012-02-24 20:37:14 +00:00
this.assert(
2012-04-11 17:31:26 +00:00
matcher(obj)
, 'expected #{this} to satisfy ' + util.inspect(matcher)
, 'expected #{this} to not satisfy' + util.inspect(matcher)
2012-03-02 00:27:58 +00:00
, this.negate ? false : true
2012-04-11 17:31:26 +00:00
, matcher(obj)
2012-03-02 00:27:58 +00:00
);
2012-02-24 19:55:30 +00:00
return this;
};
2012-02-24 22:06:52 +00:00
/**
* # .closeTo(expected, delta)
*
* Assert that actual is equal to +/- delta.
*
* expect(1.5).to.be.closeTo(1, 0.5);
*
* @name closeTo
* @param {Number} expected
* @param {Number} delta
* @api public
*/
Assertion.prototype.closeTo = function (expected, delta) {
2012-04-11 17:31:26 +00:00
var obj = flag(this, 'object');
2012-02-24 22:06:52 +00:00
this.assert(
2012-04-11 17:31:26 +00:00
(obj - delta === expected) || (obj + delta === expected)
, 'expected #{this} to be close to ' + expected + ' +/- ' + delta
, 'expected #{this} not to be close to ' + expected + ' +/- ' + delta);
2012-02-24 22:06:52 +00:00
return this;
};
/*!
2011-12-15 12:07:27 +00:00
* Aliases.
*/
(function alias(name, as){
Assertion.prototype[as] = Assertion.prototype[name];
return alias;
})
('length', 'lengthOf')
('keys', 'key')
('ownProperty', 'haveOwnProperty')
('above', 'greaterThan')
('below', 'lessThan')
2012-01-25 19:07:31 +00:00
('throw', 'throws')
2012-01-30 01:27:13 +00:00
('throw', 'Throw') // for troublesome browsers
2012-01-25 19:07:31 +00:00
('instanceof', 'instanceOf');
2011-12-07 06:10:58 +00:00
}); // module: assertion.js
2012-03-18 21:42:08 +00:00
require.register("browser/error.js", function(module, exports, require){
/*!
* chai
* Copyright(c) 2011-2012 Jake Luer <jake@alogicalparadox.com>
* MIT Licensed
*/
module.exports = AssertionError;
function AssertionError (options) {
options = options || {};
this.message = options.message;
this.actual = options.actual;
this.expected = options.expected;
this.operator = options.operator;
if (options.stackStartFunction && Error.captureStackTrace) {
var stackStartFunction = options.stackStartFunction;
Error.captureStackTrace(this, stackStartFunction);
}
}
2012-04-22 19:27:03 +00:00
AssertionError.prototype = Object.create(Error.prototype);
AssertionError.prototype.name = 'AssertionError';
2012-03-18 21:42:08 +00:00
AssertionError.prototype.constructor = AssertionError;
AssertionError.prototype.toString = function() {
return this.message;
};
}); // module: browser/error.js
2011-12-07 06:10:58 +00:00
require.register("chai.js", function(module, exports, require){
2011-12-15 13:02:26 +00:00
/*!
* chai
2012-02-07 21:09:38 +00:00
* Copyright(c) 2011-2012 Jake Luer <jake@alogicalparadox.com>
2011-12-15 13:02:26 +00:00
* MIT Licensed
*/
2011-12-07 06:10:58 +00:00
2012-03-18 21:42:08 +00:00
var used = []
, exports = module.exports = {};
/*!
* Chai version
*/
2011-12-07 06:10:58 +00:00
2012-03-18 21:47:41 +00:00
exports.version = '0.6.0';
2011-12-07 06:10:58 +00:00
2012-03-18 21:42:08 +00:00
/*!
* Primary `Assertion` prototype
*/
2011-12-07 06:10:58 +00:00
exports.Assertion = require('./assertion');
2011-12-15 12:07:27 +00:00
2012-03-18 21:42:08 +00:00
/*!
* Assertion Error
*/
exports.AssertionError = require('./browser/error');
/*!
* Utils for plugins (not exported)
*/
var util = require('./utils');
/**
* # .use(function)
*
* Provides a way to extend the internals of Chai
*
* @param {Function}
* @returns {this} for chaining
* @api public
*/
2012-01-27 00:14:24 +00:00
exports.use = function (fn) {
2012-02-07 21:09:38 +00:00
if (!~used.indexOf(fn)) {
2012-03-18 21:42:08 +00:00
fn(this, util);
2012-02-07 21:09:38 +00:00
used.push(fn);
}
2012-01-27 00:14:24 +00:00
return this;
};
2012-03-18 21:42:08 +00:00
/*!
* Expect interface
*/
2012-01-27 00:14:24 +00:00
var expect = require('./interface/expect');
exports.use(expect);
2011-12-15 13:02:26 +00:00
/*!
2012-03-18 21:42:08 +00:00
* Should interface
2011-12-15 13:02:26 +00:00
*/
2011-12-07 06:10:58 +00:00
2012-03-18 21:42:08 +00:00
var should = require('./interface/should');
exports.use(should);
2011-12-07 06:10:58 +00:00
2011-12-15 13:02:26 +00:00
/*!
2012-03-18 21:42:08 +00:00
* Assert interface
2011-12-15 13:02:26 +00:00
*/
2011-12-15 12:07:27 +00:00
2012-03-18 21:42:08 +00:00
var assert = require('./interface/assert');
exports.use(assert);
2012-03-02 00:27:58 +00:00
2012-03-18 21:42:08 +00:00
}); // module: chai.js
2011-12-07 06:10:58 +00:00
require.register("interface/assert.js", function(module, exports, require){
2011-12-15 13:02:26 +00:00
/*!
* chai
2012-03-18 21:42:08 +00:00
* Copyright(c) 2011-2012 Jake Luer <jake@alogicalparadox.com>
2011-12-15 13:02:26 +00:00
* MIT Licensed
*/
/**
* ### TDD Style Introduction
*
* The TDD style is exposed through `assert` interfaces. This provides
* the classic assert.`test` notation, similiar to that packaged with
* node.js. This assert module, however, provides several additional
* tests and is browser compatible.
*
* // assert
* var assert = require('chai').assert;
* , foo = 'bar';
*
* assert.typeOf(foo, 'string');
* assert.equal(foo, 'bar');
*
* #### Configuration
*
* By default, Chai does not show stack traces upon an AssertionError. This can
* be changed by modifying the `includeStack` parameter for chai.Assertion. For example:
*
* var chai = require('chai');
* chai.Assertion.includeStack = true; // defaults to false
*/
2012-03-18 21:42:08 +00:00
module.exports = function (chai, util) {
2012-04-11 17:31:26 +00:00
2012-01-27 00:14:24 +00:00
/*!
* Chai dependencies.
*/
2012-04-11 17:31:26 +00:00
2012-01-27 00:14:24 +00:00
var Assertion = chai.Assertion
2012-04-11 17:31:26 +00:00
, flag = util.flag;
2012-01-27 00:14:24 +00:00
/*!
* Module export.
*/
2011-12-07 06:10:58 +00:00
2012-01-27 00:14:24 +00:00
var assert = chai.assert = {};
2012-04-11 17:31:26 +00:00
/**
* # .fail(actual, expect, msg, operator)
*
* Throw a failure. Node.js compatible.
*
* @name fail
* @param {*} actual value
* @param {*} expected value
* @param {String} message
* @param {String} operator
* @api public
*/
assert.fail = function (actual, expected, message, operator) {
throw new chai.AssertionError({
actual: actual
, expected: expected
, message: message
, operator: operator
, stackStartFunction: assert.fail
});
}
2012-01-27 00:14:24 +00:00
/**
* # .ok(object, [message])
*
* Assert object is truthy.
*
* assert.ok('everthing', 'everything is ok');
* assert.ok(false, 'this will fail');
*
* @name ok
* @param {*} object to test
* @param {String} message
* @api public
*/
2012-01-27 00:14:24 +00:00
assert.ok = function (val, msg) {
new Assertion(val, msg).is.ok;
};
2011-12-07 06:10:58 +00:00
2012-01-27 00:14:24 +00:00
/**
* # .equal(actual, expected, [message])
*
* Assert strict equality.
*
* assert.equal(3, 3, 'these numbers are equal');
*
* @name equal
* @param {*} actual
* @param {*} expected
* @param {String} message
* @api public
*/
2012-01-27 00:14:24 +00:00
assert.equal = function (act, exp, msg) {
var test = new Assertion(act, msg);
2012-01-27 00:14:24 +00:00
test.assert(
2012-04-11 17:31:26 +00:00
exp == flag(test, 'object')
, 'expected #{this} to equal #{exp}'
, 'expected #{this} to not equal #{act}'
, exp
, act
);
2012-01-27 00:14:24 +00:00
};
2011-12-07 06:10:58 +00:00
2012-01-27 00:14:24 +00:00
/**
* # .notEqual(actual, expected, [message])
*
* Assert not equal.
*
* assert.notEqual(3, 4, 'these numbers are not equal');
*
* @name notEqual
* @param {*} actual
* @param {*} expected
* @param {String} message
* @api public
*/
2012-01-27 00:14:24 +00:00
assert.notEqual = function (act, exp, msg) {
var test = new Assertion(act, msg);
2012-01-27 00:14:24 +00:00
test.assert(
2012-04-11 17:31:26 +00:00
exp != flag(test, 'object')
, 'expected #{this} to not equal #{exp}'
, 'expected #{this} to equal #{act}'
, exp
, act
);
2012-01-27 00:14:24 +00:00
};
2012-01-27 00:14:24 +00:00
/**
* # .strictEqual(actual, expected, [message])
*
* Assert strict equality.
*
* assert.strictEqual(true, true, 'these booleans are strictly equal');
*
* @name strictEqual
* @param {*} actual
* @param {*} expected
* @param {String} message
* @api public
*/
2012-01-02 06:12:52 +00:00
2012-01-27 00:14:24 +00:00
assert.strictEqual = function (act, exp, msg) {
new Assertion(act, msg).to.equal(exp);
};
2012-01-27 00:14:24 +00:00
/**
* # .notStrictEqual(actual, expected, [message])
*
* Assert strict equality.
*
* assert.notStrictEqual(1, true, 'these booleans are not strictly equal');
*
* @name notStrictEqual
* @param {*} actual
* @param {*} expected
* @param {String} message
* @api public
*/
2012-01-02 06:12:52 +00:00
2012-01-27 00:14:24 +00:00
assert.notStrictEqual = function (act, exp, msg) {
new Assertion(act, msg).to.not.equal(exp);
};
2011-12-07 06:10:58 +00:00
2012-01-27 00:14:24 +00:00
/**
* # .deepEqual(actual, expected, [message])
*
* Assert not deep equality.
*
* assert.deepEqual({ tea: 'green' }, { tea: 'green' });
*
* @name deepEqual
* @param {*} actual
* @param {*} expected
* @param {String} message
* @api public
*/
2012-01-27 00:14:24 +00:00
assert.deepEqual = function (act, exp, msg) {
new Assertion(act, msg).to.eql(exp);
};
2011-12-07 06:10:58 +00:00
2012-01-27 00:14:24 +00:00
/**
* # .notDeepEqual(actual, expected, [message])
*
* Assert not deep equality.
*
* assert.notDeepEqual({ tea: 'green' }, { tea: 'jasmine' });
*
* @name notDeepEqual
* @param {*} actual
* @param {*} expected
* @param {String} message
* @api public
*/
2012-01-27 00:14:24 +00:00
assert.notDeepEqual = function (act, exp, msg) {
new Assertion(act, msg).to.not.eql(exp);
};
2011-12-07 06:10:58 +00:00
2012-01-27 00:14:24 +00:00
/**
* # .isTrue(value, [message])
*
* Assert `value` is true.
*
* var tea_served = true;
* assert.isTrue(tea_served, 'the tea has been served');
*
* @name isTrue
* @param {Boolean} value
* @param {String} message
* @api public
*/
2012-01-27 00:14:24 +00:00
assert.isTrue = function (val, msg) {
new Assertion(val, msg).is.true;
};
2011-12-07 06:10:58 +00:00
2012-01-27 00:14:24 +00:00
/**
* # .isFalse(value, [message])
*
* Assert `value` is false.
*
* var tea_served = false;
* assert.isFalse(tea_served, 'no tea yet? hmm...');
*
* @name isFalse
* @param {Boolean} value
* @param {String} message
* @api public
*/
2012-01-27 00:14:24 +00:00
assert.isFalse = function (val, msg) {
new Assertion(val, msg).is.false;
};
2011-12-07 06:10:58 +00:00
2012-01-27 00:14:24 +00:00
/**
* # .isNull(value, [message])
*
* Assert `value` is null.
*
* assert.isNull(err, 'no errors');
*
* @name isNull
* @param {*} value
* @param {String} message
* @api public
*/
2012-01-27 00:14:24 +00:00
assert.isNull = function (val, msg) {
2012-02-27 20:35:53 +00:00
new Assertion(val, msg).to.equal(null);
2012-01-27 00:14:24 +00:00
};
2011-12-07 06:10:58 +00:00
2012-01-27 00:14:24 +00:00
/**
* # .isNotNull(value, [message])
*
* Assert `value` is not null.
*
* var tea = 'tasty chai';
* assert.isNotNull(tea, 'great, time for tea!');
*
* @name isNotNull
* @param {*} value
* @param {String} message
* @api public
*/
2012-01-27 00:14:24 +00:00
assert.isNotNull = function (val, msg) {
2012-02-27 20:35:53 +00:00
new Assertion(val, msg).to.not.equal(null);
2012-01-27 00:14:24 +00:00
};
2011-12-07 06:10:58 +00:00
2012-01-27 00:14:24 +00:00
/**
* # .isUndefined(value, [message])
*
* Assert `value` is undefined.
*
* assert.isUndefined(tea, 'no tea defined');
*
* @name isUndefined
* @param {*} value
* @param {String} message
* @api public
*/
2012-01-27 00:14:24 +00:00
assert.isUndefined = function (val, msg) {
new Assertion(val, msg).to.equal(undefined);
};
2011-12-07 06:10:58 +00:00
2012-03-14 21:01:37 +00:00
/**
* # .isDefined(value, [message])
*
* Assert `value` is not undefined.
*
* var tea = 'cup of chai';
* assert.isDefined(tea, 'no tea defined');
*
* @name isUndefined
* @param {*} value
* @param {String} message
* @api public
*/
assert.isDefined = function (val, msg) {
new Assertion(val, msg).to.not.equal(undefined);
};
2012-01-27 00:14:24 +00:00
/**
* # .isFunction(value, [message])
*
* Assert `value` is a function.
*
* var serve_tea = function () { return 'cup of tea'; };
* assert.isFunction(serve_tea, 'great, we can have tea now');
*
* @name isFunction
* @param {Function} value
* @param {String} message
* @api public
*/
2011-12-07 06:10:58 +00:00
2012-01-27 00:14:24 +00:00
assert.isFunction = function (val, msg) {
new Assertion(val, msg).to.be.a('function');
};
2011-12-07 06:10:58 +00:00
2012-04-11 17:31:26 +00:00
/**
* # .isNotFunction(value, [message])
*
* Assert `value` is NOT a function.
*
* var serve_tea = [ 'heat', 'pour', 'sip' ];
* assert.isNotFunction(serve_tea, 'great, we can have tea now');
*
* @name isNotFunction
* @param {Mixed} value
* @param {String} message
* @api public
*/
assert.isNotFunction = function (val, msg) {
new Assertion(val, msg).to.not.be.a('function');
};
2012-01-27 00:14:24 +00:00
/**
* # .isObject(value, [message])
*
* Assert `value` is an object.
*
* var selection = { name: 'Chai', serve: 'with spices' };
* assert.isObject(selection, 'tea selection is an object');
*
* @name isObject
* @param {Object} value
* @param {String} message
* @api public
*/
2012-01-27 00:14:24 +00:00
assert.isObject = function (val, msg) {
new Assertion(val, msg).to.be.a('object');
};
2011-12-07 06:10:58 +00:00
2012-04-11 17:31:26 +00:00
/**
* # .isNotObject(value, [message])
*
* Assert `value` is NOT an object.
*
* var selection = 'chai'
* assert.isObject(selection, 'tea selection is not an object');
*
* @name isNotObject
* @param {Mixed} value
* @param {String} message
* @api public
*/
assert.isNotObject = function (val, msg) {
new Assertion(val, msg).to.not.be.a('object');
};
2012-01-27 00:14:24 +00:00
/**
* # .isArray(value, [message])
*
* Assert `value` is an instance of Array.
*
* var menu = [ 'green', 'chai', 'oolong' ];
* assert.isArray(menu, 'what kind of tea do we want?');
*
* @name isArray
2012-04-11 17:31:26 +00:00
* @param {Mixed} value
2012-01-27 00:14:24 +00:00
* @param {String} message
* @api public
*/
2011-12-07 06:10:58 +00:00
2012-01-27 00:14:24 +00:00
assert.isArray = function (val, msg) {
new Assertion(val, msg).to.be.instanceof(Array);
};
2011-12-07 06:10:58 +00:00
2012-04-11 17:31:26 +00:00
/**
* # .isArray(value, [message])
*
* Assert `value` is NOT an instance of Array.
*
* var menu = 'green|chai|oolong';
* assert.isNotArray(menu, 'what kind of tea do we want?');
*
* @name isNotArray
* @param {Mixed} value
* @param {String} message
* @api public
*/
assert.isNotArray = function (val, msg) {
new Assertion(val, msg).to.not.be.instanceof(Array);
};
2012-01-27 00:14:24 +00:00
/**
* # .isString(value, [message])
*
* Assert `value` is a string.
*
* var teaorder = 'chai';
* assert.isString(tea_order, 'order placed');
*
* @name isString
* @param {String} value
* @param {String} message
* @api public
*/
2012-01-27 00:14:24 +00:00
assert.isString = function (val, msg) {
new Assertion(val, msg).to.be.a('string');
};
2012-04-11 17:31:26 +00:00
/**
* # .isNotString(value, [message])
*
* Assert `value` is NOT a string.
*
* var teaorder = 4;
* assert.isNotString(tea_order, 'order placed');
*
* @name isNotString
* @param {Mixed} value
* @param {String} message
* @api public
*/
assert.isNotString = function (val, msg) {
new Assertion(val, msg).to.not.be.a('string');
};
2012-01-27 00:14:24 +00:00
/**
* # .isNumber(value, [message])
*
* Assert `value` is a number
*
* var cups = 2;
* assert.isNumber(cups, 'how many cups');
*
* @name isNumber
* @param {Number} value
* @param {String} message
* @api public
*/
2012-01-27 00:14:24 +00:00
assert.isNumber = function (val, msg) {
2012-02-27 20:35:53 +00:00
new Assertion(val, msg).to.be.a('number');
2012-01-27 00:14:24 +00:00
};
2011-12-07 06:10:58 +00:00
2012-04-11 17:31:26 +00:00
/**
* # .isNotNumber(value, [message])
*
* Assert `value` NOT is a number
*
* var cups = '2 cups please';
* assert.isNotNumber(cups, 'how many cups');
*
* @name isNotNumber
* @param {Mixed} value
* @param {String} message
* @api public
*/
assert.isNotNumber = function (val, msg) {
new Assertion(val, msg).to.not.be.a('number');
};
2012-01-27 00:14:24 +00:00
/**
* # .isBoolean(value, [message])
*
* Assert `value` is a boolean
*
* var teaready = true
* , teaserved = false;
*
* assert.isBoolean(tea_ready, 'is the tea ready');
* assert.isBoolean(tea_served, 'has tea been served');
*
* @name isBoolean
2012-04-11 17:31:26 +00:00
* @param {Mixed} value
2012-01-27 00:14:24 +00:00
* @param {String} message
* @api public
*/
2012-01-27 00:14:24 +00:00
assert.isBoolean = function (val, msg) {
new Assertion(val, msg).to.be.a('boolean');
};
2011-12-07 06:10:58 +00:00
2012-04-11 17:31:26 +00:00
/**
* # .isNotBoolean(value, [message])
*
* Assert `value` is NOT a boolean
*
* var teaready = 'yep'
* , teaserved = 'nope';
*
* assert.isNotBoolean(tea_ready, 'is the tea ready');
* assert.isNotBoolean(tea_served, 'has tea been served');
*
* @name isNotBoolean
* @param {Mixed} value
* @param {String} message
* @api public
*/
assert.isNotBoolean = function (val, msg) {
new Assertion(val, msg).to.not.be.a('boolean');
};
2012-01-27 00:14:24 +00:00
/**
* # .typeOf(value, name, [message])
*
* Assert typeof `value` is `name`.
*
* assert.typeOf('tea', 'string', 'we have a string');
*
* @name typeOf
2012-04-11 17:31:26 +00:00
* @param {Mixed} value
2012-01-27 00:14:24 +00:00
* @param {String} typeof name
* @param {String} message
* @api public
*/
2012-01-27 00:14:24 +00:00
assert.typeOf = function (val, type, msg) {
new Assertion(val, msg).to.be.a(type);
};
2011-12-07 06:10:58 +00:00
2012-04-11 17:31:26 +00:00
/**
* # .notTypeOf(value, name, [message])
*
* Assert typeof `value` is NOT `name`.
*
* assert.notTypeOf('tea', 'string', 'we have a string');
*
* @name notTypeOf
* @param {Mixed} value
* @param {String} typeof name
* @param {String} message
* @api public
*/
assert.notTypeOf = function (val, type, msg) {
new Assertion(val, msg).to.not.be.a(type);
};
2012-01-27 00:14:24 +00:00
/**
* # .instanceOf(object, constructor, [message])
*
* Assert `value` is instanceof `constructor`.
*
* var Tea = function (name) { this.name = name; }
* , Chai = new Tea('chai');
*
* assert.instanceOf(Chai, Tea, 'chai is an instance of tea');
*
* @name instanceOf
* @param {Object} object
* @param {Constructor} constructor
* @param {String} message
* @api public
*/
2012-01-27 00:14:24 +00:00
assert.instanceOf = function (val, type, msg) {
new Assertion(val, msg).to.be.instanceof(type);
};
2011-12-07 06:10:58 +00:00
2012-04-11 17:31:26 +00:00
/**
* # .notInstanceOf(object, constructor, [message])
*
* Assert `value` is NOT instanceof `constructor`.
*
* var Tea = function (name) { this.name = name; }
* , Chai = new String('chai');
*
* assert.notInstanceOf(Chai, Tea, 'chai is an instance of tea');
*
* @name notInstanceOf
* @param {Object} object
* @param {Constructor} constructor
* @param {String} message
* @api public
*/
assert.notInstanceOf = function (val, type, msg) {
new Assertion(val, msg).to.not.be.instanceof(type);
};
2012-01-27 00:14:24 +00:00
/**
* # .include(value, includes, [message])
*
* Assert the inclusion of an object in another. Works
* for strings and arrays.
*
* assert.include('foobar', 'bar', 'foobar contains string `var`);
* assert.include([ 1, 2, 3], 3, 'array contains value);
*
* @name include
* @param {Array|String} value
* @param {*} includes
* @param {String} message
* @api public
*/
2012-01-27 00:14:24 +00:00
assert.include = function (exp, inc, msg) {
var obj = new Assertion(exp, msg);
2012-01-27 00:14:24 +00:00
if (Array.isArray(exp)) {
obj.to.include(inc);
} else if ('string' === typeof exp) {
obj.to.contain.string(inc);
}
};
2011-12-07 06:10:58 +00:00
2012-01-27 00:14:24 +00:00
/**
* # .match(value, regex, [message])
*
* Assert that `value` matches regular expression.
*
* assert.match('foobar', /^foo/, 'Regexp matches');
*
* @name match
* @param {*} value
* @param {RegExp} RegularExpression
* @param {String} message
* @api public
*/
2012-01-27 00:14:24 +00:00
assert.match = function (exp, re, msg) {
new Assertion(exp, msg).to.match(re);
};
2011-12-07 06:10:58 +00:00
2012-01-27 00:14:24 +00:00
/**
2012-04-11 17:31:26 +00:00
* # .length(object, length, [message])
2012-01-27 00:14:24 +00:00
*
* Assert that object has expected length.
*
* assert.length([1,2,3], 3, 'Array has length of 3');
* assert.length('foobar', 5, 'String has length of 6');
*
* @name length
* @param {*} value
* @param {Number} length
* @param {String} message
* @api public
*/
2012-01-27 00:14:24 +00:00
assert.length = function (exp, len, msg) {
new Assertion(exp, msg).to.have.length(len);
};
2011-12-07 06:10:58 +00:00
2012-01-27 00:14:24 +00:00
/**
2012-02-10 16:32:44 +00:00
* # .throws(function, [constructor/regexp], [message])
2012-01-27 00:14:24 +00:00
*
* Assert that a function will throw a specific
* type of error.
*
* assert.throw(fn, ReferenceError, 'function throw reference error');
*
* @name throws
* @alias throw
* @param {Function} function to test
* @param {ErrorConstructor} constructor
* @param {String} message
* @see https://developer.mozilla.org/en/JavaScript/Reference/Global_Objects/Error#Error_types
* @api public
*/
2012-01-27 00:14:24 +00:00
assert.throws = function (fn, type, msg) {
if ('string' === typeof type) {
msg = type;
type = null;
}
2012-01-27 00:14:24 +00:00
new Assertion(fn, msg).to.throw(type);
};
2012-01-27 00:14:24 +00:00
/**
2012-02-10 16:32:44 +00:00
* # .doesNotThrow(function, [constructor/regexp], [message])
2012-01-27 00:14:24 +00:00
*
* Assert that a function will throw a specific
* type of error.
*
* var fn = function (err) { if (err) throw Error(err) };
* assert.doesNotThrow(fn, Error, 'function throw reference error');
*
* @name doesNotThrow
* @param {Function} function to test
* @param {ErrorConstructor} constructor
* @param {String} message
* @see https://developer.mozilla.org/en/JavaScript/Reference/Global_Objects/Error#Error_types
* @api public
*/
2012-01-02 06:12:52 +00:00
2012-01-27 00:14:24 +00:00
assert.doesNotThrow = function (fn, type, msg) {
if ('string' === typeof type) {
msg = type;
type = null;
}
2012-01-27 00:14:24 +00:00
new Assertion(fn, msg).to.not.throw(type);
};
2012-03-02 13:49:25 +00:00
/**
* # .operator(val, operator, val2, [message])
*
* Compare two values using operator.
*
* assert.operator(1, '<', 2, 'everything is ok');
* assert.operator(1, '>', 2, 'this will fail');
*
* @name operator
* @param {*} object to test
* @param {String} operator
* @param {*} second object
* @param {String} message
* @api public
*/
assert.operator = function (val, operator, val2, msg) {
if (!~['==', '===', '>', '>=', '<', '<=', '!=', '!=='].indexOf(operator)) {
throw new Error('Invalid operator "' + operator + '"');
}
2012-04-11 17:31:26 +00:00
var test = new Assertion(eval(val + operator + val2), msg);
test.assert(
true === flag(test, 'object')
, 'expected ' + util.inspect(val) + ' to be ' + operator + ' ' + util.inspect(val2)
, 'expected ' + util.inspect(val) + ' to not be ' + operator + ' ' + util.inspect(val2) );
2012-03-02 13:49:25 +00:00
};
2012-01-27 00:14:24 +00:00
/*!
* Undocumented / untested
*/
2012-01-02 06:12:52 +00:00
2012-01-27 00:14:24 +00:00
assert.ifError = function (val, msg) {
new Assertion(val, msg).to.not.be.ok;
};
2012-01-27 00:14:24 +00:00
/*!
* Aliases.
*/
2012-01-27 00:14:24 +00:00
(function alias(name, as){
assert[as] = assert[name];
return alias;
})
('length', 'lengthOf')
('throws', 'throw');
};
2012-01-25 19:07:31 +00:00
2011-12-07 06:10:58 +00:00
}); // module: interface/assert.js
2011-12-14 20:58:24 +00:00
2011-12-15 13:02:26 +00:00
require.register("interface/expect.js", function(module, exports, require){
/*!
* chai
2012-03-18 21:42:08 +00:00
* Copyright(c) 2011-2012 Jake Luer <jake@alogicalparadox.com>
2011-12-15 13:02:26 +00:00
* MIT Licensed
*/
2011-12-15 12:07:27 +00:00
2012-03-18 21:42:08 +00:00
module.exports = function (chai, util) {
2012-01-27 00:14:24 +00:00
chai.expect = function (val, message) {
return new chai.Assertion(val, message);
};
2011-12-15 13:02:26 +00:00
};
2012-01-27 00:14:24 +00:00
2011-12-15 13:02:26 +00:00
}); // module: interface/expect.js
require.register("interface/should.js", function(module, exports, require){
2011-12-15 12:07:27 +00:00
/*!
2011-12-15 13:02:26 +00:00
* chai
2012-03-18 21:42:08 +00:00
* Copyright(c) 2011-2012 Jake Luer <jake@alogicalparadox.com>
2011-12-15 12:07:27 +00:00
* MIT Licensed
*/
2012-03-18 21:42:08 +00:00
module.exports = function (chai, util) {
2012-01-27 00:14:24 +00:00
var Assertion = chai.Assertion;
chai.should = function () {
// modify Object.prototype to have `should`
Object.defineProperty(Object.prototype, 'should', {
set: function(){},
get: function(){
if (this instanceof String || this instanceof Number) {
return new Assertion(this.constructor(this));
} else if (this instanceof Boolean) {
return new Assertion(this == true);
}
return new Assertion(this);
},
configurable: true
});
2011-12-15 12:07:27 +00:00
2012-01-27 00:14:24 +00:00
var should = {};
2011-12-15 13:02:26 +00:00
2012-01-27 00:14:24 +00:00
should.equal = function (val1, val2) {
new Assertion(val1).to.equal(val2);
};
2011-12-15 13:02:26 +00:00
2012-03-07 16:39:27 +00:00
should.throw = function (fn, errt, errs) {
new Assertion(fn).to.throw(errt, errs);
2012-01-27 00:14:24 +00:00
};
2011-12-15 13:02:26 +00:00
2012-01-27 00:14:24 +00:00
should.exist = function (val) {
new Assertion(val).to.exist;
}
2011-12-15 13:02:26 +00:00
2012-01-27 00:14:24 +00:00
// negation
should.not = {}
2011-12-18 12:02:18 +00:00
2012-01-27 00:14:24 +00:00
should.not.equal = function (val1, val2) {
new Assertion(val1).to.not.equal(val2);
};
2012-01-02 05:50:47 +00:00
2012-03-07 16:39:27 +00:00
should.not.throw = function (fn, errt, errs) {
new Assertion(fn).to.not.throw(errt, errs);
2012-01-27 00:14:24 +00:00
};
2011-12-18 12:02:18 +00:00
2012-01-27 00:14:24 +00:00
should.not.exist = function (val) {
new Assertion(val).to.not.exist;
}
2011-12-18 12:02:18 +00:00
2012-01-27 00:14:24 +00:00
return should;
2011-12-18 12:02:18 +00:00
};
2011-12-15 12:07:27 +00:00
};
2012-01-25 21:29:26 +00:00
2011-12-15 12:07:27 +00:00
}); // module: interface/should.js
2012-04-22 19:27:03 +00:00
require.register("utils/addMethod.js", function(module, exports, require){
/*!
* Chai - addMethod utility
* Copyright(c) 2012 Jake Luer <jake@alogicalparadox.com>
* MIT Licensed
*/
/**
* # addMethod (ctx, name, method)
*
* Adds a method to the prototype of an object.
*
* utils.addMethod(chai.Assertion, 'foo', function (str) {
* var obj = utils.flag(this, 'object');
* new chai.Assertion(obj).to.be.equal(str);
* return this;
* });
*
* Then can be used as any other assertion.
*
* expect(fooStr).to.be.foo('bar');
*
* @param {Function|Object} context chai.Assertion || chai.Assertion.prototype
* @param {String} name of method to add
* @param {Function} method function to used for name
* @api public
*/
module.exports = function (ctx, name, method) {
var context = ('function' === typeof obj) ? ctx.prototype : ctx;
context[name] = function () {
method.apply(this, arguments);
return this;
};
};
}); // module: utils/addMethod.js
require.register("utils/addProperty.js", function(module, exports, require){
/*!
* Chai - addProperty utility
* Copyright(c) 2012 Jake Luer <jake@alogicalparadox.com>
* MIT Licensed
*/
/**
* # addProperty (ctx, name, getter)
*
* Adds a property to the prototype of an object.
*
* utils.addProperty(chai.Assertion, 'foo', function () {
* var obj = utils.flag(this, 'object');
* new chai.Assertion(obj).to.be.instanceof(Foo);
* return this;
* });
*
* Then can be used as any other assertion:
*
* expect(myFoo).to.be.foo;
*
* @param {Function|Object} context chai.Assertion || chai.Assertion.prototype
* @param {String} name of property to add
* @param {Function} getter function to used for name
* @api public
*/
module.export = function (ctx, name, getter) {
var context = ('function' === typeof obj) ? ctx.prototype : ctx;
Object.defineProperty(context, name,
{ get: function () {
getter.call(this);
return this;
}
, configurable: true
});
};
}); // module: utils/addProperty.js
2011-12-15 12:07:27 +00:00
require.register("utils/eql.js", function(module, exports, require){
2011-12-15 13:02:26 +00:00
// This is directly from Node.js assert
// https://github.com/joyent/node/blob/f8c335d0caf47f16d31413f89aa28eda3878e3aa/lib/assert.js
2011-12-14 20:58:24 +00:00
module.exports = _deepEqual;
// For browser implementation
if (!Buffer) {
var Buffer = {
isBuffer: function () {
return false;
}
};
}
2011-12-15 12:07:27 +00:00
2011-12-14 20:58:24 +00:00
function _deepEqual(actual, expected) {
// 7.1. All identical values are equivalent, as determined by ===.
if (actual === expected) {
return true;
} else if (Buffer.isBuffer(actual) && Buffer.isBuffer(expected)) {
if (actual.length != expected.length) return false;
for (var i = 0; i < actual.length; i++) {
if (actual[i] !== expected[i]) return false;
}
return true;
// 7.2. If the expected value is a Date object, the actual value is
// equivalent if it is also a Date object that refers to the same time.
} else if (actual instanceof Date && expected instanceof Date) {
return actual.getTime() === expected.getTime();
// 7.3. Other pairs that do not both pass typeof value == 'object',
// equivalence is determined by ==.
} else if (typeof actual != 'object' && typeof expected != 'object') {
2011-12-15 12:07:27 +00:00
return actual === expected;
2011-12-14 20:58:24 +00:00
// 7.4. For all other Object pairs, including Array objects, equivalence is
// determined by having the same number of owned properties (as verified
// with Object.prototype.hasOwnProperty.call), the same set of keys
// (although not necessarily the same order), equivalent values for every
// corresponding key, and an identical 'prototype' property. Note: this
// accounts for both named and indexed properties on Arrays.
} else {
return objEquiv(actual, expected);
}
}
function isUndefinedOrNull(value) {
return value === null || value === undefined;
}
function isArguments(object) {
return Object.prototype.toString.call(object) == '[object Arguments]';
}
function objEquiv(a, b) {
if (isUndefinedOrNull(a) || isUndefinedOrNull(b))
return false;
// an identical 'prototype' property.
if (a.prototype !== b.prototype) return false;
//~~~I've managed to break Object.keys through screwy arguments passing.
// Converting to array solves the problem.
if (isArguments(a)) {
if (!isArguments(b)) {
return false;
}
a = pSlice.call(a);
b = pSlice.call(b);
return _deepEqual(a, b);
}
try {
var ka = Object.keys(a),
kb = Object.keys(b),
key, i;
} catch (e) {//happens when one is a string literal and the other isn't
return false;
}
// having the same number of owned properties (keys incorporates
// hasOwnProperty)
if (ka.length != kb.length)
return false;
//the same set of keys (although not necessarily the same order),
ka.sort();
kb.sort();
//~~~cheap key test
for (i = ka.length - 1; i >= 0; i--) {
if (ka[i] != kb[i])
return false;
}
//equivalent values for every corresponding key, and
//~~~possibly expensive deep test
for (i = ka.length - 1; i >= 0; i--) {
key = ka[i];
if (!_deepEqual(a[key], b[key])) return false;
}
return true;
}
2011-12-15 12:07:27 +00:00
}); // module: utils/eql.js
2012-04-11 17:31:26 +00:00
require.register("utils/flag.js", function(module, exports, require){
/*!
* Chai - flag utility
* Copyright(c) 2012 Jake Luer <jake@alogicalparadox.com>
* MIT Licensed
*/
/**
* # flag(object ,key, [value])
*
* Get or set a flag value on an object. If a
* value is provided it will be set, else it will
* return the currently set value or `undefined` if
* the value is not set.
*
* @param {Object} object (constructed Assertion
* @param {String} key
* @param {Mixed} value (optional)
* @api private
*/
module.exports = function (obj, key, value) {
2012-04-22 19:27:03 +00:00
var flags = obj.__flags || (obj.__flags = Object.create(null));
2012-04-11 17:31:26 +00:00
if (arguments.length === 3) {
flags[key] = value;
} else {
return flags[key];
}
2012-04-22 19:27:03 +00:00
};
2012-04-11 17:31:26 +00:00
}); // module: utils/flag.js
require.register("utils/getActual.js", function(module, exports, require){
/*!
* Chai - getActual utility
* Copyright(c) 2012 Jake Luer <jake@alogicalparadox.com>
* MIT Licensed
*/
/**
* # getActual(object, [actual])
*
* Returns the `actual` value for an Assertion
*
* @param {Object} object (constructed Assertion)
* @param {Arguments} chai.Assertion.prototype.assert arguments
*/
module.exports = function (obj, args) {
var actual = args[4];
return 'undefined' !== actual ? actual : obj.obj;
};
}); // module: utils/getActual.js
require.register("utils/getMessage.js", function(module, exports, require){
/*!
* Chai - message composition utility
* Copyright(c) 2012 Jake Luer <jake@alogicalparadox.com>
* MIT Licensed
*/
/*!
* Module dependancies
*/
var flag = require('./flag')
, getActual = require('./getActual')
, inspect = require('./inspect');
/**
* # getMessage(object, message, negateMessage)
*
* Construct the error message based on flags
* and template tags. Template tags will return
* a stringified inspection of the object referenced.
*
* Messsage template tags:
* - `#{this}` current asserted object
* - `#{act}` actual value
* - `#{exp}` expected value
*
* @param {Object} object (constructed Assertion)
* @param {Arguments} chai.Assertion.prototype.assert arguments
*/
module.exports = function (obj, args) {
var negate = flag(obj, 'negate')
, val = flag(obj, 'object')
, expected = args[3]
, actual = getActual(obj, args)
, msg = negate ? args[2] : args[1];
msg = msg
.replace(/#{this}/g, inspect(val))
.replace(/#{act}/g, inspect(actual))
.replace(/#{exp}/g, inspect(expected));
return obj.msg ? obj.msg + ': ' + msg : msg;
};
}); // module: utils/getMessage.js
2012-04-22 19:27:03 +00:00
require.register("utils/getName.js", function(module, exports, require){
/*!
* Chai - getName utility
* Copyright(c) 2012 Jake Luer <jake@alogicalparadox.com>
* MIT Licensed
*/
/**
* # getName(func)
*
* Gets the name of a function, in a cross-browser way.
*
* @param {Function} a function (usually a constructor)
*/
module.exports = function (func) {
if (func.name) return func.name;
var match = /^\s?function ([^(]*)\(/.exec(func);
return match && match[1] ? match[1] : "";
};
}); // module: utils/getName.js
2012-04-11 17:31:26 +00:00
require.register("utils/getPathValue.js", function(module, exports, require){
/**
* Chai - getPathValue utility
* Copyright(c) 2012 Jake Luer <jake@alogicalparadox.com>
* @see https://github.com/logicalparadox/filtr
* MIT Licensed
*/
/**
* # .getPathValue(path, object)
*
* This allows the retrieval of values in an
* object given a string path.
*
* var obj = {
* prop1: {
* arr: ['a', 'b', 'c']
* , str: 'Hello'
* }
* , prop2: {
* arr: [ { nested: 'Universe' } ]
* , str: 'Hello again!'
* }
* }
*
* The following would be the results.
*
* getPathValue('prop1.str', obj); // Hello
* getPathValue('prop1.att[2]', obj); // b
* getPathValue('prop2.arr[0].nested', obj); // Universe
*
* @param {String} path
* @param {Object} object
* @returns {Object} value or `undefined`
* @api public
*/
var getPathValue = module.exports = function (path, obj) {
var parsed = parsePath(path);
return _getPathValue(parsed, obj);
};
/*!
* ## parsePath(path)
*
* Helper function used to parse string object
* paths. Use in conjunction with `_getPathValue`.
*
* var parsed = parsePath('myobject.property.subprop');
*
* ### Paths:
*
* * Can be as near infinitely deep and nested
* * Arrays are also valid using the formal `myobject.document[3].property`.
*
* @param {String} path
* @returns {Object} parsed
* @api private
*/
function parsePath (path) {
var parts = path.split('.').filter(Boolean);
return parts.map(function (value) {
var re = /([A-Za-z0-9]+)\[(\d+)\]$/
, mArr = re.exec(value)
, val;
if (mArr) val = { p: mArr[1], i: parseFloat(mArr[2]) };
return val || value;
});
};
/**
* ## _getPathValue(parsed, obj)
*
* Helper companion function for `.parsePath` that returns
* the value located at the parsed address.
*
* var value = getPathValue(parsed, obj);
*
* @param {Object} parsed definition from `parsePath`.
* @param {Object} object to search against
* @returns {Object|Undefined} value
* @api private
*/
function _getPathValue (parsed, obj) {
var tmp = obj
, res;
for (var i = 0, l = parsed.length; i < l; i++) {
var part = parsed[i];
if (tmp) {
if ('object' === typeof part && tmp[part.p]) {
tmp = tmp[part.p][part.i];
} else {
tmp = tmp[part];
}
if (i == (l - 1)) res = tmp;
} else {
res = undefined;
}
}
return res;
};
}); // module: utils/getPathValue.js
2012-03-18 21:42:08 +00:00
require.register("utils/index.js", function(module, exports, require){
/*!
* chai
* Copyright(c) 2011 Jake Luer <jake@alogicalparadox.com>
* MIT Licensed
*/
/*!
* Main exports
*/
var exports = module.exports = {};
2012-04-11 17:31:26 +00:00
/*!
* test utility
*/
exports.test = require('./test');
/*!
* message utility
*/
exports.getMessage = require('./getMessage');
/*!
* actual utility
*/
exports.getActual = require('./getActual');
2012-03-18 21:42:08 +00:00
/*!
* Inspect util
*/
exports.inspect = require('./inspect');
2012-04-11 17:31:26 +00:00
/*!
* Flag utility
*/
exports.flag = require('./flag');
2012-03-18 21:42:08 +00:00
/*!
* Deep equal utility
*/
exports.eql = require('./eql');
2012-04-11 17:31:26 +00:00
/*!
* Deep path value
*/
exports.getPathValue = require('./getPathValue');
2012-04-22 19:27:03 +00:00
/*!
* Function name
*/
exports.getName = require('./getName');
/*!
* add Property
*/
exports.addProperty = require('./addProperty');
/*!
* add Method
*/
exports.addMethod = require('./addMethod');
/*!
* overwrite Property
*/
exports.overwriteProperty = require('./overwriteProperty');
/*!
* overwrite Method
*/
exports.overwriteMethod = require('./overwriteMethod');
2012-04-11 17:31:26 +00:00
2012-03-18 21:42:08 +00:00
}); // module: utils/index.js
2011-12-15 12:07:27 +00:00
require.register("utils/inspect.js", function(module, exports, require){
2011-12-15 13:02:26 +00:00
// This is (almost) directly from Node.js utils
// https://github.com/joyent/node/blob/f8c335d0caf47f16d31413f89aa28eda3878e3aa/lib/util.js
2011-12-15 12:07:27 +00:00
2012-04-22 19:27:03 +00:00
var getName = require('./getName');
2011-12-15 12:07:27 +00:00
module.exports = inspect;
/**
* Echos the value of a value. Trys to print the value out
* in the best way possible given the different types.
*
* @param {Object} obj The object to print out.
* @param {Boolean} showHidden Flag that shows hidden (not enumerable)
* properties of objects.
* @param {Number} depth Depth in which to descend in object. Default is 2.
* @param {Boolean} colors Flag to turn on ANSI escape codes to color the
* output. Default is false (no coloring).
*/
function inspect(obj, showHidden, depth, colors) {
var ctx = {
showHidden: showHidden,
seen: [],
stylize: function (str) { return str; }
};
return formatValue(ctx, obj, (typeof depth === 'undefined' ? 2 : depth));
}
function formatValue(ctx, value, recurseTimes) {
// Provide a hook for user-specified inspect functions.
// Check that value is an object with an inspect function on it
if (value && typeof value.inspect === 'function' &&
// Filter out the util module, it's inspect function is special
value.inspect !== exports.inspect &&
// Also filter out any prototype objects using the circular check.
!(value.constructor && value.constructor.prototype === value)) {
return value.inspect(recurseTimes);
}
// Primitive types cannot have properties
var primitive = formatPrimitive(ctx, value);
if (primitive) {
return primitive;
}
// Look up the keys of the object.
var visibleKeys = Object.keys(value);
var keys = ctx.showHidden ? Object.getOwnPropertyNames(value) : visibleKeys;
// Some type of object without properties can be shortcutted.
2012-04-22 19:27:03 +00:00
// In IE, errors have a single `stack` property, or if they are vanilla `Error`,
// a `stack` plus `description` property; ignore those for consistency.
if (keys.length === 0 || (isError(value) && (
(keys.length === 1 && keys[0] === 'stack') ||
(keys.length === 2 && keys[0] === 'description' && keys[1] === 'stack')
))) {
2011-12-15 12:07:27 +00:00
if (typeof value === 'function') {
2012-04-22 19:27:03 +00:00
var name = getName(value);
var nameSuffix = name ? ': ' + name : '';
return ctx.stylize('[Function' + nameSuffix + ']', 'special');
2011-12-15 12:07:27 +00:00
}
if (isRegExp(value)) {
return ctx.stylize(RegExp.prototype.toString.call(value), 'regexp');
}
if (isDate(value)) {
return ctx.stylize(Date.prototype.toUTCString.call(value), 'date');
}
if (isError(value)) {
return formatError(value);
}
}
var base = '', array = false, braces = ['{', '}'];
// Make Array say that they are Array
if (isArray(value)) {
array = true;
braces = ['[', ']'];
}
// Make functions say that they are functions
if (typeof value === 'function') {
var n = value.name ? ': ' + value.name : '';
base = ' [Function' + n + ']';
}
// Make RegExps say that they are RegExps
if (isRegExp(value)) {
base = ' ' + RegExp.prototype.toString.call(value);
}
// Make dates with properties first say the date
if (isDate(value)) {
base = ' ' + Date.prototype.toUTCString.call(value);
}
// Make error with message first say the error
if (isError(value)) {
base = ' ' + formatError(value);
}
if (keys.length === 0 && (!array || value.length == 0)) {
return braces[0] + base + braces[1];
}
if (recurseTimes < 0) {
if (isRegExp(value)) {
return ctx.stylize(RegExp.prototype.toString.call(value), 'regexp');
} else {
return ctx.stylize('[Object]', 'special');
}
}
ctx.seen.push(value);
var output;
if (array) {
output = formatArray(ctx, value, recurseTimes, visibleKeys, keys);
} else {
output = keys.map(function(key) {
return formatProperty(ctx, value, recurseTimes, visibleKeys, key, array);
});
}
ctx.seen.pop();
return reduceToSingleString(output, base, braces);
}
function formatPrimitive(ctx, value) {
switch (typeof value) {
case 'undefined':
return ctx.stylize('undefined', 'undefined');
case 'string':
var simple = '\'' + JSON.stringify(value).replace(/^"|"$/g, '')
.replace(/'/g, "\\'")
.replace(/\\"/g, '"') + '\'';
return ctx.stylize(simple, 'string');
case 'number':
return ctx.stylize('' + value, 'number');
case 'boolean':
return ctx.stylize('' + value, 'boolean');
}
// For some reason typeof null is "object", so special case here.
if (value === null) {
return ctx.stylize('null', 'null');
}
}
function formatError(value) {
return '[' + Error.prototype.toString.call(value) + ']';
}
function formatArray(ctx, value, recurseTimes, visibleKeys, keys) {
var output = [];
for (var i = 0, l = value.length; i < l; ++i) {
if (Object.prototype.hasOwnProperty.call(value, String(i))) {
output.push(formatProperty(ctx, value, recurseTimes, visibleKeys,
String(i), true));
} else {
output.push('');
}
}
keys.forEach(function(key) {
if (!key.match(/^\d+$/)) {
output.push(formatProperty(ctx, value, recurseTimes, visibleKeys,
key, true));
}
});
return output;
}
function formatProperty(ctx, value, recurseTimes, visibleKeys, key, array) {
var name, str;
if (value.__lookupGetter__) {
if (value.__lookupGetter__(key)) {
if (value.__lookupSetter__(key)) {
str = ctx.stylize('[Getter/Setter]', 'special');
} else {
str = ctx.stylize('[Getter]', 'special');
}
} else {
if (value.__lookupSetter__(key)) {
str = ctx.stylize('[Setter]', 'special');
}
}
}
if (visibleKeys.indexOf(key) < 0) {
name = '[' + key + ']';
}
if (!str) {
if (ctx.seen.indexOf(value[key]) < 0) {
if (recurseTimes === null) {
str = formatValue(ctx, value[key], null);
} else {
str = formatValue(ctx, value[key], recurseTimes - 1);
}
if (str.indexOf('\n') > -1) {
if (array) {
str = str.split('\n').map(function(line) {
return ' ' + line;
}).join('\n').substr(2);
} else {
str = '\n' + str.split('\n').map(function(line) {
return ' ' + line;
}).join('\n');
}
}
} else {
str = ctx.stylize('[Circular]', 'special');
}
}
if (typeof name === 'undefined') {
if (array && key.match(/^\d+$/)) {
return str;
}
name = JSON.stringify('' + key);
if (name.match(/^"([a-zA-Z_][a-zA-Z_0-9]*)"$/)) {
name = name.substr(1, name.length - 2);
name = ctx.stylize(name, 'name');
} else {
name = name.replace(/'/g, "\\'")
.replace(/\\"/g, '"')
.replace(/(^"|"$)/g, "'");
name = ctx.stylize(name, 'string');
}
}
return name + ': ' + str;
}
function reduceToSingleString(output, base, braces) {
var numLinesEst = 0;
var length = output.reduce(function(prev, cur) {
numLinesEst++;
if (cur.indexOf('\n') >= 0) numLinesEst++;
return prev + cur.length + 1;
}, 0);
if (length > 60) {
return braces[0] +
(base === '' ? '' : base + '\n ') +
' ' +
output.join(',\n ') +
' ' +
braces[1];
}
return braces[0] + base + ' ' + output.join(', ') + ' ' + braces[1];
}
function isArray(ar) {
return Array.isArray(ar) ||
(typeof ar === 'object' && objectToString(ar) === '[object Array]');
}
function isRegExp(re) {
return typeof re === 'object' && objectToString(re) === '[object RegExp]';
}
function isDate(d) {
return typeof d === 'object' && objectToString(d) === '[object Date]';
}
function isError(e) {
return typeof e === 'object' && objectToString(e) === '[object Error]';
}
function objectToString(o) {
return Object.prototype.toString.call(o);
}
}); // module: utils/inspect.js
2011-12-07 06:10:58 +00:00
2012-04-22 19:27:03 +00:00
require.register("utils/overwriteMethod.js", function(module, exports, require){
/*!
* Chai - overwriteMethod utility
* Copyright(c) 2012 Jake Luer <jake@alogicalparadox.com>
* MIT Licensed
*/
/**
* # overwriteProperty (ctx, name, fn)
*
* Overwites an already existing method and provides
* access to previous function. Must return function
* to be used for name.
*
* utils.overwriteMethod(chai.Assertion, 'equal', function (_super) {
* return function (str) {
* var obj = utils.flag(this, 'object');
* if (obj instanceof Foo) {
* new chai.Assertion(obj.value).to.equal(str);
* return this;
* } else {
* return _super.apply(this, argument);
* }
* }
* });
*
* Then can be used as any other assertion.
*
* expect(myFoo).to.equal('bar');
*
* @param {Function|Object} context chai.Assertion || chai.Assertion.prototype
* @param {String} name of method to overwrite
* @param {Function} method function to be used for name
* @api public
*/
module.exports = function (ctx, name, method) {
var context = ('function' === typeof obj) ? ctx.prototype : ctx
, _method = context[name]
, _super = function () { return this; };
if (_method && 'function' === typeof _method)
_super = _method;
context[name] = method(_super);
};
}); // module: utils/overwriteMethod.js
require.register("utils/overwriteProperty.js", function(module, exports, require){
/*!
* Chai - overwriteProperty utility
* Copyright(c) 2012 Jake Luer <jake@alogicalparadox.com>
* MIT Licensed
*/
/**
* # overwriteProperty (ctx, name, fn)
*
* Overwites an already existing property getter and provides
* access to previous value. Must return function to use as getter.
*
* utils.overwriteProperty(chai.Assertion, 'ok', function (_super) {
* return function () {
* var obj = utils.flag(this, 'object');
* if (obj instanceof Foo) {
* new chai.Assertion(obj.name).to.equal('bar');
* return this;
* } else {
* return _super.call(this);
* }
* }
* });
*
* Then can be used as any other assertion.
*
* expect(myFoo).to.be.ok;
*
* @param {Function|Object} context chai.Assertion || chai.Assertion.prototype
* @param {String} name of property to overwrite
* @param {Function} method must return function to be used for name
* @api public
*/
module.exports = function (ctx, name, getter) {
var context = ('function' === typeof obj) ? ctx.prototype : ctx
, _get = Object.getOwnPropertyDescriptor(context, name)
, _super = function () { return this; };
if (_get && 'function' === typeof _get.get)
_super = _get.get
Object.defineProperty(context, name,
{ get: getter(_super)
, configurable: true
});
};
}); // module: utils/overwriteProperty.js
2012-04-11 17:31:26 +00:00
require.register("utils/test.js", function(module, exports, require){
/*!
* Chai - test utility
* Copyright(c) 2012 Jake Luer <jake@alogicalparadox.com>
* MIT Licensed
*/
/*!
* Module dependancies
*/
var flag = require('./flag');
/**
* # test(object, expression)
*
* Test and object for expression.
*
* @param {Object} object (constructed Assertion)
* @param {Arguments} chai.Assertion.prototype.assert arguments
*/
module.exports = function (obj, args) {
var negate = flag(obj, 'negate')
, expr = args[0];
return negate ? !expr : expr;
};
}); // module: utils/test.js
2011-12-07 06:10:58 +00:00
return require('chai');
2012-03-18 21:47:41 +00:00
});