allow skip() in async test context; closes #2334

lib/runnable.js

@@ -298,6 +298,10 @@ Runnable.prototype.run = function(fn) {
       return callFnAsync(this.fn);
     }
     try {
+      // allows skip() to be used in an explicit async context
+      this.skip = function() {
+        done(new Pending());
+      };
       callFnAsync(this.fn);
     } catch (err) {
       done(utils.getError(err));

test/integration/fixtures/pending/skip.async.before.js

@@ -0,0 +1,16 @@
+describe('skip in before', function() {
+  before(function(done) {
+    var self = this;
+    setTimeout(function() {
+      self.skip();
+    }, 50);
+  });
+
+  it('should never run this test', function() {
+    throw new Error('never thrown');
+  });
+
+  it('should never run this test', function() {
+    throw new Error('never thrown');
+  });
+});

test/integration/fixtures/pending/skip.async.beforeEach.js

@@ -0,0 +1,16 @@
+describe('skip in beforeEach', function() {
+  beforeEach(function(done) {
+    var self = this;
+    setTimeout(function() {
+      self.skip();
+    }, 50);
+  });
+
+  it('should never run this test', function() {
+    throw new Error('never thrown');
+  });
+
+  it('should never run this test', function() {
+    throw new Error('never thrown');
+  });
+});

test/integration/fixtures/pending/skip.async.spec.js

@@ -0,0 +1,12 @@
+describe('skip in test', function() {
+  it('should skip async', function(done) {
+    var self = this;
+    setTimeout(function() {
+      self.skip();
+    }, 50);
+  });
+
+  it('should run other tests in the suite', function() {
+    // Do nothing
+  });
+});

test/integration/pending.js

@@ -60,4 +60,47 @@ describe('pending', function() {
       });
     });
   });
+
+  describe('asynchronous skip()', function() {
+    this.timeout(1000);
+
+    describe('in spec', function() {
+      it('should immediately skip the spec and run all others', function(done) {
+        run('pending/skip.async.spec.js', args, function(err, res) {
+          assert(!err);
+          assert.equal(res.stats.pending, 1);
+          assert.equal(res.stats.passes, 1);
+          assert.equal(res.stats.failures, 0);
+          assert.equal(res.code, 0);
+          done();
+        });
+      });
+    });
+
+    describe('in before', function() {
+      it('should skip all suite specs', function(done) {
+        run('pending/skip.async.before.js', args, function(err, res) {
+          assert(!err);
+          assert.equal(res.stats.pending, 2);
+          assert.equal(res.stats.passes, 0);
+          assert.equal(res.stats.failures, 0);
+          assert.equal(res.code, 0);
+          done();
+        });
+      });
+    });
+
+    describe('in beforeEach', function() {
+      it('should skip all suite specs', function(done) {
+        run('pending/skip.sync.beforeEach.js', args, function(err, res) {
+          assert(!err);
+          assert.equal(res.stats.pending, 2);
+          assert.equal(res.stats.passes, 0);
+          assert.equal(res.stats.failures, 0);
+          assert.equal(res.code, 0);
+          done();
+        });
+      });
+    });
+  });
 });