mirror of
https://github.com/whoisclebs/lodash.git
synced 2026-02-02 08:07:50 +00:00
635 lines
19 KiB
JavaScript
635 lines
19 KiB
JavaScript
/*!
|
|
* QUnit Extras v1.1.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 = '----------------------------------------';
|
|
|
|
/** Native method shortcut */
|
|
var unshift = Array.prototype.unshift;
|
|
|
|
/** Used to match HTML entities */
|
|
var reEscapedHtml = /(&|<|>|"|')/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,
|
|
'white': 37
|
|
};
|
|
|
|
/** Used to convert HTML entities to characters */
|
|
var htmlUnescapes = {
|
|
'&': '&',
|
|
'<': '<',
|
|
'>': '>',
|
|
'"': '"',
|
|
''': "'"
|
|
};
|
|
|
|
/** 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;
|
|
}
|
|
|
|
/**
|
|
* 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 `&`, `<`, `>`, `"`, and `'`
|
|
* 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];
|
|
}
|
|
|
|
/*--------------------------------------------------------------------------*/
|
|
|
|
/**
|
|
* 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 console = context.console,
|
|
phantom = context.phantom,
|
|
process = phantom || context.process,
|
|
document = !phantom && context.document,
|
|
java = !document && context.java;
|
|
|
|
/** Detect the OS of the platform */
|
|
var os = (function() {
|
|
if (java) {
|
|
return java.lang.System.getProperty('os.name');
|
|
}
|
|
if (phantom) {
|
|
return require('system').os.name;
|
|
}
|
|
if (process) {
|
|
return process.platform;
|
|
}
|
|
return '';
|
|
}());
|
|
|
|
/** 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 = /\bwin/i.test(os);
|
|
|
|
/** 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));
|
|
}
|
|
|
|
/*------------------------------------------------------------------------*/
|
|
|
|
/**
|
|
* 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) {
|
|
var code = ansiCodes[colorName];
|
|
return isWindows
|
|
? string
|
|
: ('\x1B[' + code + 'm' + string + '\x1B[0m');
|
|
}
|
|
|
|
/**
|
|
* Writes an inline message to standard output.
|
|
*
|
|
* @private
|
|
* @param {string} text The text to log.
|
|
*/
|
|
var logInline = (function() {
|
|
// exit early if not Node.js
|
|
if (!(typeof process == 'object' && process &&
|
|
process.on && process.stdout && process.platform != 'win32')) {
|
|
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.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 excused = QUnit.config.excused || {},
|
|
excusedTests = excused[details.module],
|
|
excusedAsserts = excusedTests && excusedTests[details.name];
|
|
|
|
var test = QUnit.config.current,
|
|
finish = test.finish;
|
|
|
|
// allow async tests to retry
|
|
if (test.async && !test.retries) {
|
|
test.retries = 0;
|
|
test.finish = function() {
|
|
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 = function() {
|
|
var asserts = this.assertions,
|
|
index = -1,
|
|
length = asserts.length;
|
|
|
|
while (++index < length) {
|
|
var assert = asserts[index],
|
|
message = unescape(result(reMessage.exec(assert.message), 1)),
|
|
died = result(reDied.exec(message), 0),
|
|
expected = unescape(result(reExpected.exec(assert.message), 1));
|
|
|
|
if ((message && contains(excusedAsserts, message)) ||
|
|
(died && contains(excusedAsserts, died)) ||
|
|
(expected && (
|
|
contains(excusedAsserts, expected) ||
|
|
contains(excusedAsserts, expected.replace(/\s+/g, ''))
|
|
))) {
|
|
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': context.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));
|