sugar-step

Syntactic sugar for handling asynchronous step definitions in cucumber-js

The idea is that instead of this

  Given /$I have a trivial, synchronous step^/, callback ->
    trivial.but.intersting.stuff()
    callback()

  And /$there is also a non-trivial, asynchronous stuff using promises and what not^/, callback ->
    do.stuff.that.produces.a.promise().then(
      () ->
        callback(), 
      (err) ->
        callback.fail(err))(
    )
    

you would generally prefer to write this instead:

  Given /$I have a trivial, synchronous step^/, ->
    trivial.but.intersting.stuff()

  And /$there is also a non-trivial, asynchronous stuff using promises and what not^/, ->
    do.stuff.that.produces.a.promise()

But out-of-the-box, cucumber-js won't let you do that, so I started looking for a solution. If you are like me and

• you use promises a lot
• you like your step definitions short

then this one may be just for you.

For a more detailed explanation of the How and the Why, please refer to the implementation.

Installation

npm install sugar-step

Usage

Something like this:

# wrap the original step definition directive
SugarStep = require 'sugar-step'
Given = When = Then = SugarStep @defineStep

# ... and you're good to go

module.exports = ->

  Given /^I have (\d+) cukes in my belly$/, (numberOfCukes) ->
    @belly.cukes=numberOfCukes
    
  # etc.