module mocha-webpack
1. function mocha-webpack.base (runner)
2. object mocha-webpack.InjectChangedFilesPlugin
3. object mocha-webpack.base.prototype
4. object mocha-webpack.checkReporter
5. object mocha-webpack.configureMocha
6. object mocha-webpack.contextReplacementPlugin
7. object mocha-webpack.createCompiler
8. object mocha-webpack.exists
9. object mocha-webpack.parseArgv
10. object mocha-webpack.parseConfig
11. object mocha-webpack.prepareEntry
12. object mocha-webpack.prepareWebpack
13. object mocha-webpack.requireWebpackConfig
14. object mocha-webpack.resetMocha
15. object mocha-webpack.runner
16. object mocha-webpack.utils
17. object mocha-webpack.watch
module mocha-webpack.InjectChangedFilesPlugin
1. function mocha-webpack.InjectChangedFilesPlugin.default ()
module mocha-webpack.base
1. boolean mocha-webpack.base.inlineDiffs
2. boolean mocha-webpack.base.useColors
3. function mocha-webpack.base (runner)
4. function mocha-webpack.base.color (type, str)
5. function mocha-webpack.base.list (failures)
6. object mocha-webpack.base.colors
7. object mocha-webpack.base.cursor
8. object mocha-webpack.base.symbols
9. object mocha-webpack.base.window
module mocha-webpack.base.prototype
1. function mocha-webpack.base.prototype.epilogue ()
module mocha-webpack.checkReporter
1. function mocha-webpack.checkReporter.default (reporter)
module mocha-webpack.configureMocha
1. function mocha-webpack.configureMocha.default ()
module mocha-webpack.contextReplacementPlugin
1. function mocha-webpack.contextReplacementPlugin.default (context, matcher)
module mocha-webpack.createCompiler
1. function mocha-webpack.createCompiler.default (webpackConfig)
module mocha-webpack.exists
1. function mocha-webpack.exists.existsDirSync (file)
2. function mocha-webpack.exists.existsFileSync (file)
module mocha-webpack.parseArgv
1. function mocha-webpack.parseArgv.default (argv)
module mocha-webpack.parseConfig
1. function mocha-webpack.parseConfig.default (explicitConfig)
module mocha-webpack.prepareEntry
1. function mocha-webpack.prepareEntry.default (path)
module mocha-webpack.prepareWebpack
1. function mocha-webpack.prepareWebpack.default (options, cb)
module mocha-webpack.requireWebpackConfig
1. function mocha-webpack.requireWebpackConfig.default (webpackConfig)
module mocha-webpack.resetMocha
1. function mocha-webpack.resetMocha.default (mocha, options)
module mocha-webpack.runner
1. function mocha-webpack.runner.run (options, webpackConfig)
2. function mocha-webpack.runner.watch (options, webpackConfig)
module mocha-webpack.utils
module mocha-webpack.watch
1. function mocha-webpack.watch.default (webpackConfig, cb)

module mocha-webpack

function mocha-webpack.base (runner)

description and source-code

function Base(runner) {
  var stats = this.stats = { suites: 0, tests: 0, passes: 0, pending: 0, failures: 0 };
  var failures = this.failures = [];

  if (!runner) {
    return;
  }
  this.runner = runner;

  runner.stats = stats;

  runner.on('start', function() {
    stats.start = new Date();
  });

  runner.on('suite', function(suite) {
    stats.suites = stats.suites || 0;
    suite.root || stats.suites++;
  });

  runner.on('test end', function() {
    stats.tests = stats.tests || 0;
    stats.tests++;
  });

  runner.on('pass', function(test) {
    stats.passes = stats.passes || 0;

    if (test.duration > test.slow()) {
      test.speed = 'slow';
    } else if (test.duration > test.slow() / 2) {
      test.speed = 'medium';
    } else {
      test.speed = 'fast';
    }

    stats.passes++;
  });

  runner.on('fail', function(test, err) {
    stats.failures = stats.failures || 0;
    stats.failures++;
    test.err = err;
    failures.push(test);
  });

  runner.on('end', function() {
    stats.end = new Date();
    stats.duration = new Date() - stats.start;
  });

  runner.on('pending', function() {
    stats.pending++;
  });
}

example usage
```
n/a
```

module mocha-webpack.InjectChangedFilesPlugin

function mocha-webpack.InjectChangedFilesPlugin.default ()

description and source-code

function InjectChangedFilesPlugin() {
  var _this = this;

  _classCallCheck(this, InjectChangedFilesPlugin);

  this.testsCompleted = function (failed) {
    if (failed) {
      [].push.apply(_this.failedFiles, _this.hotFiles);
    } else {
      _this.failedFiles = [];
    }
  };

  this.failedFiles = [];
  this.hotFiles = [];
}

example usage

