Feature ignore file #2036

bin/_mocha

@@ -101,6 +101,7 @@ program
   .option('--use_strict', 'enforce strict mode')
   .option('--watch-extensions <ext>,...', 'additional extensions to monitor with --watch', list, [])
   .option('--delay', 'wait for async suite definition')
+  .option('--ignore-file <ignore-file-path>', 'specifies ignore file', './default.mochaignore')
 
 program.name = 'mocha';
 
@@ -278,6 +279,10 @@ if (program.growl) mocha.growl();
 
 if (program.asyncOnly) mocha.asyncOnly();
 
+// --ignore-file
+
+if (program.ignoreFile) mocha.ignoreFile(program.ignoreFile);
+
 // --delay
 
 if (program.delay) mocha.delay();

lib/default.mochaignore.js

@@ -0,0 +1,8 @@
+/**
+ * Mocha ignore tests file
+ */
+module.exports = {
+  skipTests: [
+    // Enter titles here, separated by ','
+  ]
+};

lib/mocha.js

@@ -426,6 +426,18 @@ Mocha.prototype.asyncOnly = function() {
   return this;
 };
 
+/**
+ * Loads ignore file
+ *
+ * @param {String} ignoreFile
+ * @return {Mocha}
+ * @api public
+ */
+Mocha.prototype.ignoreFile = function(ignoreFile) {
+  this.options.ignoreFile = ignoreFile;
+  return this;
+};
+
 /**
  * Disable syntax highlighting (in browser).
  *
@@ -475,6 +487,7 @@ Mocha.prototype.run = function(fn) {
   runner.ignoreLeaks = options.ignoreLeaks !== false;
   runner.fullStackTrace = options.fullStackTrace;
   runner.asyncOnly = options.asyncOnly;
+  runner.ignoreList = require(options.ignoreFile || './default.mochaignore');
   runner.allowUncaught = options.allowUncaught;
   if (options.grep) {
     runner.grep(options.grep, options.invert);

lib/runner.js

@@ -69,6 +69,7 @@ function Runner(suite, delay) {
   this.started = false;
   this.total = suite.total();
   this.failures = 0;
+  this.ignoreList = this.ignoreList || require('./default.mochaignore');
   this.on('test end', function(test) {
     self.checkGlobals(test);
   });
@@ -211,6 +212,17 @@ Runner.prototype.checkGlobals = function(test) {
   }
 };
 
+/**
+ * Checks if we need to ignore test.
+ *
+ * @api private
+ * @param {Test} test
+ * @return {Boolean} result of search in skip list.
+ */
+Runner.prototype.isInIgnoreList = function(test) {
+  return indexOf(this.ignoreList.skipTests, test.title, 0) !== -1;
+};
+
 /**
  * Fail the given `test`.
  *
@@ -485,6 +497,11 @@ Runner.prototype.runTests = function(suite, fn) {
       return fn();
     }
 
+    // check if we need to ignore
+    if (self.isInIgnoreList(test)) {
+      return next();
+    }
+
     // grep
     var match = self._grep.test(test.fullTitle());
     if (self._invert) {