Support to imperatively skip scenario Fixes #873

features/skipped_steps.feature

@@ -0,0 +1,61 @@
+Feature: Skipped steps
+
+  Background:
+    Given a file named "features/skipped.feature" with:
+      """
+      Feature: a feature
+        Scenario: a scenario
+          Given a skipped step
+      """
+
+  Scenario: Synchronous pending step
+    Given a file named "features/step_definitions/skipped_steps.js" with:
+      """
+      import {defineSupportCode} from 'cucumber'
+
+      defineSupportCode(({Given}) => {
+        Given(/^a skipped step$/, function() {
+          return 'skipped'
+        })
+      })
+      """
+    When I run cucumber.js
+    Then it passes
+    And the step "a skipped step" has status "skipped"
+
+
+  Scenario: Callback pending step
+    Given a file named "features/step_definitions/skipped_steps.js" with:
+      """
+      import {defineSupportCode} from 'cucumber'
+
+      defineSupportCode(({Given}) => {
+        Given(/^a skipped step$/, function(callback) {
+          callback(null, 'skipped')
+        })
+      })
+      """
+    When I run cucumber.js
+    Then it passes
+    And the step "a skipped step" has status "skipped"
+
+  Scenario: Promise pending step
+    Given a file named "features/step_definitions/skipped_steps.js" with:
+      """
+      import {defineSupportCode} from 'cucumber'
+
+      defineSupportCode(({Given}) => {
+        Given(/^a skipped step$/, function(){
+          return {
+            then: function(onResolve, onReject) {
+              setTimeout(function() {
+                onResolve('skipped')
+              })
+            }
+          }
+        })
+      })
+      """
+    When I run cucumber.js
+    Then it passes
+    And the step "a skipped step" has status "skipped"

src/runtime/step_runner.js

@@ -50,7 +50,9 @@ async function run({
 
   const testStepResult = { duration: endTiming() }
 
-  if (result === 'pending') {
+  if (result === 'skipped') {
+    testStepResult.status = Status.SKIPPED
+  } else if (result === 'pending') {
     testStepResult.status = Status.PENDING
   } else if (error) {
     testStepResult.exception = error