This project is mainly for demo/learning/testing. Normally you will not need to use it in production, because ES7 async/await has been available in Babel and other transpilers. I recommend you to just use them. And eventually JavaScript engines in the browsers and node.js/io.js will also support async/await natively.

The only exception is if you can not use transpilers for any reason or your transpilers has not supported async/await feature, you could just use it!

There are also many other libraries which provide the same functionality such as co. The advantage of this project is, it's very simple, only 30 lines code :)

async convert a generator to an async function, which returns a promise.

var asyncSum = async(function *sum(a, b) {
	var valueA = yield a
	var valueB = yield b
	return valueA + valueB
})

var asyncResult = asyncSum(Promise.resolve(1), waitAndReturn(1000, 2))

asyncResult.then(function (value) {
	console.assert(value === 3)
})

function waitAndReturn(ms, value) {
	return new Promise(function (resolve) {
		setTimeout(function () { resolve(value) }, ms)
	})
}

• Add commented version