mocha-bdd-extend

mocha-bdd-extend

Extend BDD Interfaces for Mocha

step() function, as a drop-in replacement for it(). Any failing step will abort the all describe immediately. This is handy for BDD-like scenarios, or smoke tests that need to run through specific steps.

Setup

Then simply run mocha with --require mocha-bdd-extend --ui bdd-extend.

Example

describe('my smoke test', function() {

  step('open page', function() {});

  step('switch test case', function() {});

  step('check element is exists', function() {
    // switch test case to enable
    changePending.call(this, 'check pending test case', false);
  });

  step('check pending test case', function() {});

  step('select item', function() {
    throw new Error('failed');
  });

  step('buy item', function() {});
  
  xstep('ignored step', function() {});

  // switch off test to pending
  changePending('switch test case', true);
  changePending('check pending test case', true);
});

• With the standard it()

my smoke test
   ✓ open page
   ✗ select item
   ✓ buy item

• Using step()

my smoke test
   ✓ open page
   ✗ select item
   - switch test case
   ✓ check element is exists
   ✓ check pending test case
   - buy item (abort all suites)

Notes

• Unlike Mocha's --bail option, the rest of the test suite will run normally.
• step() works with both synchronous and async tests.