Files
lodash/vendor/qunit-extras/qunit-extras.js
John-David Dalton c5237a926d Update vendor.
2014-05-25 23:55:59 -07:00

726 lines
23 KiB
JavaScript

/*!
* QUnit Extras v1.2.0
* Copyright 2011-2014 John-David Dalton <http://allyoucanleet.com/>
* Based on a gist by Jörn Zaefferer <https://gist.github.com/722381>
* Available under MIT license <http://mths.be/mit>
*/
;(function() {
/** Used as a safe reference for `undefined` in pre ES5 environments */
var undefined;
/** Used as a horizontal rule in console output */
var hr = '----------------------------------------';
/** Used for native method references */
var arrayProto = Array.prototype;
/** Native method shortcut */
var push = arrayProto.push,
unshift = arrayProto.unshift;
/** Used to match HTML entities */
var reEscapedHtml = /(&amp;|&lt;|&gt;|&quot;|&#39;)/g;
/** Used to match parts of the assert message */
var reDied = /^Died on test #\d+/,
reExpected = /Expected: *<\/th><td><pre>([\s\S]*?)<\/pre>/,
reMessage = /^<span class='test-message'>([\s\S]*?)<\/span>/;
/** Used to associate color names with their corresponding codes */
var ansiCodes = {
'bold': 1,
'green': 32,
'magenta': 35,
'red': 31
};
/** Used to convert HTML entities to characters */
var htmlUnescapes = {
'&amp;': '&',
'&lt;': '<',
'&gt;': '>',
'&quot;': '"',
'&#39;': "'"
};
/** Used to determine if values are of the language type Object */
var objectTypes = {
'function': true,
'object': true
};
/** Used as a reference to the global object */
var root = (objectTypes[typeof window] && window) || this;
/** Detect free variable `exports` */
var freeExports = objectTypes[typeof exports] && exports && !exports.nodeType && exports;
/** Detect free variable `module` */
var freeModule = objectTypes[typeof module] && module && !module.nodeType && module;
/** Detect free variable `global` from Node.js or Browserified code and use it as `root` */
var freeGlobal = freeExports && freeModule && typeof global == 'object' && global;
if (freeGlobal && (freeGlobal.global === freeGlobal || freeGlobal.window === freeGlobal || freeGlobal.self === freeGlobal)) {
root = freeGlobal;
}
/*--------------------------------------------------------------------------*/
/**
* Checks if a given value is present in an array using strict equality
* for comparisons, i.e. `===`.
*
* @private
* @param {Array} array The array to iterate over.
* @param {*} value The value to check for.
* @returns {boolean} Returns `true` if the `value` is found, else `false`.
*/
function contains(array, value) {
var index = -1,
length = array ? array.length : 0;
while (++index < length) {
if (array[index] === value) {
return true;
}
}
return false;
}
/**
* Checks if `value` is the language type of `Object`.
* (e.g. arrays, functions, objects, regexes, `new Number(0)`, and `new String('')`)
*
* @private
* @param {*} value The value to check.
* @returns {boolean} Returns `true` if `value` is an object, else `false`.
*/
function isObject(value) {
var type = typeof value;
return type == 'function' || (value && type == 'object') || false;
}
/**
* Creates a string with `text` repeated `n` number of times.
*
* @private
* @param {string} text The text to repeat.
* @param {number} n The number of times to repeat `text`.
* @returns {string} The created string.
*/
function repeat(text, n) {
return Array(n + 1).join(text);
}
/**
* Resolves the value of `property` on `object`. If `object` is falsey then
* `undefined` is returned.
*
* @private
* @param {Object} object The object to inspect.
* @param {string} property The property to get the value of.
* @returns {*} Returns the resolved value.
*/
function result(object, property) {
return object ? object[property] : undefined;
}
/**
* Converts the HTML entities `&amp;`, `&lt;`, `&gt;`, `&quot;`, and `&#39;`
* in `string` to their corresponding characters.
*
* @private
* @param {string} string The string to unescape.
* @returns {string} Returns the unescaped string.
*/
function unescape(string) {
return string == null ? '' : String(string).replace(reEscapedHtml, unescapeHtmlChar);
}
/**
* Used by `unescape` to convert HTML entities to characters.
*
* @private
* @param {string} match The matched character to unescape.
* @returns {string} Returns the unescaped character.
*/
function unescapeHtmlChar(match) {
return htmlUnescapes[match];
}
/**
* Creates a function that provides `value` to the wrapper function as its
* first argument. Additional arguments provided to the function are appended
* to those provided to the wrapper function. The wrapper is executed with
* the `this` binding of the created function.
*
* @private
* @param {*} value The value to wrap.
* @param {Function} wrapper The wrapper function.
* @returns {Function} Returns the new function.
*/
function wrap(value, wrapper) {
return function() {
var args = [value];
push.apply(args, arguments);
return wrapper.apply(this, args);
};
}
/*--------------------------------------------------------------------------*/
/**
* Installs the QUnit additions on the given `context` object.
*
* @memberOf exports
* @param {Object} context The context object.
*/
function runInContext(context) {
// exit early if no `context` is provided or if `QUnit` does not exist
if (!context || !context.QUnit) {
return;
}
/** Used to report the test module for failing tests */
var moduleName,
modulePrinted;
/** Object shortcuts */
var phantom = context.phantom,
define = context.define,
document = !phantom && context.document,
process = phantom || context.process,
amd = define && define.amd,
console = context.console,
java = !document && context.java,
print = context.print,
require = context.require;
/** Detects if running on Node.js */
var isNode = isObject(process) && typeof process.on == 'function';
/** Detects if running in a PhantomJS web page */
var isPhantomPage = typeof context.callPhantom == 'function';
/** Detects if QUnit Extras should log to the console */
var isSilent = document && !isPhantomPage;
/** Used to indicate if running in Windows */
var isWindows = isNode && process.platform == 'win32';
/** Used to indicate if ANSI escape codes are supported */
var isAnsiSupported = (function() {
if (isNode && process.stdout && !process.stdout.isTTY) {
return false;
}
if (isWindows || getEnv('COLORTERM')) {
return true;
}
return /^(?:ansi|cygwin|linux|screen|xterm|vt100)$|color/i.test(getEnv('TERM'));
}());
/** Used to display the wait throbber */
var throbberDelay = 500,
waitCount = -1;
/** Shorten `context.QUnit.QUnit` to `context.QUnit` */
var QUnit = context.QUnit = context.QUnit.QUnit || context.QUnit;
/*------------------------------------------------------------------------*/
/**
* Schedules timer-based callbacks.
*
* @private
* @param {Function|string} fn The function to call.
* @param {number} delay The number of milliseconds to delay the `fn` call.
* @param {Array} args Arguments to invoke `fn` with.
* @param {boolean} repeated A flag to specify whether `fn` is called repeatedly.
* @returns {number} The ID of the timeout.
*/
function schedule(fn, delay, args, repeated) {
// Rhino 1.7RC4 will error assigning `task` below
// https://bugzilla.mozilla.org/show_bug.cgi?id=775566
var task = ids[++counter] = new JavaAdapter(java.util.TimerTask, {
'run': function() {
fn.apply(context, args);
}
});
// support non-functions
if (typeof fn != 'function') {
fn = (function(code) {
code = String(code);
return function() { eval(code); };
}(fn));
}
// used by setInterval
if (repeated) {
timer.schedule(task, delay, delay);
}
// used by setTimeout
else {
timer.schedule(task, delay);
}
return counter;
}
/**
* Clears the delay set by `setInterval` or `setTimeout`.
*
* @memberOf context
* @param {number} id The ID of the timeout to be cleared.
*/
function clearTimer(id) {
if (ids[id]) {
ids[id].cancel();
timer.purge();
delete ids[id];
}
}
/**
* Executes a code snippet or function repeatedly, with a delay between each call.
*
* @memberOf context
* @param {Function|string} fn The function to call or string to evaluate.
* @param {number} delay The number of milliseconds to delay each `fn` call.
* @param {...*} [args] Arguments to invoke `fn` with.
* @returns {number} The ID of the timeout.
*/
function setInterval(fn, delay) {
return schedule(fn, delay, slice.call(arguments, 2), true);
}
/**
* Executes a code snippet or a function after specified delay.
*
* @memberOf context
* @param {Function|string} fn The function to call or string to evaluate.
* @param {number} delay The number of milliseconds to delay the `fn` call.
* @param {...*} [args] Arguments to invoke `fn` with.
* @returns {number} The ID of the timeout.
*/
function setTimeout(fn, delay) {
return schedule(fn, delay, slice.call(arguments, 2));
}
/*------------------------------------------------------------------------*/
/**
* Gets the environment variable value by a given name.
*
* @private
* @param {string} name The name of the environment variable to get.
* @returns {*} Returns the environment variable value.
*/
function getEnv(name) {
if (isNode) {
return process.env[name];
}
if (java) {
return java.lang.System.getenv(name);
}
if (!amd && typeof require == 'function') {
try {
return require('system').env[name];
} catch(e) { }
}
}
/**
* Adds text color to the terminal output of `string`.
*
* @private
* @param {string} colorName The name of the color to add.
* @param {string} string The string to add colors to.
* @returns {string} Returns the colored string.
*/
function color(colorName, string) {
return isAnsiSupported
? ('\x1B[' + ansiCodes[colorName] + 'm' + string + '\x1B[0m')
: string;
}
/**
* Writes an inline message to standard output.
*
* @private
* @param {string} [text=''] The text to log.
*/
var logInline = (function() {
if (!isNode || isWindows) {
return function() {};
}
// cleanup any inline logs when exited via `ctrl+c`
process.on('SIGINT', function() {
logInline();
process.exit();
});
var prevLine = '';
return function(text) {
var blankLine = repeat(' ', prevLine.length);
if (text == null) {
text = '';
}
if (text.length > hr.length) {
text = text.slice(0, hr.length - 3) + '...';
}
prevLine = text;
process.stdout.write(text + blankLine.slice(text.length) + '\r');
}
}());
/**
* Writes the wait throbber to standard output.
*
* @private
*/
function logThrobber() {
logInline('Please wait' + repeat('.', (++waitCount % 3) + 1));
}
/*------------------------------------------------------------------------*/
/**
* The number of retries async tests have to succeed.
*
* @memberOf QUnit.config
* @type number
*/
QUnit.config.asyncRetries = 0;
/**
* An object of excused tests and assertions.
*
* @memberOf QUnit.config
* @type Object
*/
QUnit.config.excused = {};
/**
* An object used to hold "extras" information about the current running test.
*
* @memberOf QUnit.config
* @type Object
*/
QUnit.config.extrasData = {
/**
* An array of details for each log entry.
*
* @memberOf QUnit.config.extrasData
* @type Array
*/
'logEntries': []
};
// add a callback to be triggered when all testing has completed
QUnit.done(function(details) {
// assign results to `global_test_results` for Sauce Labs
context.global_test_results = details;
});
// add a callback to be triggered at the start of every test
QUnit.testStart(function(details) {
var config = QUnit.config,
test = config.current;
var excused = config.excused || {},
excusedTests = excused[details.module],
excusedAsserts = excusedTests && excusedTests[details.name];
// allow async tests to retry
if (test.async && !test.retries) {
test.retries = 0;
test.finish = wrap(test.finish, function(finish) {
var asserts = this.assertions,
config = QUnit.config,
index = -1,
length = asserts.length,
entries = config.extrasData.logEntries,
queue = config.queue;
while (++index < length) {
var assert = asserts[index];
if (!assert.result && this.retries < config.asyncRetries) {
if (!isSilent) {
entries.length -= asserts.length;
}
this.retries++;
asserts.length = 0;
var oldLength = queue.length;
this.queue();
unshift.apply(queue, queue.splice(oldLength, queue.length - oldLength));
return;
}
}
finish.call(this);
});
}
// nothing to excuse
if (!excusedAsserts) {
return;
}
// excuse the entire test
if (excusedAsserts === true) {
test.async = false;
test.callback = function() {};
test.expected = 0;
return;
}
// excuse specific assertions
test.finish = wrap(test.finish, function(finish) {
var asserts = this.assertions,
config = QUnit.config,
expected = this.expected,
items = asserts.slice(),
length = items.length;
if (expected == null) {
if (config.requireExpects) {
expected = length;
items.push('Expected number of assertions to be defined, but expect() was not called.');
} else if (!length) {
expected = 1;
items.push('Expected at least one assertion, but none were run - call expect(0) to accept zero assertions.');
}
} else if (expected != length) {
items.push('Expected ' + expected + ' assertions, but ' + length + ' were run');
}
var index = -1;
length = items.length;
while (++index < length) {
var assert = items[index],
isStr = typeof assert == 'string',
message = assert.message;
var assertMessage = isStr ? assert : unescape(result(reMessage.exec(message), 1)),
assertValue = isStr ? assert : unescape(result(reExpected.exec(message), 1)),
assertDied = result(reDied.exec(assertMessage), 0);
if ((assertMessage && contains(excusedAsserts, assertMessage)) ||
(assertDied && contains(excusedAsserts, assertDied)) ||
(assertValue && (
contains(excusedAsserts, assertValue) ||
contains(excusedAsserts, assertValue.replace(/\s+/g, ''))
))) {
if (isStr) {
while (asserts.length < expected) {
asserts.push({ 'result': true });
}
asserts.length = expected;
}
else {
assert.result = true;
}
}
}
finish.call(this);
});
});
// replace poisoned `raises` method
context.raises = QUnit.raises = QUnit['throws'] || QUnit.raises;
/*------------------------------------------------------------------------*/
// add logging extras
if (!isSilent) {
// add a callback to be triggered when all testing has completed
QUnit.done(function() {
var ran;
return function(details) {
// stop `asyncTest()` from erroneously calling `done()` twice in
// environments w/o timeouts
if (ran) {
return;
}
ran = true;
var failures = details.failed;
var statusColor = failures ? 'magenta' : 'green';
logInline();
console.log(hr);
console.log(color(statusColor, ' PASS: ' + details.passed + ' FAIL: ' + failures + ' TOTAL: ' + details.total));
console.log(color(statusColor, ' Finished in ' + details.runtime + ' milliseconds.'));
console.log(hr);
// exit out of Node.js or PhantomJS
try {
if (failures) {
process.exit(1);
} else {
process.exit(0);
}
} catch(e) { }
// exit out of Narwhal, Rhino, or RingoJS
try {
if (failures) {
java.lang.System.exit(1);
} else {
quit();
}
} catch(e) { }
};
}());
// add a callback to be triggered after every assertion
QUnit.log(function(details) {
QUnit.config.extrasData.logEntries.push(details);
});
// add a callback to be triggered at the start of every test module
QUnit.moduleStart(function(details) {
// reset the `modulePrinted` flag
var newModuleName = details.name;
if (moduleName != newModuleName) {
moduleName = newModuleName;
modulePrinted = false;
}
});
// add a callback to be triggered after a test is completed
QUnit.testDone(function(details) {
var config = QUnit.config,
failures = details.failed,
hidepassed = config.hidepassed,
entries = config.extrasData.logEntries.slice(),
testName = details.name;
config.extrasData.logEntries.length = 0;
if (hidepassed && !failures) {
return;
}
logInline();
if (!modulePrinted) {
modulePrinted = true;
console.log(hr);
console.log(color('bold', moduleName));
console.log(hr);
}
console.log(' ' + (failures ? color('red', 'FAIL') : color('green', 'PASS')) + ' - ' + testName);
if (!failures) {
return;
}
var index = -1,
length = entries.length;
while(++index < length) {
var entry = entries[index];
if (hidepassed && entry.result) {
continue;
}
var expected = entry.expected,
result = entry.result,
type = typeof expected != 'undefined' ? 'EQ' : 'OK';
var message = [
result ? color('green', 'PASS') : color('red', 'FAIL'),
type,
entry.message || 'ok'
];
if (!result && type == 'EQ') {
message.push(color('magenta', 'Expected: ' + expected + ', Actual: ' + entry.actual));
}
console.log(' ' + message.join(' | '));
}
});
/**
* Converts an object into a string representation.
*
* @memberOf QUnit
* @type Function
* @param {Object} object The object to stringify.
* @returns {string} The result string.
*/
QUnit.jsDump.parsers.object = (function() {
var func = QUnit.jsDump.parsers.object;
return function(object) {
if (typeof object.rhinoException != 'object') {
return func(object);
}
return object.name +
' { message: "' + object.message +
'", fileName: "' + object.fileName +
'", lineNumber: ' + object.lineNumber + ' }';
};
}());
}
/*------------------------------------------------------------------------*/
// add CLI extras
if (!document) {
// Timeout fallbacks based on the work of Andrea Giammarchi and Weston C.
// https://github.com/WebReflection/wru/blob/master/src/rhinoTimers.js
// http://stackoverflow.com/questions/2261705/how-to-run-a-javascript-function-asynchronously-without-using-settimeout
try {
var counter = 0,
ids = {},
slice = Array.prototype.slice,
timer = new java.util.Timer;
(function() {
var getDescriptor = Object.getOwnPropertyDescriptor || function() {
return { 'writable': true };
};
var descriptor;
if ((!context.clearInterval || ((descriptor = getDescriptor(context, 'clearInterval')) && (descriptor.writable || descriptor.set))) &&
(!context.setInterval || ((descriptor = getDescriptor(context, 'setInterval')) && (descriptor.writable || descriptor.set)))) {
context.clearInterval = clearTimer;
context.setInterval = setInterval;
}
if ((!context.clearTimeout || ((descriptor = getDescriptor(context, 'clearTimeout')) && (descriptor.writable || descriptor.set))) &&
(!context.setTimeout || ((descriptor = getDescriptor(context, 'setTimeout')) && (descriptor.writable || descriptor.set)))) {
context.clearTimeout = clearTimer;
context.setTimeout = setTimeout;
}
}());
} catch(e) { }
// expose shortcuts
// exclude `module` because some environments have it as a built-in object
('asyncTest deepEqual equal equals expect notDeepEqual notEqual notStrictEqual ' +
'ok raises same start stop strictEqual test throws').replace(/\S+/g, function(methodName) {
context[methodName] = QUnit[methodName];
});
// add `console.log` support to Narwhal, Rhino, and RingoJS
if (!console) {
console = context.console = { 'log': function() {} };
}
// RingoJS removes ANSI escape codes in `console.log`, but not in `print`
if (java && typeof print == 'function') {
console.log = print;
}
// start log throbber
if (!isSilent) {
context.setInterval(logThrobber, throbberDelay);
}
// must call `QUnit.start` in the test file if not loaded in a browser
QUnit.config.autostart = false;
QUnit.init();
}
}
/*--------------------------------------------------------------------------*/
// export QUnit Extras
if (freeExports) {
freeExports.runInContext = runInContext;
} else {
runInContext(root);
}
}.call(this));