cheatsheets/co.md

title
co

co allows you to use generators to manage async flow.

Running generators

A generator can yield a thunk or promise. Using co() will immediately invoke the block inside it.

co(function * () {
  yield Promise.resolve(true)
}).then(...)

Generator → Promise

Use co.wrap(). Most of the time, you'll be using co.wrap.

var fn = co.wrap(function * (val) {
  return yield Promise.resolve(val)
})

fn().then(...)

Generator → Node callback

Use unyield. (You can thunkify this later)

var get = unyield(function * () {
})

get(function (err, res) { ... })

Node callback → Thunk

Use thunkify. You can yield this. You can also use promisify too.

var readFile = thunkify(fs.readFile)

co(function * () {
  var data = yield readFile('index.txt', 'utf-8')
})