#!/usr/bin/env node ;(function(undefined) { 'use strict'; /** Load modules */ var fs = require('fs'), path = require('path'), vm = require('vm'), build = require('../build.js'), minify = require('../build/minify'), _ = require('../lodash.js'); /** The unit testing framework */ var QUnit = global.QUnit = require('../vendor/qunit/qunit/qunit.js'); require('../vendor/qunit-clib/qunit-clib.js'); /** Used to associate aliases with their real names */ var aliasToRealMap = { 'all': 'every', 'any': 'some', 'collect': 'map', 'detect': 'find', 'drop': 'rest', 'each': 'forEach', 'foldl': 'reduce', 'foldr': 'reduceRight', 'head': 'first', 'include': 'contains', 'inject': 'reduce', 'methods': 'functions', 'select': 'filter', 'tail': 'rest', 'take': 'first', 'unique': 'uniq' }; /** Used to associate real names with their aliases */ var realToAliasMap = { 'contains': ['include'], 'every': ['all'], 'filter': ['select'], 'find': ['detect'], 'first': ['head', 'take'], 'forEach': ['each'], 'functions': ['methods'], 'map': ['collect'], 'reduce': ['foldl', 'inject'], 'reduceRight': ['foldr'], 'rest': ['drop', 'tail'], 'some': ['any'], 'uniq': ['unique'] }; /** List of all Lo-Dash methods */ var allMethods = _.functions(_).filter(function(methodName) { return !/^_/.test(methodName); }); /** List of "Arrays" category methods */ var arraysMethods = [ 'compact', 'difference', 'drop', 'first', 'flatten', 'head', 'indexOf', 'initial', 'intersection', 'last', 'lastIndexOf', 'max', 'min', 'object', 'range', 'rest', 'shuffle', 'sortedIndex', 'tail', 'take', 'union', 'uniq', 'unique', 'without', 'zip' ]; /** List of "Chaining" category methods */ var chainingMethods = [ 'chain', 'mixin', 'tap', 'value' ]; /** List of "Collections" category methods */ var collectionsMethods = [ 'all', 'any', 'collect', 'contains', 'countBy', 'detect', 'each', 'every', 'filter', 'find', 'foldl', 'foldr', 'forEach', 'groupBy', 'include', 'inject', 'invoke', 'map', 'pluck', 'reduce', 'reduceRight', 'reject', 'select', 'size', 'some', 'sortBy', 'toArray', 'where' ]; /** List of "Functions" category methods */ var functionsMethods = [ 'after', 'bind', 'bindAll', 'compose', 'debounce', 'defer', 'delay', 'lateBind', 'memoize', 'once', 'partial', 'throttle', 'wrap' ]; /** List of "Objects" category methods */ var objectsMethods = [ 'clone', 'defaults', 'extend', 'forIn', 'forOwn', 'functions', 'has', 'invert', 'isArguments', 'isArray', 'isBoolean', 'isDate', 'isElement', 'isEmpty', 'isEqual', 'isFinite', 'isFunction', 'isNaN', 'isNull', 'isNumber', 'isObject', 'isPlainObject', 'isRegExp', 'isString', 'isUndefined', 'keys', 'methods', 'merge', 'omit', 'pairs', 'pick', 'values' ]; /** List of "Utilities" category methods */ var utilityMethods = [ 'escape', 'identity', 'noConflict', 'random', 'result', 'template', 'times', 'unescape', 'uniqueId' ]; /** List of Backbone's Lo-Dash dependencies */ var backboneDependencies = [ 'bind', 'bindAll', 'clone', 'contains', 'escape', 'every', 'extend', 'filter', 'find', 'first', 'forEach', 'groupBy', 'has', 'indexOf', 'initial', 'invoke', 'isArray', 'isEmpty', 'isEqual', 'isFunction', 'isObject', 'isRegExp', 'keys', 'last', 'lastIndexOf', 'map', 'max', 'min', 'mixin', 'reduce', 'reduceRight', 'reject', 'rest', 'result', 'shuffle', 'size', 'some', 'sortBy', 'sortedIndex', 'toArray', 'uniqueId', 'without' ]; /** List of methods used by Underscore */ var underscoreMethods = _.without.apply(_, [allMethods].concat([ 'forIn', 'forOwn', 'isPlainObject', 'lateBind', 'merge', 'partial' ])); /*--------------------------------------------------------------------------*/ /** * Creates a context object to use with `vm.runInContext`. * * @private * @returns {Object} Returns a new context object. */ function createContext() { return vm.createContext({ 'clearTimeout': clearTimeout, 'setTimeout': setTimeout }); } /** * Expands a list of method names to include real and alias names. * * @private * @param {Array} methodNames The array of method names to expand. * @returns {Array} Returns a new array of expanded method names. */ function expandMethodNames(methodNames) { return methodNames.reduce(function(result, methodName) { var realName = getRealName(methodName); result.push.apply(result, [realName].concat(getAliases(realName))); return result; }, []); } /** * Gets the aliases associated with a given function name. * * @private * @param {String} funcName The name of the function to get aliases for. * @returns {Array} Returns an array of aliases. */ function getAliases(funcName) { return realToAliasMap[funcName] || []; } /** * Gets the names of methods belonging to the given `category`. * * @private * @param {String} category The category to filter by. * @returns {Array} Returns a new array of method names belonging to the given category. */ function getMethodsByCategory(category) { switch (category) { case 'Arrays': return arraysMethods.slice(); case 'Chaining': return chainingMethods.slice(); case 'Collections': return collectionsMethods.slice(); case 'Functions': return functionsMethods.slice(); case 'Objects': return objectsMethods.slice(); case 'Utilities': return utilityMethods.slice(); } return []; } /** * Gets the real name, not alias, of a given function name. * * @private * @param {String} funcName The name of the function to resolve. * @returns {String} Returns the real name. */ function getRealName(funcName) { return aliasToRealMap[funcName] || funcName; } /** * Tests if a given method on the `lodash` object can be called successfully. * * @private * @param {Object} lodash The built Lo-Dash object. * @param {String} methodName The name of the Lo-Dash method to test. * @param {String} message The unit test message. */ function testMethod(lodash, methodName, message) { var pass = true, array = [['a', 1], ['b', 2], ['c', 3]], object = { 'a': 1, 'b': 2, 'c': 3 }, noop = function() {}, string = 'abc', func = lodash[methodName]; try { if (arraysMethods.indexOf(methodName) > -1) { if (/(?:indexOf|sortedIndex|without)$/i.test(methodName)) { func(array, string); } else if (/^(?:difference|intersection|union|uniq|zip)/.test(methodName)) { func(array, array); } else if (methodName == 'range') { func(2, 4); } else { func(array); } } else if (chainingMethods.indexOf(methodName) > -1) { if (methodName == 'chain') { lodash.chain(array); lodash(array).chain(); } else if (methodName == 'mixin') { lodash.mixin({}); } else { lodash(array)[methodName](noop); } } else if (collectionsMethods.indexOf(methodName) > -1) { if (/^(?:count|group|sort)By$/.test(methodName)) { func(array, noop); func(array, string); func(object, noop); func(object, string); } else if (/^(?:size|toArray)$/.test(methodName)) { func(array); func(object); } else if (methodName == 'invoke') { func(array, 'slice'); func(object, 'toFixed'); } else if (methodName == 'where') { func(array, object); func(object, object); } else { func(array, noop, object); func(object, noop, object); } } else if (functionsMethods.indexOf(methodName) > -1) { if (methodName == 'after') { func(1, noop); } else if (methodName == 'bindAll') { func({ 'noop': noop }); } else if (methodName == 'lateBind') { func(lodash, 'identity', array, string); } else if (/^(?:bind|partial)$/.test(methodName)) { func(noop, object, array, string); } else if (/^(?:compose|memoize|wrap)$/.test(methodName)) { func(noop, noop); } else if (/^(?:debounce|throttle)$/.test(methodName)) { func(noop, 100); } else { func(noop); } } else if (objectsMethods.indexOf(methodName) > -1) { if (methodName == 'clone') { func(object); func(object, true); } else if (/^(?:defaults|extend|merge)$/.test(methodName)) { func({}, object); } else if (/^(?:forIn|forOwn)$/.test(methodName)) { func(object, noop); } else if (/^(?:omit|pick)$/.test(methodName)) { func(object, 'b'); } else if (methodName == 'has') { func(object, string); } else { func(object); } } else if (utilityMethods.indexOf(methodName) > -1) { if (methodName == 'result') { func(object, 'b'); } else if (methodName == 'times') { func(2, noop, object); } else { func(string, object); } } } catch(e) { console.log(e); pass = false; } equal(pass, true, '_.' + methodName + ': ' + message); } /*--------------------------------------------------------------------------*/ QUnit.module('minified AMD snippet'); (function() { var start = _.once(QUnit.start); asyncTest('`lodash`', function() { build(['-s'], function(source, filePath) { // used by r.js build optimizer var defineHasRegExp = /typeof\s+define\s*==(=)?\s*['"]function['"]\s*&&\s*typeof\s+define\.amd\s*==(=)?\s*['"]object['"]\s*&&\s*define\.amd/g, basename = path.basename(filePath, '.js'); ok(!!defineHasRegExp.exec(source), basename); start(); }); }); }()); /*--------------------------------------------------------------------------*/ QUnit.module('template builds'); (function() { var templatePath = __dirname + '/template'; asyncTest('`lodash template=*.jst`', function() { var start = _.after(2, _.once(QUnit.start)); build(['-s', 'template=' + templatePath + '/*.jst'], function(source, filePath) { var basename = path.basename(filePath, '.js'), context = createContext(); var data = { 'a': { 'people': ['moe', 'larry', 'curly'] }, 'b': { 'epithet': 'stooge' } }; context._ = _; vm.runInContext(source, context); var templates = context._.templates; equal(templates.a(data.a).replace(/[\r\n]+/g, ''), '', basename); equal(templates.b(data.b), 'Hello stooge.', basename); start(); }); }); asyncTest('`lodash settings=...`', function() { var start = _.after(2, _.once(QUnit.start)); build(['-s', 'template=' + templatePath + '/*.tpl', 'settings={interpolate:/\\{\\{([\\s\\S]+?)\\}\\}/}'], function(source, filePath) { var basename = path.basename(filePath, '.js'), context = createContext(); var data = { 'c': { 'name': 'Mustache' } }; context._ = _; vm.runInContext(source, context); var templates = context._.templates; equal(templates.c(data.c), 'Hello Mustache!', basename); start(); }); }); }()); /*--------------------------------------------------------------------------*/ QUnit.module('independent builds'); (function() { asyncTest('debug only', function() { var start = _.once(QUnit.start); build(['-d', '-s'], function(source, filePath) { equal(path.basename(filePath, '.js'), 'lodash'); start(); }); }); asyncTest('debug custom', function () { var start = _.once(QUnit.start); build(['-d', '-s', 'backbone'], function(source, filePath) { equal(path.basename(filePath, '.js'), 'lodash.custom'); start(); }); }); asyncTest('minified only', function() { var start = _.once(QUnit.start); build(['-m', '-s'], function(source, filePath) { equal(path.basename(filePath, '.js'), 'lodash.min'); start(); }); }); asyncTest('minified custom', function () { var start = _.once(QUnit.start); build(['-m', '-s', 'backbone'], function(source, filePath) { equal(path.basename(filePath, '.js'), 'lodash.custom.min'); start(); }); }); }()); /*--------------------------------------------------------------------------*/ QUnit.module('strict modifier'); (function() { var object = Object.create(Object.prototype, { 'a': { 'value': _.identify }, 'b': { 'value': null } }); ['non-strict', 'strict'].forEach(function(strictMode, index) { asyncTest(strictMode + ' should ' + (index ? 'error': 'silently fail') + ' attempting to overwrite read-only properties', function() { var commands = ['-s', 'include=bindAll,defaults,extend'], start = _.after(2, _.once(QUnit.start)); if (index) { commands.push('strict'); } build(commands, function(source, filePath) { var basename = path.basename(filePath, '.js'), context = createContext(), pass = !index; vm.runInContext(source, context); var lodash = context._; try { lodash.bindAll(object); lodash.extend(object, { 'a': 1 }); lodash.defaults(object, { 'b': 2 }); } catch(e) { pass = !!index; } equal(pass, true, basename); start(); }); }); }); }()); /*--------------------------------------------------------------------------*/ QUnit.module('underscore modifier'); (function() { asyncTest('modified methods should work correctly', function() { var start = _.after(2, _.once(QUnit.start)); build(['-s', 'underscore'], function(source, filePath) { var last, array = [{ 'value': 1 }, { 'value': 2 }], basename = path.basename(filePath, '.js'), context = createContext(); vm.runInContext(source, context); var lodash = context._; lodash.each(array, function(value) { last = value; return false; }); equal(last.value, 2, '_.each: ' + basename); equal(lodash.isEmpty('moe'), false, '_.isEmpty: ' + basename); var object = { 'fn': lodash.bind(function(x) { return this.x + x; }, { 'x': 1 }, 1) }; equal(object.fn(), 2, '_.bind: ' + basename); ok(lodash.clone(array, true)[0] === array[0], '_.clone: ' + basename); start(); }); }); asyncTest('`lodash underscore include=partial`', function() { var start = _.after(2, _.once(QUnit.start)); build(['-s', 'underscore', 'include=partial'], function(source, filePath) { var basename = path.basename(filePath, '.js'), context = createContext(); vm.runInContext(source, context); var lodash = context._; equal(lodash.partial(_.identity, 2)(), 2, '_.partial: ' + basename); start(); }); }); asyncTest('`lodash underscore plus=clone`', function() { var start = _.after(2, _.once(QUnit.start)); build(['-s', 'underscore', 'plus=clone'], function(source, filePath) { var array = [{ 'value': 1 }], basename = path.basename(filePath, '.js'), context = createContext(); vm.runInContext(source, context); var lodash = context._, clone = lodash.clone(array, true); deepEqual(array, clone, basename); notEqual(array, clone, basename); start(); }); }); }()); /*--------------------------------------------------------------------------*/ QUnit.module('exports command'); (function() { var commands = [ 'exports=amd', 'exports=commonjs', 'exports=global', 'exports=node', 'exports=none' ]; commands.forEach(function(command, index) { asyncTest('`lodash ' + command +'`', function() { var start = _.after(2, _.once(QUnit.start)); build(['-s', command], function(source, filePath) { var basename = path.basename(filePath, '.js'), context = createContext(), pass = false; switch(index) { case 0: context.define = function(fn) { pass = true; context._ = fn(); }; context.define.amd = {}; vm.runInContext(source, context); ok(pass, basename); break; case 1: context.exports = {}; vm.runInContext(source, context); ok(context._ === undefined, basename); ok(_.isFunction(context.exports._), basename) break; case 2: vm.runInContext(source, context); ok(_.isFunction(context._), basename); break; case 3: context.exports = {}; context.module = { 'exports': context.exports }; vm.runInContext(source, context); ok(context._ === undefined, basename); ok(_.isFunction(context.module.exports), basename); break; case 4: vm.runInContext(source, context); ok(context._ === undefined, basename); } start(); }); }); }); }()); /*--------------------------------------------------------------------------*/ QUnit.module('iife command'); (function() { var commands = [ 'iife=this["lodash"]=(function(window,undefined){%output%;return lodash}(this))', 'iife=define(function(window,undefined){return function(){%output%;return lodash}}(this));' ]; commands.forEach(function(command) { asyncTest('`lodash ' + command +'`', function() { var start = _.after(2, _.once(QUnit.start)); build(['-s', 'exports=none', command], function(source, filePath) { var basename = path.basename(filePath, '.js'), context = createContext(); context.define = function(func) { context.lodash = func(); }; try { vm.runInContext(source, context); } catch(e) { console.log(e); } var lodash = context.lodash || {}; ok(_.isString(lodash.VERSION), basename); start(); }); }); }); }()); /*--------------------------------------------------------------------------*/ QUnit.module('output options'); (function() { ['-o a.js', '--output a.js'].forEach(function(command, index) { asyncTest('`lodash ' + command +'`', function() { var start = _.once(QUnit.start); build(['-s'].concat(command.split(' ')), function(source, filePath) { equal(path.basename(filePath, '.js'), 'a', command); start(); }); }); }); }()); /*--------------------------------------------------------------------------*/ QUnit.module('stdout options'); (function() { ['-c', '--stdout'].forEach(function(command, index) { asyncTest('`lodash ' + command +'`', function() { var written, start = _.once(QUnit.start), write = process.stdout.write; process.stdout.write = function(string) { written = string; }; build([command, 'exports=', 'include='], function(source) { process.stdout.write = write; equal(written, source); equal(arguments.length, 1); start(); }); }); }); }()); /*--------------------------------------------------------------------------*/ QUnit.module('minify underscore'); (function() { asyncTest('`node minify underscore.js`', function() { var source = fs.readFileSync(path.join(__dirname, '..', 'vendor', 'underscore', 'underscore.js'), 'utf8'), start = _.once(QUnit.start); minify(source, { 'silent': true, 'workingName': 'underscore.min', 'onComplete': function(result) { var context = createContext(); try { vm.runInContext(result, context); } catch(e) { console.log(e); } var underscore = context._ || {}; ok(_.isString(underscore.VERSION)); ok(!/Lo-Dash/.test(result) && result.match(/\n/g).length < source.match(/\n/g).length); start(); } }); }); }()); /*--------------------------------------------------------------------------*/ QUnit.module('mobile build'); (function() { asyncTest('`lodash mobile`', function() { var start = _.after(2, _.once(QUnit.start)); build(['-s', 'mobile'], function(source, filePath) { var basename = path.basename(filePath, '.js'), context = createContext(); try { vm.runInContext(source, context); } catch(e) { console.log(e); } var array = [1, 2, 3], object1 = [{ 'a': 1 }], object2 = [{ 'b': 2 }], object3 = [{ 'a': 1, 'b': 2 }], circular1 = { 'a': 1 }, circular2 = { 'a': 1 }, lodash = context._; circular1.b = circular1; circular2.b = circular2; deepEqual(lodash.merge(object1, object2), object3, basename); deepEqual(lodash.sortBy([3, 2, 1], _.identity), array, basename); equal(lodash.isEqual(circular1, circular2), true, basename); var actual = lodash.clone(circular1, true); ok(actual != circular1 && actual.b == actual, basename); start(); }); }); }()); /*--------------------------------------------------------------------------*/ QUnit.module('lodash build'); (function() { var commands = [ 'backbone', 'csp', 'legacy', 'mobile', 'strict', 'underscore', 'category=arrays', 'category=chaining', 'category=collections', 'category=functions', 'category=objects', 'category=utilities', 'exclude=union,uniq,zip', 'include=each,filter,map', 'include=once plus=bind,Chaining', 'category=collections,functions', 'underscore backbone', 'backbone legacy category=utilities minus=first,last', 'underscore include=debounce,throttle plus=after minus=throttle', 'underscore mobile strict category=functions exports=amd,global plus=pick,uniq', ] .concat( allMethods.map(function(methodName) { return 'include=' + methodName; }) ); commands.forEach(function(command) { asyncTest('`lodash ' + command +'`', function() { var start = _.after(2, _.once(QUnit.start)); build(['--silent'].concat(command.split(' ')), function(source, filePath) { var methodNames, basename = path.basename(filePath, '.js'), context = createContext(); try { vm.runInContext(source, context); } catch(e) { console.log(e); } // add method names explicitly if (/include/.test(command)) { methodNames = command.match(/include=(\S*)/)[1].split(/, */); } // add method names required by Backbone and Underscore builds if (/backbone/.test(command) && !methodNames) { methodNames = backboneDependencies.slice(); } if (/underscore/.test(command) && !methodNames) { methodNames = underscoreMethods.slice(); } // add method names explicitly by category if (/category/.test(command)) { // resolve method names belonging to each category (case-insensitive) methodNames = command.match(/category=(\S*)/)[1].split(/, */).reduce(function(result, category) { var capitalized = category[0].toUpperCase() + category.toLowerCase().slice(1); return result.concat(getMethodsByCategory(capitalized)); }, methodNames || []); } // init `methodNames` if it hasn't been inited if (!methodNames) { methodNames = allMethods.slice(); } if (/plus/.test(command)) { methodNames = methodNames.concat(command.match(/plus=(\S*)/)[1].split(/, */)); } if (/minus/.test(command)) { methodNames = _.without.apply(_, [methodNames] .concat(expandMethodNames(command.match(/minus=(\S*)/)[1].split(/, */)))); } if (/exclude/.test(command)) { methodNames = _.without.apply(_, [methodNames] .concat(expandMethodNames(command.match(/exclude=(\S*)/)[1].split(/, */)))); } // expand aliases and categories to real method names methodNames = expandMethodNames(methodNames).reduce(function(result, methodName) { return result.concat(methodName, getMethodsByCategory(methodName)); }, []); // remove nonexistent and duplicate method names methodNames = _.uniq(_.intersection(allMethods, expandMethodNames(methodNames))); var lodash = context._ || {}; methodNames.forEach(function(methodName) { testMethod(lodash, methodName, basename); }); start(); }); }); }); }()); }());