...
function prepareWebpack(options, cb) {
var _options$files = _slicedToArray(options.files, 1);

var file = _options$files[0];

var glob = (0, _isGlob2.default)(file);

var webpackInfoPlugin = new _webpackInfoPlugin2.default({
  stats: {
    // pass options from http://webpack.github.io/docs/node.js-api.html#stats-tostring
    // context: false,
    hash: false,
    version: false,
    timings: false,
    assets: false,
...

module mocha-webpack.base

function mocha-webpack.base (runner)

description and source-code

function Base(runner) {
  var stats = this.stats = { suites: 0, tests: 0, passes: 0, pending: 0, failures: 0 };
  var failures = this.failures = [];

  if (!runner) {
    return;
  }
  this.runner = runner;

  runner.stats = stats;

  runner.on('start', function() {
    stats.start = new Date();
  });

  runner.on('suite', function(suite) {
    stats.suites = stats.suites || 0;
    suite.root || stats.suites++;
  });

  runner.on('test end', function() {
    stats.tests = stats.tests || 0;
    stats.tests++;
  });

  runner.on('pass', function(test) {
    stats.passes = stats.passes || 0;

    if (test.duration > test.slow()) {
      test.speed = 'slow';
    } else if (test.duration > test.slow() / 2) {
      test.speed = 'medium';
    } else {
      test.speed = 'fast';
    }

    stats.passes++;
  });

  runner.on('fail', function(test, err) {
    stats.failures = stats.failures || 0;
    stats.failures++;
    test.err = err;
    failures.push(test);
  });

  runner.on('end', function() {
    stats.end = new Date();
    stats.duration = new Date() - stats.start;
  });

  runner.on('pending', function() {
    stats.pending++;
  });
}

example usage
```
n/a
```

function mocha-webpack.base.color (type, str)

description and source-code

color = function (type, str) {
  if (!exports.useColors) {
    return String(str);
  }
  return '\u001b[' + exports.colors[type] + 'm' + str + '\u001b[0m';
}

example usage
```
n/a
```

function mocha-webpack.base.list (failures)

description and source-code

list = function (failures) {
  console.log();
  failures.forEach(function(test, i) {
    // format
    var fmt = color('error title', '  %s) %s:\n')
      + color('error message', '     %s')
      + color('error stack', '\n%s\n');

    // msg
    var msg;
    var err = test.err;
    var message;
    if (err.message && typeof err.message.toString === 'function') {
      message = err.message + '';
    } else if (typeof err.inspect === 'function') {
      message = err.inspect() + '';
    } else {
      message = '';
    }
    var stack = err.stack || message;
    var index = stack.indexOf(message);
    var actual = err.actual;
    var expected = err.expected;
    var escape = true;

    if (index === -1) {
      msg = message;
    } else {
      index += message.length;
      msg = stack.slice(0, index);
      // remove msg from stack
      stack = stack.slice(index + 1);
    }

    // uncaught
    if (err.uncaught) {
      msg = 'Uncaught ' + msg;
    }
    // explicitly show diff
    if (err.showDiff !== false && sameType(actual, expected) && expected !== undefined) {
      escape = false;
      if (!(utils.isString(actual) && utils.isString(expected))) {
        err.actual = actual = utils.stringify(actual);
        err.expected = expected = utils.stringify(expected);
      }

      fmt = color('error title', '  %s) %s:\n%s') + color('error stack', '\n%s\n');
      var match = message.match(/^([^:]+): expected/);
      msg = '\n      ' + color('error message', match ? match[1] : msg);

      if (exports.inlineDiffs) {
        msg += inlineDiff(err, escape);
      } else {
        msg += unifiedDiff(err, escape);
      }
    }

    // indent stack trace
    stack = stack.replace(/^/gm, '  ');

    console.log(fmt, (i + 1), test.fullTitle(), msg, stack);
  });
}

example usage
```
n/a
```

module mocha-webpack.base.prototype

function mocha-webpack.base.prototype.epilogue ()

description and source-code

epilogue = function () {
  var stats = this.stats;
  var fmt;

  console.log();

  // passes
  fmt = color('bright pass', ' ')
    + color('green', ' %d passing')
    + color('light', ' (%s)');

  console.log(fmt,
    stats.passes || 0,
    ms(stats.duration));

  // pending
  if (stats.pending) {
    fmt = color('pending', ' ')
      + color('pending', ' %d pending');

    console.log(fmt, stats.pending);
  }

  // failures
  if (stats.failures) {
    fmt = color('fail', '  %d failing');

    console.log(fmt, stats.failures);

    Base.list(this.failures);
    console.log();
  }

  console.log();
}

example usage
```
n/a
```

module mocha-webpack.checkReporter

function mocha-webpack.checkReporter.default (reporter)

description and source-code

function checkReporter(reporter) {
  try {
    require("mocha/lib/reporters/" + reporter); // eslint-disable-line global-require
  } catch (errModule) {
    try {
      require(reporter); // eslint-disable-line global-require
    } catch (errLocal) {
      throw new Error("reporter \"" + reporter + "\" does not exist");
    }
  }
}

example usage

...
function prepareWebpack(options, cb) {
var _options$files = _slicedToArray(options.files, 1);

var file = _options$files[0];

var glob = (0, _isGlob2.default)(file);

var webpackInfoPlugin = new _webpackInfoPlugin2.default({
  stats: {
    // pass options from http://webpack.github.io/docs/node.js-api.html#stats-tostring
    // context: false,
    hash: false,
    version: false,
    timings: false,
    assets: false,
...

module mocha-webpack.configureMocha

function mocha-webpack.configureMocha.default ()

description and source-code

function configureMocha() {
  var options = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};

  // infinite stack traces
  Error.stackTraceLimit = Infinity;

  // init defauls
  _lodash2.default.defaults(options, defaults);

  // check reporter
  (0, _checkReporter2.default)(options.reporter);

  // init mocha
  var mocha = new _mocha2.default();

  // reporter
  mocha.reporter(options.reporter, options.reporterOptions);

  // colors
  mocha.useColors(options.colors);

  // inline-diffs
  mocha.useInlineDiffs(options.inlineDiffs);

  // slow <ms>
  mocha.suite.slow(options.slow);

  // timeout <ms>
  if (options.timeout === 0) {
    mocha.enableTimeouts(false);
  } else {
    mocha.suite.timeout(options.timeout);
  }

  // bail
  mocha.suite.bail(options.bail);

  // grep
  if (options.grep) {
    mocha.grep(new RegExp(options.grep));
  }

  // fgrep
  if (options.fgrep) {
    mocha.grep(options.fgrep);
  }

  // invert
  if (options.invert) {
    mocha.invert();
  }

  // check-leaks
  if (options.checkLeaks) {
    mocha.checkLeaks();
  }

  // full-trace
  if (options.fullTrace) {
    mocha.fullTrace();
  }

  // growl
  if (options.growl) {
    mocha.growl();
  }

  // async-only
  if (options.asyncOnly) {
    mocha.asyncOnly();
  }

  // delay
  if (options.delay) {
    mocha.delay();
  }

  // retries
  if (options.retries) {
    mocha.suite.retries(options.retries);
  }

  // interface
  mocha.ui(options.ui);

  return mocha;
}

example usage

...
function prepareWebpack(options, cb) {
var _options$files = _slicedToArray(options.files, 1);

var file = _options$files[0];

var glob = (0, _isGlob2.default)(file);

var webpackInfoPlugin = new _webpackInfoPlugin2.default({
  stats: {
    // pass options from http://webpack.github.io/docs/node.js-api.html#stats-tostring
    // context: false,
    hash: false,
    version: false,
    timings: false,
    assets: false,
...

module mocha-webpack.contextReplacementPlugin

function mocha-webpack.contextReplacementPlugin.default (context, matcher)

description and source-code

function contextReplacementPlugin(context, matcher) {
  var recursive = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : false;

  // use ContextReplacementPlugin to replace the initial context with a
  // new regExp to match the desired files
  return new _webpack.ContextReplacementPlugin(new RegExp(context), function (result) {
    if (result.request === context) {
      // provide a new test function for resolving
      result.regExp = { test: matcher }; // eslint-disable-line no-param-reassign
      result.recursive = recursive; // eslint-disable-line no-param-reassign
    }
  });
}

example usage

...
function prepareWebpack(options, cb) {
var _options$files = _slicedToArray(options.files, 1);

var file = _options$files[0];

var glob = (0, _isGlob2.default)(file);

var webpackInfoPlugin = new _webpackInfoPlugin2.default({
  stats: {
    // pass options from http://webpack.github.io/docs/node.js-api.html#stats-tostring
    // context: false,
    hash: false,
    version: false,
    timings: false,
    assets: false,
...

module mocha-webpack.createCompiler

function mocha-webpack.createCompiler.default (webpackConfig)

description and source-code

function createCompiler(webpackConfig) {
  var cb = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : missing();

  (0, _invariant2.default)(_lodash2.default.isPlainObject(webpackConfig), 'webpackConfig must be a plain object');
  (0, _invariant2.default)(_lodash2.default.isFunction(cb), 'cb must be a function');

  var compiler = (0, _webpack2.default)(webpackConfig);

  var failedModules = [];
  var failedModulesErrors = [];

  compiler.plugin('failed', cb);

  compiler.plugin('compilation', function (compilation) {
    // Workaround to tag build as failed when webpack marks a failed module as just a warning
    compilation.plugin('build-module', function (module) {
      var ident = module.identifier();

      if (ident) {
        var idx = failedModules.indexOf(ident);
        if (idx !== -1) {
          failedModules.splice(idx, 1);
          failedModulesErrors.splice(idx, 1);
        }
      }
    });
    compilation.plugin('failed-module', function (module) {
      var ident = module.identifier();
      if (ident) {
        failedModules.push(ident);
        failedModulesErrors.push(module.error);
      }
    });
  });

  compiler.plugin('done', function (stats) {
    if (stats.hasErrors()) {
      var jsonStats = stats.toJson();

      var _jsonStats$errors = _slicedToArray(jsonStats.errors, 1);

      var err = _jsonStats$errors[0];

      cb(err);
    } else if (failedModulesErrors.length) {
      var _err = failedModulesErrors[0];

      cb(_err);
    } else {
      cb();
    }
  });
  return compiler;
}

example usage

...
function prepareWebpack(options, cb) {
var _options$files = _slicedToArray(options.files, 1);

var file = _options$files[0];

var glob = (0, _isGlob2.default)(file);

var webpackInfoPlugin = new _webpackInfoPlugin2.default({
  stats: {
    // pass options from http://webpack.github.io/docs/node.js-api.html#stats-tostring
    // context: false,
    hash: false,
    version: false,
    timings: false,
    assets: false,
...

module mocha-webpack.exists

function mocha-webpack.exists.existsDirSync (file)

description and source-code

function existsDirSync(file) {
  try {
    return _fs2.default.statSync(file).isDirectory();
  } catch (err) {
    return false;
  }
}

example usage
```
n/a
```

function mocha-webpack.exists.existsFileSync (file)

description and source-code

function existsFileSync(file) {
  try {
    _fs2.default.accessSync(file, _fs2.default.F_OK);
    return true;
  } catch (e) {
    return false;
  }
}

example usage
```
n/a
```

module mocha-webpack.parseArgv

function mocha-webpack.parseArgv.default (argv)

description and source-code

function parseArgv(argv) {
  var ignoreDefaults = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : false;

  var parsedArgs = (0, _yargs2.default)(argv).help('help').alias('help', 'h', '?').version(function () {
    return _package.version;
  }).demand(0, 1).options(options).strict().argv;

  var files = parsedArgs._;

  if (!files.length) {
    files = ['./test'];
  }

  var parsedOptions = _lodash2.default.pick(parsedArgs, parameters); // pick all parameters as new object
  var validOptions = _lodash2.default.omitBy(parsedOptions, _lodash2.default.isUndefined); // remove all undefined values

  _lodash2.default.forEach(parametersWithMultipleArgs, function (key) {
    if (_lodash2.default.has(validOptions, key)) {
      var value = validOptions[key];
      if (!Array.isArray(value)) {
        validOptions[key] = [value];
      }
    }
  });

  _lodash2.default.forOwn(validOptions, function (value, key) {
    // validate all non-array options with required arg that it is not duplicated
    // see https://github.com/yargs/yargs/issues/229
    if (parametersWithMultipleArgs.indexOf(key) === -1 && _lodash2.default.isArray(value)) {
      (function () {
        var arg = _lodash2.default.kebabCase(key);
        var provided = value.map(function (v) {
          return '--' + arg + ' ' + v;
        }).join(' ');
        var expected = '--' + arg + ' ' + value[0];

        throw new Error('Duplicating arguments for "--' + arg + '" is not allowed. "' + provided + '" was provided, but expected
 "' + expected + '"'); // eslint-disable-line max-len
      })();
    }
  });

  validOptions.files = files;

  var reporterOptions = {};

  if (validOptions.reporterOptions) {
    validOptions.reporterOptions.split(',').forEach(function (opt) {
      var L = opt.split('=');
      if (L.length > 2 || L.length === 0) {
        throw new Error('invalid reporter option ' + opt);
      } else if (L.length === 2) {
        reporterOptions[L[0]] = L[1];
      } else {
        reporterOptions[L[0]] = true;
      }
    });
  }

  validOptions.reporterOptions = reporterOptions;
  validOptions.require = validOptions.require || [];
  validOptions.include = validOptions.include || [];

  if (ignoreDefaults) {
    var _ret2 = function () {
      var userOptions = (0, _yargs2.default)(argv).argv;
      var providedKeys = _lodash2.default.keys(userOptions);
      var usedAliases = _lodash2.default.flatten(_lodash2.default.filter(groupedAliases, function (aliases) {
        return _lodash2.default.some(aliases, function (alias) {
          return providedKeys.indexOf(alias) !== -1;
        });
      }));

      if (parsedArgs._.length) {
        usedAliases.push('files');
      }

      return {
        v: _lodash2.default.pick(validOptions, usedAliases)
      };
    }();

    if ((typeof _ret2 === 'undefined' ? 'undefined' : _typeof(_ret2)) === "object") return _ret2.v;
  }

  return validOptions;
}

example usage

...
function prepareWebpack(options, cb) {
var _options$files = _slicedToArray(options.files, 1);

var file = _options$files[0];

var glob = (0, _isGlob2.default)(file);

var webpackInfoPlugin = new _webpackInfoPlugin2.default({
  stats: {
    // pass options from http://webpack.github.io/docs/node.js-api.html#stats-tostring
    // context: false,
    hash: false,
    version: false,
    timings: false,
    assets: false,
...

module mocha-webpack.parseConfig

function mocha-webpack.parseConfig.default (explicitConfig)

description and source-code

function parseConfig(explicitConfig) {
  var config = explicitConfig || defaultConfig;

  if (!(0, _exists.existsFileSync)(config)) {
    return handleMissingConfig(explicitConfig);
  }

  var argv = _fs2.default.readFileSync(config, 'utf8').replace(/\\\s/g, '%20').split(/\s/).filter(Boolean).map(function (value) {
    return value.replace(/%20/g, ' ');
  });
  var defaultOptions = (0, _parseArgv2.default)(argv, true);
  return defaultOptions;
}

example usage

...
function prepareWebpack(options, cb) {
var _options$files = _slicedToArray(options.files, 1);

var file = _options$files[0];

var glob = (0, _isGlob2.default)(file);

var webpackInfoPlugin = new _webpackInfoPlugin2.default({
  stats: {
    // pass options from http://webpack.github.io/docs/node.js-api.html#stats-tostring
    // context: false,
    hash: false,
    version: false,
    timings: false,
    assets: false,
...

module mocha-webpack.prepareEntry

function mocha-webpack.prepareEntry.default (path)

description and source-code

function prepareEntry(path) {
  var watch = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : false;

  if (watch) {
    return "\n    // This gets replaced by webpack with the updated files on rebuild\n    var __webpackManifest__ = [];\n\n    var
 testsContext = require.context(\"" + path + "\", false);\n\n    function inManifest(path) {\n      return __webpackManifest__.indexOf(path) >= 0;\n    }\n\n    var runnable = testsContext.keys().filter(inManifest);\n\n    runnable.forEach(testsContext);\n    ";
  }
  return "\n    var testsContext = require.context(\"" + path + "\", false);\n\n    var runnable = testsContext.keys();\n\n    runnable
.forEach(testsContext);\n    ";
}

example usage

...
function prepareWebpack(options, cb) {
var _options$files = _slicedToArray(options.files, 1);

var file = _options$files[0];

var glob = (0, _isGlob2.default)(file);

var webpackInfoPlugin = new _webpackInfoPlugin2.default({
  stats: {
    // pass options from http://webpack.github.io/docs/node.js-api.html#stats-tostring
    // context: false,
    hash: false,
    version: false,
    timings: false,
    assets: false,
...

module mocha-webpack.prepareWebpack

function mocha-webpack.prepareWebpack.default (options, cb)

description and source-code

function prepareWebpack(options, cb) {
  var _options$files = _slicedToArray(options.files, 1);

  var file = _options$files[0];

  var glob = (0, _isGlob2.default)(file);

  var webpackInfoPlugin = new _webpackInfoPlugin2.default({
    stats: {
      // pass options from http://webpack.github.io/docs/node.js-api.html#stats-tostring
      // context: false,
      hash: false,
      version: false,
      timings: false,
      assets: false,
      chunks: false,
      chunkModules: false,
      modules: false,
      children: false,
      cached: false,
      reasons: false,
      source: false,
      errorDetails: true,
      chunkOrigins: false,
      colors: options.colors
    },
    state: false });

  var webpackPlugins = [webpackInfoPlugin];

  if (glob || (0, _exists.existsDirSync)(file)) {
    (function () {
      var matchModule = function matchModule(mod) {
        // eslint-disable-line no-inner-declarations
        // normalize path to match glob
        var correctedPath = _path2.default.join(parent, mod);
        return matcher(correctedPath);
      };

      var globPattern = glob ? file : directoryToGlob(file, options);

      var matcher = (0, _anymatch2.default)(globPattern);
      var parent = (0, _globParent2.default)(globPattern);
      var directory = _path2.default.resolve(parent);

      var context = (0, _normalizePath2.default)(_path2.default.relative(tmpPath, directory));
      var recursive = globPattern.indexOf('**') !== -1; // or via options.recursive?

      var optionsHash = _objectHash2.default.MD5(options); // eslint-disable-line new-cap

      var entryFilePath = _path2.default.join(tmpPath, optionsHash + '-entry.js');
      var outputFilePath = _path2.default.join(tmpPath, optionsHash, optionsHash + '-output.js');

      webpackPlugins.push((0, _contextReplacementPlugin2.default)(context, matchModule, recursive));

      var webpackConfig = createWebpackConfig(options.webpackConfig, entryFilePath, outputFilePath, webpackPlugins, options.include
);

      var fileContent = (0, _prepareEntry2.default)(context, options.watch);

      if (!(0, _exists.existsFileSync)(entryFilePath)) {
        _fsExtra2.default.outputFile(entryFilePath, fileContent, function (err) {
          cb(err, webpackConfig);
        });
      } else {
        process.nextTick(function () {
          cb(null, webpackConfig);
        });
      }
    })();
  } else if ((0, _exists.existsFileSync)(file)) {
    (function () {
      var entryFilePath = _path2.default.resolve(file);
      var outputFilePath = _path2.default.join(tmpPath, _path2.default.basename(entryFilePath));
      var webpackConfig = createWebpackConfig(options.webpackConfig, entryFilePath, outputFilePath, webpackPlugins, options.include
);
      process.nextTick(function () {
        cb(null, webpackConfig);
      });
    })();
  } else {
    process.nextTick(function () {
      cb(new Error('File/Directory not found: ' + file));
    });
  }
}

example usage

...
function prepareWebpack(options, cb) {
var _options$files = _slicedToArray(options.files, 1);

var file = _options$files[0];

var glob = (0, _isGlob2.default)(file);

var webpackInfoPlugin = new _webpackInfoPlugin2.default({
  stats: {
    // pass options from http://webpack.github.io/docs/node.js-api.html#stats-tostring
    // context: false,
    hash: false,
    version: false,
    timings: false,
    assets: false,
...

module mocha-webpack.requireWebpackConfig

function mocha-webpack.requireWebpackConfig.default (webpackConfig)

description and source-code

function requireWebpackConfig(webpackConfig) {
  if (!webpackConfig) {
    return {};
  }

  var configPath = _path2.default.resolve(webpackConfig);
  var configExtension = getConfigExtension(configPath);

  if (!fileExists(configPath)) {
    if (configExtension !== '.js') {
      return {};
    }

    var configDirPath = _path2.default.dirname(configPath);
    var configBaseName = _path2.default.basename(configPath, configExtension);

    configPath = findConfigFile(configDirPath, configBaseName);
    if (configPath === null) {
      return {};
    }

    configExtension = getConfigExtension(configPath);
  }

  registerCompiler(_interpret2.default.extensions[configExtension]);
  var config = require(configPath); // eslint-disable-line global-require

  return config.default || config;
}

example usage

...
function prepareWebpack(options, cb) {
var _options$files = _slicedToArray(options.files, 1);

var file = _options$files[0];

var glob = (0, _isGlob2.default)(file);

var webpackInfoPlugin = new _webpackInfoPlugin2.default({
  stats: {
    // pass options from http://webpack.github.io/docs/node.js-api.html#stats-tostring
    // context: false,
    hash: false,
    version: false,
    timings: false,
    assets: false,
...

module mocha-webpack.resetMocha

function mocha-webpack.resetMocha.default (mocha, options)

description and source-code

function resetMocha(mocha, options) {
  if (options.watch && !options.grep) {
    mocha.grep(null);
  }
  mocha.suite = mocha.suite.clone(); // eslint-disable-line no-param-reassign
  mocha.suite.ctx = new _mocha.Context(); // eslint-disable-line no-param-reassign
  mocha.ui(options.ui);
  return mocha;
}

example usage

...
function prepareWebpack(options, cb) {
var _options$files = _slicedToArray(options.files, 1);

var file = _options$files[0];

var glob = (0, _isGlob2.default)(file);

var webpackInfoPlugin = new _webpackInfoPlugin2.default({
  stats: {
    // pass options from http://webpack.github.io/docs/node.js-api.html#stats-tostring
    // context: false,
    hash: false,
    version: false,
    timings: false,
    assets: false,
...

module mocha-webpack.runner

function mocha-webpack.runner.run (options, webpackConfig)

description and source-code

function run(options, webpackConfig) {
  var mocha = (0, _configureMocha2.default)(options);
  var outputFilePath = _path2.default.join(webpackConfig.output.path, webpackConfig.output.filename);

  (0, _build2.default)(webpackConfig, function (err) {
    if (err) {
      if (options.exit) {
        exit(1);
      } else {
        exitLater(1);
      }
    }

    mocha.files = [outputFilePath];
    mocha.run(options.exit ? exit : exitLater);
  });
}

example usage

...
      exit(1);
    } else {
      exitLater(1);
    }
  }

  mocha.files = [outputFilePath];
  mocha.run(options.exit ? exit : exitLater);
});
}

function watch(options, webpackConfig) {
var mocha = (0, _configureMocha2.default)(options);

var outputFilePath = _path2.default.join(webpackConfig.output.path, webpackConfig.output.filename);
...

function mocha-webpack.runner.watch (options, webpackConfig)

description and source-code

function watch(options, webpackConfig) {
  var mocha = (0, _configureMocha2.default)(options);

  var outputFilePath = _path2.default.join(webpackConfig.output.path, webpackConfig.output.filename);

  var injectChangedFilesPlugin = new _InjectChangedFilesPlugin2.default();

  webpackConfig.plugins.push(injectChangedFilesPlugin);

  var runAgain = false;
  var mochaRunner = null;

  function runMocha() {
    // eslint-disable-line no-inner-declarations
    // clear up require cache to reload test bundle
    delete require.cache[outputFilePath];

    (0, _resetMocha2.default)(mocha, options);
    mocha.files = [outputFilePath];

    runAgain = false;

    try {
      mochaRunner = mocha.run(function (failures) {
        injectChangedFilesPlugin.testsCompleted(failures > 0);

        // need to wait until next tick, otherwise mochaRunner = null doesn't work..
        process.nextTick(function () {
          mochaRunner = null;
          if (runAgain) {
            runMocha();
          }
        });
      });
    } catch (e) {
      injectChangedFilesPlugin.testsCompleted(true);
      console.error(e.stack); // eslint-disable-line no-console
    }
  }

  (0, _watch2.default)(webpackConfig, function (err) {
    if (err) {
      // wait for fixed tests
      return;
    }

    runAgain = true;

    if (mochaRunner) {
      mochaRunner.abort();
    } else {
      runMocha();
    }
  });
}

example usage

...
var _createCompiler2 = _interopRequireDefault(_createCompiler);

function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }

function watch(webpackConfig, cb) {
  var watchOptions = webpackConfig.watchOptions || {};
  var compiler = (0, _createCompiler2.default)(webpackConfig, cb);
  compiler.watch(watchOptions, _lodash2.default.noop);
}
...

module mocha-webpack.utils

function mocha-webpack.utils.canonicalize (value, stack)

description and source-code

canonicalize = function (value, stack) {
  var canonicalizedObj;
  /* eslint-disable no-unused-vars */
  var prop;
  /* eslint-enable no-unused-vars */
  var type = exports.type(value);
  function withStack(value, fn) {
    stack.push(value);
    fn();
    stack.pop();
  }

  stack = stack || [];

  if (exports.indexOf(stack, value) !== -1) {
    return '[Circular]';
  }

  switch (type) {
    case 'undefined':
    case 'buffer':
    case 'null':
      canonicalizedObj = value;
      break;
    case 'array':
      withStack(value, function() {
        canonicalizedObj = exports.map(value, function(item) {
          return exports.canonicalize(item, stack);
        });
      });
      break;
    case 'function':
      /* eslint-disable guard-for-in */
      for (prop in value) {
        canonicalizedObj = {};
        break;
      }
      /* eslint-enable guard-for-in */
      if (!canonicalizedObj) {
        canonicalizedObj = emptyRepresentation(value, type);
        break;
      }
    /* falls through */
    case 'object':
      canonicalizedObj = canonicalizedObj || {};
      withStack(value, function() {
        exports.forEach(exports.keys(value).sort(), function(key) {
          canonicalizedObj[key] = exports.canonicalize(value[key], stack);
        });
      });
      break;
    case 'date':
    case 'number':
    case 'regexp':
    case 'boolean':
    case 'symbol':
      canonicalizedObj = value;
      break;
    default:
      canonicalizedObj = value + '';
  }

  return canonicalizedObj;
}

example usage
```
n/a
```

function mocha-webpack.utils.clean (str)

description and source-code

clean = function (str) {
  str = str
    .replace(/\r\n?|[\n\u2028\u2029]/g, '\n').replace(/^\uFEFF/, '')
    .replace(/^function *\(.*\)\s*\{|\(.*\) *=> *\{?/, '')
    .replace(/\s+\}$/, '');

  var spaces = str.match(/^\n?( *)/)[1].length;
  var tabs = str.match(/^\n?(\t*)/)[1].length;
  var re = new RegExp('^\n?' + (tabs ? '\t' : ' ') + '{' + (tabs ? tabs : spaces) + '}', 'gm');

  str = str.replace(re, '');

  return exports.trim(str);
}

example usage
```
n/a
```

function mocha-webpack.utils.escape (html)

description and source-code

escape = function (html) {
  return String(html)
    .replace(/&/g, '&amp;')
    .replace(/"/g, '&quot;')
    .replace(/</g, '&lt;')
    .replace(/>/g, '&gt;');
}

example usage
```
n/a
```

function mocha-webpack.utils.files (dir, ext, ret)

description and source-code

files = function (dir, ext, ret) {
  ret = ret || [];
  ext = ext || ['js'];

  var re = new RegExp('\\.(' + ext.join('|') + ')$');

  readdirSync(dir)
    .filter(ignored)
    .forEach(function(path) {
      path = join(dir, path);
      if (statSync(path).isDirectory()) {
        exports.files(path, ext, ret);
      } else if (path.match(re)) {
        ret.push(path);
      }
    });

  return ret;
}

example usage
```
n/a
```

function mocha-webpack.utils.filter (arr, fn)

description and source-code

filter = function (arr, fn) {
  var ret = [];

  for (var i = 0, l = arr.length; i < l; i++) {
    var val = arr[i];
    if (fn(val, i, arr)) {
      ret.push(val);
    }
  }

  return ret;
}

example usage

...
return _lodash2.default.map(_lodash2.default.keys(opts), _lodash2.default.camelCase);
};
var parameters = paramList(options); // camel case parameters
var parametersWithMultipleArgs = paramList(_lodash2.default.pickBy(_lodash2.default.mapValues(options, function (v) {
return !!v.requiresArg && v.multiple === true;
}))); // eslint-disable-line max-len
var groupedAliases = _lodash2.default.values(_lodash2.default.mapValues(options, function (value, key) {
return [_lodash2.default.camelCase(key), key, value.alias].filter(_lodash2.default.identity
);
})); // eslint-disable-line max-len

function parseArgv(argv) {
var ignoreDefaults = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : false;

var parsedArgs = (0, _yargs2.default)(argv).help('help').alias('help', 'h', '?').version
(function () {
  return _package.version;
...

function mocha-webpack.utils.forEach (arr, fn, scope)

description and source-code

forEach = function (arr, fn, scope) {
  for (var i = 0, l = arr.length; i < l; i++) {
    fn.call(scope, arr[i], i);
  }
}

example usage

...
if (!files.length) {
  files = ['./test'];
}

var parsedOptions = _lodash2.default.pick(parsedArgs, parameters); // pick all parameters as new object
var validOptions = _lodash2.default.omitBy(parsedOptions, _lodash2.default.isUndefined); // remove all undefined values

_lodash2.default.forEach(parametersWithMultipleArgs, function (key) {
  if (_lodash2.default.has(validOptions, key)) {
    var value = validOptions[key];
    if (!Array.isArray(value)) {
      validOptions[key] = [value];
    }
  }
});
...

function mocha-webpack.utils.getError (err)

description and source-code

getError = function (err) {
  return err || exports.undefinedError();
}

example usage
```
n/a
```

function mocha-webpack.utils.highlightTags (name)

description and source-code

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);
  }
}

example usage
```
n/a
```

function mocha-webpack.utils.indexOf (arr, obj, start)

description and source-code

indexOf = function (arr, obj, start) {
  for (var i = start || 0, l = arr.length; i < l; i++) {
    if (arr[i] === obj) {
      return i;
    }
  }
  return -1;
}

example usage

...
    }
  }
});

_lodash2.default.forOwn(validOptions, function (value, key) {
  // validate all non-array options with required arg that it is not duplicated
  // see https://github.com/yargs/yargs/issues/229
  if (parametersWithMultipleArgs.indexOf(key) === -1 && _lodash2.default.isArray
(value)) {
    (function () {
      var arg = _lodash2.default.kebabCase(key);
      var provided = value.map(function (v) {
        return '--' + arg + ' ' + v;
      }).join(' ');
      var expected = '--' + arg + ' ' + value[0];
...

function mocha-webpack.utils.inherits (ctor, superCtor)

description and source-code

inherits = function (ctor, superCtor) {

  if (ctor === undefined || ctor === null)
    throw new TypeError('The constructor to "inherits" must not be ' +
                        'null or undefined');

  if (superCtor === undefined || superCtor === null)
    throw new TypeError('The super constructor to "inherits" must not ' +
                        'be null or undefined');

  if (superCtor.prototype === undefined)
    throw new TypeError('The super constructor to "inherits" must ' +
                        'have a prototype');

  ctor.super_ = superCtor;
  Object.setPrototypeOf(ctor.prototype, superCtor.prototype);
}

example usage
```
n/a
```

function mocha-webpack.utils.isArray ()

description and source-code
```
function isArray() { [native code] }
```

example usage

...

var parsedOptions = _lodash2.default.pick(parsedArgs, parameters); // pick all parameters as new object
var validOptions = _lodash2.default.omitBy(parsedOptions, _lodash2.default.isUndefined); // remove all undefined values

_lodash2.default.forEach(parametersWithMultipleArgs, function (key) {
  if (_lodash2.default.has(validOptions, key)) {
    var value = validOptions[key];
    if (!Array.isArray(value)) {
      validOptions[key] = [value];
    }
  }
});

_lodash2.default.forOwn(validOptions, function (value, key) {
  // validate all non-array options with required arg that it is not duplicated
...

function mocha-webpack.utils.isBuffer (value)

description and source-code

isBuffer = function (value) {
  return typeof Buffer !== 'undefined' && Buffer.isBuffer(value);
}

example usage
```
n/a
```

function mocha-webpack.utils.isString (obj)

description and source-code

isString = function (obj) {
  return typeof obj === 'string';
}

example usage
```
n/a
```

function mocha-webpack.utils.keys ()

description and source-code
```
function keys() { [native code] }
```

example usage

...
  describe: 'path to webpack-mocha options file',
  group: BASIC_GROUP,
  requiresArg: true
}
};

var paramList = function paramList(opts) {
return _lodash2.default.map(_lodash2.default.keys(opts), _lodash2.default.camelCase);
};
var parameters = paramList(options); // camel case parameters
var parametersWithMultipleArgs = paramList(_lodash2.default.pickBy(_lodash2.default.mapValues(options, function (v) {
return !!v.requiresArg && v.multiple === true;
}))); // eslint-disable-line max-len
var groupedAliases = _lodash2.default.values(_lodash2.default.mapValues(options, function (value, key) {
return [_lodash2.default.camelCase(key), key, value.alias].filter(_lodash2.default.identity);
...

function mocha-webpack.utils.lookupFiles (path, extensions, recursive)

description and source-code

function lookupFiles(path, extensions, recursive) {
  var files = [];
  var re = new RegExp('\\.(' + extensions.join('|') + ')$');

  if (!exists(path)) {
    if (exists(path + '.js')) {
      path += '.js';
    } else {
      files = glob.sync(path);
      if (!files.length) {
        throw new Error("cannot resolve path (or pattern) '" + path + "'");
      }
      return files;
    }
  }

  try {
    var stat = statSync(path);
    if (stat.isFile()) {
      return path;
    }
  } catch (err) {
    // ignore error
    return;
  }

  readdirSync(path).forEach(function(file) {
    file = join(path, file);
    try {
      var stat = statSync(file);
      if (stat.isDirectory()) {
        if (recursive) {
          files = files.concat(lookupFiles(file, extensions, recursive));
        }
        return;
      }
    } catch (err) {
      // ignore error
      return;
    }
    if (!stat.isFile() || !re.test(file) || basename(file)[0] === '.') {
      return;
    }
    files.push(file);
  });

  return files;
}

example usage
```
n/a
```

function mocha-webpack.utils.map (arr, fn, scope)

description and source-code

map = function (arr, fn, scope) {
  var result = [];
  for (var i = 0, l = arr.length; i < l; i++) {
    result.push(fn.call(scope, arr[i], i, arr));
  }
  return result;
}

example usage

...
  describe: 'path to webpack-mocha options file',
  group: BASIC_GROUP,
  requiresArg: true
}
};

var paramList = function paramList(opts) {
return _lodash2.default.map(_lodash2.default.keys(opts), _lodash2.default.camelCase);
};
var parameters = paramList(options); // camel case parameters
var parametersWithMultipleArgs = paramList(_lodash2.default.pickBy(_lodash2.default.mapValues(options, function (v) {
return !!v.requiresArg && v.multiple === true;
}))); // eslint-disable-line max-len
var groupedAliases = _lodash2.default.values(_lodash2.default.mapValues(options, function (value, key) {
return [_lodash2.default.camelCase(key), key, value.alias].filter(_lodash2.default.identity);
...

function mocha-webpack.utils.parseQuery (qs)

description and source-code

parseQuery = function (qs) {
  return exports.reduce(qs.replace('?', '').split('&'), function(obj, pair) {
    var i = pair.indexOf('=');
    var key = pair.slice(0, i);
    var val = pair.slice(++i);

    obj[key] = decodeURIComponent(val);
    return obj;
  }, {});
}

example usage

...

// Note: no export default here cause of Babel 6
module.exports = function includeFilesLoader(sourceCode, sourceMap) {
  var _this = this;

  this.cacheable();

  var loaderOptions = _loaderUtils2.default.parseQuery(this.query);

  if (loaderOptions.include && loaderOptions.include.length) {
var insertIndex = 0;
var match = sourceCode.match(useStrictRegex);

if (match !== null) {
  insertIndex = match.index + match[0].length;
...

function mocha-webpack.utils.reduce (arr, fn, val)

description and source-code

reduce = function (arr, fn, val) {
  var rval = val;

  for (var i = 0, l = arr.length; i < l; i++) {
    rval = fn(rval, arr[i], i, arr);
  }

  return rval;
}

example usage

...

function setTrue(acc, key) {
acc[key] = true; // eslint-disable-line no-param-reassign
return acc;
}

function getAffectedFiles(modules) {
return modules.filter(isBuilt).map(getId).reduce(setTrue, {});
}

function findAllDependentFiles(affectedFiles, seen, module) {
if (seen[module.rawRequest]) return;
seen[module.rawRequest] = true; // eslint-disable-line no-param-reassign

if (affectedFiles[module.rawRequest]) return;
...

function mocha-webpack.utils.slug (str)

description and source-code

slug = function (str) {
  return str
    .toLowerCase()
    .replace(/ +/g, '-')
    .replace(/[^-\w]/g, '');
}

example usage
```
n/a
```

function mocha-webpack.utils.stackTraceFilter ()

description and source-code

stackTraceFilter = function () {
  // TODO: Replace with `process.browser`
  var slash = '/';
  var is = typeof document === 'undefined' ? { node: true } : { browser: true };
  var cwd = is.node
      ? process.cwd() + slash
      : (typeof location === 'undefined' ? window.location : location).href.replace(/\/[^\/]*$/, '/');

  function isMochaInternal(line) {
    return (~line.indexOf('node_modules' + slash + 'mocha' + slash))
      || (~line.indexOf('components' + slash + 'mochajs' + slash))
      || (~line.indexOf('components' + slash + 'mocha' + slash))
      || (~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;
  }

  return function(stack) {
    stack = stack.split('\n');

    stack = exports.reduce(stack, function(list, line) {
      if (isMochaInternal(line)) {
        return list;
      }

      if (is.node && isNodeInternal(line)) {
        return list;
      }

      // Clean up cwd(absolute)
      if (/\(?.+:\d+:\d+\)?$/.test(line)) {
        line = line.replace(cwd, '');
      }

      list.push(line);
      return list;
    }, []);

    return stack.join('\n');
  };
}

example usage
```
n/a
```

function mocha-webpack.utils.stringify (value)

description and source-code

stringify = function (value) {
  var type = exports.type(value);

  if (!~exports.indexOf(['object', 'array', 'function'], type)) {
    if (type !== 'buffer') {
      return jsonStringify(value);
    }
    var json = value.toJSON();
    // Based on the toJSON result
    return jsonStringify(json.data && json.type ? json.data : json, 2)
      .replace(/,(\n|$)/g, '$1');
  }

  for (var prop in value) {
    if (Object.prototype.hasOwnProperty.call(value, prop)) {
      return jsonStringify(exports.canonicalize(value), 2).replace(/,(\n|$)/g, '$1');
    }
  }

  return emptyRepresentation(value, type);
}

example usage

...
var config = _lodash2.default.clone(webpackConfig);
config.entry = './' + entryFileName;

if (include.length) {
  var query = {
    include: include
  };
  config.entry = entryLoader + '?' + JSON.stringify(query) + '!' +
config.entry;
}

config.context = entryPath;
config.output = _lodash2.default.extend({}, config.output, {
  filename: outputFileName,
  path: outputPath
});
...

function mocha-webpack.utils.trim (str)

description and source-code

trim = function (str) {
  return str.replace(/^\s+|\s+$/g, '');
}

example usage
```
n/a
```

function mocha-webpack.utils.type (value)

description and source-code

function type(value) {
  if (value === undefined) {
    return 'undefined';
  } else if (value === null) {
    return 'null';
  } else if (typeof Buffer !== 'undefined' && Buffer.isBuffer(value)) {
    return 'buffer';
  }
  return Object.prototype.toString.call(value)
    .replace(/^\[.+\s(.+?)\]$/, '$1')
    .toLowerCase();
}

example usage
```
n/a
```

function mocha-webpack.utils.undefinedError ()

description and source-code

undefinedError = function () {
  return new Error('Caught undefined error, did you throw without specifying what?');
}

example usage
```
n/a
```

function mocha-webpack.utils.watch (files, fn)

description and source-code

watch = function (files, fn) {
  var options = { interval: 100 };
  files.forEach(function(file) {
    debug('file %s', file);
    watchFile(file, options, function(curr, prev) {
      if (prev.mtime < curr.mtime) {
        fn(file);
      }
    });
  });
}

example usage

...
var _createCompiler2 = _interopRequireDefault(_createCompiler);

function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }

function watch(webpackConfig, cb) {
  var watchOptions = webpackConfig.watchOptions || {};
  var compiler = (0, _createCompiler2.default)(webpackConfig, cb);
  compiler.watch(watchOptions, _lodash2.default.noop);
}
...

module mocha-webpack.watch

function mocha-webpack.watch.default (webpackConfig, cb)

description and source-code

function watch(webpackConfig, cb) {
  var watchOptions = webpackConfig.watchOptions || {};
  var compiler = (0, _createCompiler2.default)(webpackConfig, cb);
  compiler.watch(watchOptions, _lodash2.default.noop);
}

example usage

...
function prepareWebpack(options, cb) {
var _options$files = _slicedToArray(options.files, 1);

var file = _options$files[0];

var glob = (0, _isGlob2.default)(file);

var webpackInfoPlugin = new _webpackInfoPlugin2.default({
  stats: {
    // pass options from http://webpack.github.io/docs/node.js-api.html#stats-tostring
    // context: false,
    hash: false,
    version: false,
    timings: false,
    assets: false,
...

api documentation for mocha-webpack (v0.7.0)

mocha cli with webpack support

table of contents