mocha 5.0.4 → 5.2.0

package/lib/utils.js

@@ -1,5 +1,9 @@
 'use strict';
 
+/**
+ * @module
+ */
+
 /**
  * Module dependencies.
  */
@@ -26,8 +30,8 @@ exports.inherits = require('util').inherits;
  * @param  {string} html
  * @return {string}
  */
-exports.escape = function (html) {
-  return he.encode(String(html), { useNamedReferences: false });
+exports.escape = function(html) {
+  return he.encode(String(html), {useNamedReferences: false});
 };
 
 /**
@@ -37,7 +41,7 @@ exports.escape = function (html) {
  * @param {Object} obj
  * @return {boolean}
  */
-exports.isString = function (obj) {
+exports.isString = function(obj) {
   return typeof obj === 'string';
 };
 
@@ -49,11 +53,11 @@ exports.isString = function (obj) {
  * @param {Array} files
  * @param {Function} fn
  */
-exports.watch = function (files, fn) {
-  var options = { interval: 100 };
-  files.forEach(function (file) {
+exports.watch = function(files, fn) {
+  var options = {interval: 100};
+  files.forEach(function(file) {
     debug('file %s', file);
-    fs.watchFile(file, options, function (curr, prev) {
+    fs.watchFile(file, options, function(curr, prev) {
       if (prev.mtime < curr.mtime) {
         fn(file);
       }
@@ -68,7 +72,7 @@ exports.watch = function (files, fn) {
  * @param {string} path
  * @return {boolean}
  */
-function ignored (path) {
+function ignored(path) {
   return !~ignore.indexOf(path);
 }
 
@@ -81,15 +85,16 @@ function ignored (path) {
  * @param {Array} [ret=[]]
  * @return {Array}
  */
-exports.files = function (dir, ext, ret) {
+exports.files = function(dir, ext, ret) {
   ret = ret || [];
   ext = ext || ['js'];
 
   var re = new RegExp('\\.(' + ext.join('|') + ')$');
 
-  fs.readdirSync(dir)
+  fs
+    .readdirSync(dir)
     .filter(ignored)
-    .forEach(function (path) {
+    .forEach(function(path) {
       path = join(dir, path);
       if (fs.lstatSync(path).isDirectory()) {
         exports.files(path, ext, ret);
@@ -108,7 +113,7 @@ exports.files = function (dir, ext, ret) {
  * @param {string} str
  * @return {string}
  */
-exports.slug = function (str) {
+exports.slug = function(str) {
   return str
     .toLowerCase()
     .replace(/ +/g, '-')
@@ -121,15 +126,22 @@ exports.slug = function (str) {
  * @param {string} str
  * @return {string}
  */
-exports.clean = function (str) {
+exports.clean = function(str) {
   str = str
-    .replace(/\r\n?|[\n\u2028\u2029]/g, '\n').replace(/^\uFEFF/, '')
+    .replace(/\r\n?|[\n\u2028\u2029]/g, '\n')
+    .replace(/^\uFEFF/, '')
     // (traditional)->  space/name     parameters    body     (lambda)-> parameters       body   multi-statement/single          keep body content
-    .replace(/^function(?:\s*|\s+[^(]*)\([^)]*\)\s*\{((?:.|\n)*?)\s*\}$|^\([^)]*\)\s*=>\s*(?:\{((?:.|\n)*?)\s*\}|((?:.|\n)*))$/, '$1$2$3');
+    .replace(
+      /^function(?:\s*|\s+[^(]*)\([^)]*\)\s*\{((?:.|\n)*?)\s*\}$|^\([^)]*\)\s*=>\s*(?:\{((?:.|\n)*?)\s*\}|((?:.|\n)*))$/,
+      '$1$2$3'
+    );
 
   var spaces = str.match(/^\n?( *)/)[1].length;
   var tabs = str.match(/^\n?(\t*)/)[1].length;
-  var re = new RegExp('^\n?' + (tabs ? '\t' : ' ') + '{' + (tabs || spaces) + '}', 'gm');
+  var re = new RegExp(
+    '^\n?' + (tabs ? '\t' : ' ') + '{' + (tabs || spaces) + '}',
+    'gm'
+  );
 
   str = str.replace(re, '');
 
@@ -143,17 +155,20 @@ exports.clean = function (str) {
  * @param {string} qs
  * @return {Object}
  */
-exports.parseQuery = function (qs) {
-  return qs.replace('?', '').split('&').reduce(function (obj, pair) {
-    var i = pair.indexOf('=');
-    var key = pair.slice(0, i);
-    var val = pair.slice(++i);
-
-    // Due to how the URLSearchParams API treats spaces
-    obj[key] = decodeURIComponent(val.replace(/\+/g, '%20'));
-
-    return obj;
-  }, {});
+exports.parseQuery = function(qs) {
+  return qs
+    .replace('?', '')
+    .split('&')
+    .reduce(function(obj, pair) {
+      var i = pair.indexOf('=');
+      var key = pair.slice(0, i);
+      var val = pair.slice(++i);
+
+      // Due to how the URLSearchParams API treats spaces
+      obj[key] = decodeURIComponent(val.replace(/\+/g, '%20'));
+
+      return obj;
+    }, {});
 };
 
 /**
@@ -163,7 +178,7 @@ exports.parseQuery = function (qs) {
  * @param {string} js
  * @return {string}
  */
-function highlight (js) {
+function highlight(js) {
   return js
     .replace(/</g, '&lt;')
     .replace(/>/g, '&gt;')
@@ -171,8 +186,14 @@ function highlight (js) {
     .replace(/('.*?')/gm, '<span class="string">$1</span>')
     .replace(/(\d+\.\d+)/gm, '<span class="number">$1</span>')
     .replace(/(\d+)/gm, '<span class="number">$1</span>')
-    .replace(/\bnew[ \t]+(\w+)/gm, '<span class="keyword">new</span> <span class="init">$1</span>')
-    .replace(/\b(function|new|throw|return|var|if|else)\b/gm, '<span class="keyword">$1</span>');
+    .replace(
+      /\bnew[ \t]+(\w+)/gm,
+      '<span class="keyword">new</span> <span class="init">$1</span>'
+    )
+    .replace(
+      /\b(function|new|throw|return|var|if|else)\b/gm,
+      '<span class="keyword">$1</span>'
+    );
 }
 
 /**
@@ -181,7 +202,7 @@ function highlight (js) {
  * @api private
  * @param {string} name
  */
-exports.highlightTags = function (name) {
+exports.highlightTags = function(name) {
   var code = document.getElementById('mocha').getElementsByTagName(name);
   for (var i = 0, len = code.length; i < len; ++i) {
     code[i].innerHTML = highlight(code[i].innerHTML);
@@ -202,7 +223,7 @@ exports.highlightTags = function (name) {
  * @param {string} typeHint The type of the value
  * @returns {string}
  */
-function emptyRepresentation (value, typeHint) {
+function emptyRepresentation(value, typeHint) {
   switch (typeHint) {
     case 'function':
       return '[Function]';
@@ -236,7 +257,7 @@ function emptyRepresentation (value, typeHint) {
  * type(global) // 'global'
  * type(new String('foo') // 'object'
  */
-var type = exports.type = function type (value) {
+var type = (exports.type = function type(value) {
   if (value === undefined) {
     return 'undefined';
   } else if (value === null) {
@@ -244,10 +265,11 @@ var type = exports.type = function type (value) {
   } else if (Buffer.isBuffer(value)) {
     return 'buffer';
   }
-  return Object.prototype.toString.call(value)
+  return Object.prototype.toString
+    .call(value)
     .replace(/^\[.+\s(.+?)]$/, '$1')
     .toLowerCase();
-};
+});
 
 /**
  * Stringify `value`. Different behavior depending on type of value:
@@ -264,21 +286,23 @@ var type = exports.type = function type (value) {
  * @param {*} value
  * @return {string}
  */
-exports.stringify = function (value) {
+exports.stringify = function(value) {
   var typeHint = type(value);
 
   if (!~['object', 'array', 'function'].indexOf(typeHint)) {
     if (typeHint === 'buffer') {
       var json = Buffer.prototype.toJSON.call(value);
       // Based on the toJSON result
-      return jsonStringify(json.data && json.type ? json.data : json, 2)
-        .replace(/,(\n|$)/g, '$1');
+      return jsonStringify(
+        json.data && json.type ? json.data : json,
+        2
+      ).replace(/,(\n|$)/g, '$1');
     }
 
     // IE7/IE8 has a bizarre String constructor; needs to be coerced
     // into an array and back to obj.
     if (typeHint === 'string' && typeof value === 'object') {
-      value = value.split('').reduce(function (acc, char, idx) {
+      value = value.split('').reduce(function(acc, char, idx) {
         acc[idx] = char;
         return acc;
       }, {});
@@ -290,7 +314,10 @@ exports.stringify = function (value) {
 
   for (var prop in value) {
     if (Object.prototype.hasOwnProperty.call(value, prop)) {
-      return jsonStringify(exports.canonicalize(value, null, typeHint), 2).replace(/,(\n|$)/g, '$1');
+      return jsonStringify(
+        exports.canonicalize(value, null, typeHint),
+        2
+      ).replace(/,(\n|$)/g, '$1');
     }
   }
 
@@ -306,7 +333,7 @@ exports.stringify = function (value) {
  * @param {number=} depth
  * @returns {*}
  */
-function jsonStringify (object, spaces, depth) {
+function jsonStringify(object, spaces, depth) {
   if (typeof spaces === 'undefined') {
     // primitive types
     return _stringify(object);
@@ -316,13 +343,16 @@ function jsonStringify (object, spaces, depth) {
   var space = spaces * depth;
   var str = Array.isArray(object) ? '[' : '{';
   var end = Array.isArray(object) ? ']' : '}';
-  var length = typeof object.length === 'number' ? object.length : Object.keys(object).length;
+  var length =
+    typeof object.length === 'number'
+      ? object.length
+      : Object.keys(object).length;
   // `.repeat()` polyfill
-  function repeat (s, n) {
+  function repeat(s, n) {
     return new Array(n).join(s);
   }
 
-  function _stringify (val) {
+  function _stringify(val) {
     switch (type(val)) {
       case 'null':
       case 'undefined':
@@ -336,9 +366,10 @@ function jsonStringify (object, spaces, depth) {
       case 'regexp':
       case 'symbol':
       case 'number':
-        val = val === 0 && (1 / val) === -Infinity // `-0`
-          ? '-0'
-          : val.toString();
+        val =
+          val === 0 && 1 / val === -Infinity // `-0`
+            ? '-0'
+            : val.toString();
         break;
       case 'date':
         var sDate = isNaN(val.getTime()) ? val.toString() : val.toISOString();
@@ -351,9 +382,10 @@ function jsonStringify (object, spaces, depth) {
         val = '[Buffer: ' + jsonStringify(json, 2, depth + 1) + ']';
         break;
       default:
-        val = (val === '[Function]' || val === '[Circular]')
-          ? val
-          : JSON.stringify(val); // string
+        val =
+          val === '[Function]' || val === '[Circular]'
+            ? val
+            : JSON.stringify(val); // string
     }
     return val;
   }
@@ -363,15 +395,19 @@ function jsonStringify (object, spaces, depth) {
       continue; // not my business
     }
     --length;
-    str += '\n ' + repeat(' ', space) +
+    str +=
+      '\n ' +
+      repeat(' ', space) +
       (Array.isArray(object) ? '' : '"' + i + '": ') + // key
       _stringify(object[i]) + // value
       (length ? ',' : ''); // comma
   }
 
-  return str +
+  return (
+    str +
     // [], {}
-    (str.length !== 1 ? '\n' + repeat(' ', --space) + end : end);
+    (str.length !== 1 ? '\n' + repeat(' ', --space) + end : end)
+  );
 }
 
 /**
@@ -393,13 +429,13 @@ function jsonStringify (object, spaces, depth) {
  * @param {string} [typeHint] Type hint
  * @return {(Object|Array|Function|string|undefined)}
  */
-exports.canonicalize = function canonicalize (value, stack, typeHint) {
+exports.canonicalize = function canonicalize(value, stack, typeHint) {
   var canonicalizedObj;
   /* eslint-disable no-unused-vars */
   var prop;
   /* eslint-enable no-unused-vars */
   typeHint = typeHint || type(value);
-  function withStack (value, fn) {
+  function withStack(value, fn) {
     stack.push(value);
     fn();
     stack.pop();
@@ -418,8 +454,8 @@ exports.canonicalize = function canonicalize (value, stack, typeHint) {
       canonicalizedObj = value;
       break;
     case 'array':
-      withStack(value, function () {
-        canonicalizedObj = value.map(function (item) {
+      withStack(value, function() {
+        canonicalizedObj = value.map(function(item) {
           return exports.canonicalize(item, stack);
         });
       });
@@ -438,10 +474,12 @@ exports.canonicalize = function canonicalize (value, stack, typeHint) {
     /* falls through */
     case 'object':
       canonicalizedObj = canonicalizedObj || {};
-      withStack(value, function () {
-        Object.keys(value).sort().forEach(function (key) {
-          canonicalizedObj[key] = exports.canonicalize(value[key], stack);
-        });
+      withStack(value, function() {
+        Object.keys(value)
+          .sort()
+          .forEach(function(key) {
+            canonicalizedObj[key] = exports.canonicalize(value[key], stack);
+          });
       });
       break;
     case 'date':
@@ -461,13 +499,15 @@ exports.canonicalize = function canonicalize (value, stack, typeHint) {
 /**
  * Lookup file names at the given `path`.
  *
+ * @memberof Mocha.utils
+ * @public
  * @api public
  * @param {string} filepath Base path to start searching from.
  * @param {string[]} extensions File extensions to look for.
  * @param {boolean} recursive Whether or not to recurse into subdirectories.
  * @return {string[]} An array of paths.
  */
-exports.lookupFiles = function lookupFiles (filepath, extensions, recursive) {
+exports.lookupFiles = function lookupFiles(filepath, extensions, recursive) {
   var files = [];
 
   if (!fs.existsSync(filepath)) {
@@ -492,7 +532,7 @@ exports.lookupFiles = function lookupFiles (filepath, extensions, recursive) {
     return;
   }
 
-  fs.readdirSync(filepath).forEach(function (file) {
+  fs.readdirSync(filepath).forEach(function(file) {
     file = path.join(filepath, file);
     try {
       var stat = fs.statSync(file);
@@ -506,6 +546,11 @@ exports.lookupFiles = function lookupFiles (filepath, extensions, recursive) {
       // ignore error
       return;
     }
+    if (!extensions) {
+      throw new Error(
+        'extensions parameter required when filepath is a directory'
+      );
+    }
     var re = new RegExp('\\.(?:' + extensions.join('|') + ')$');
     if (!stat.isFile() || !re.test(file) || path.basename(file)[0] === '.') {
       return;
@@ -522,8 +567,10 @@ exports.lookupFiles = function lookupFiles (filepath, extensions, recursive) {
  * @return {Error}
  */
 
-exports.undefinedError = function () {
-  return new Error('Caught undefined error, did you throw without specifying what?');
+exports.undefinedError = function() {
+  return new Error(
+    'Caught undefined error, did you throw without specifying what?'
+  );
 };
 
 /**
@@ -533,7 +580,7 @@ exports.undefinedError = function () {
  * @return {Error}
  */
 
-exports.getError = function (err) {
+exports.getError = function(err) {
   return err || exports.undefinedError();
 };
 
@@ -546,9 +593,9 @@ exports.getError = function (err) {
  * (i.e: strip Mocha and internal node functions from stack trace).
  * @returns {Function}
  */
-exports.stackTraceFilter = function () {
+exports.stackTraceFilter = function() {
   // TODO: Replace with `process.browser`
-  var is = typeof document === 'undefined' ? { node: true } : { browser: true };
+  var is = typeof document === 'undefined' ? {node: true} : {browser: true};
   var slash = path.sep;
   var cwd;
   if (is.node) {
@@ -556,30 +603,35 @@ exports.stackTraceFilter = function () {
   } else {
     cwd = (typeof location === 'undefined'
       ? window.location
-      : location).href.replace(/\/[^/]*$/, '/');
+      : location
+    ).href.replace(/\/[^/]*$/, '/');
     slash = '/';
   }
 
-  function isMochaInternal (line) {
-    return (~line.indexOf('node_modules' + slash + 'mocha' + slash)) ||
-      (~line.indexOf('node_modules' + slash + 'mocha.js')) ||
-      (~line.indexOf('bower_components' + slash + 'mocha.js')) ||
-      (~line.indexOf(slash + 'mocha.js'));
+  function isMochaInternal(line) {
+    return (
+      ~line.indexOf('node_modules' + slash + 'mocha' + slash) ||
+      ~line.indexOf('node_modules' + slash + 'mocha.js') ||
+      ~line.indexOf('bower_components' + slash + 'mocha.js') ||
+      ~line.indexOf(slash + 'mocha.js')
+    );
   }
 
-  function isNodeInternal (line) {
-    return (~line.indexOf('(timers.js:')) ||
-      (~line.indexOf('(events.js:')) ||
-      (~line.indexOf('(node.js:')) ||
-      (~line.indexOf('(module.js:')) ||
-      (~line.indexOf('GeneratorFunctionPrototype.next (native)')) ||
-      false;
+  function isNodeInternal(line) {
+    return (
+      ~line.indexOf('(timers.js:') ||
+      ~line.indexOf('(events.js:') ||
+      ~line.indexOf('(node.js:') ||
+      ~line.indexOf('(module.js:') ||
+      ~line.indexOf('GeneratorFunctionPrototype.next (native)') ||
+      false
+    );
   }
 
-  return function (stack) {
+  return function(stack) {
     stack = stack.split('\n');
 
-    stack = stack.reduce(function (list, line) {
+    stack = stack.reduce(function(list, line) {
       if (isMochaInternal(line)) {
         return list;
       }
@@ -607,7 +659,7 @@ exports.stackTraceFilter = function () {
  * @param {*} value
  * @returns {boolean} Whether or not `value` is a Promise
  */
-exports.isPromise = function isPromise (value) {
+exports.isPromise = function isPromise(value) {
   return typeof value === 'object' && typeof value.then === 'function';
 };
 
@@ -615,4 +667,4 @@ exports.isPromise = function isPromise (value) {
  * It's a noop.
  * @api
  */
-exports.noop = function () {};
+exports.noop = function() {};