async-describe

A simple way for making async tests procedures

Installation

npm install --save-dev async-describe

API

async-describe is designed for running async end to end tests

describe(text, async fn)

• describes block can be nested.

test(text, async fn)

• cannot be nested in another test block.
• should be used inside a describe block.

Example

const { describe, test } = require('async-describe');
 
const sleep = ms => new Promise(resolve => setTimeout(resolve, ms));
 
describe('tests', async () => {
  await describe('build client', async () => {
    await test('test');
  });
  await describe('start server', async () => {
    await test('test 1', async () => {
    })
    await test('test 2', async () => {
      console.warn('console.warn');
    })
    await test('test 3', sleep(1)) // test() can take a promise instead of an async function
    await sleep(100);
  });
  await describe('additional test I')
  await describe('additional test II', async () => {
    await test('test3', async () => {
      console.log('console.log');
    })
  })
  await describe('run functional tests', async () => {
    await sleep(100);
    await test('test4', async () => {
      throw new Error('1')
    })
    await test('test4', async () => {
      throw new Error('2')
    })
  });
  await describe('more test', async () => {
    throw new Error('Fatal')
  })
  await describe('more test')
  await describe('more test')
});