Folha de dicas de controle de fluxo assíncrono com co

co co é a clássica biblioteca de controle de fluxo assíncrono baseada em geradores que preparou o terreno para o async/await no JavaScript.

Executando geradores

const co = require('co');

co(function* () {
  const result = yield Promise.resolve(42);
  return result * 2;
}).then(val => {
  console.log(val); // 84
}).catch(err => {
  console.error(err);
});

Uma função geradora pode usar yield com promessas, thunks, arrays ou objetos. co() executa o gerador até sua conclusão.

---

Gerador para função reutilizável com promessa (co.wrap)

Converte um gerador em uma função padrão que retorna uma promessa (idêntico a uma async function moderna):

const getUser = co.wrap(function* (id) {
  const user = yield db.users.findById(id);
  const posts = yield db.posts.findByUser(user.id);
  return { user, posts };
});

// A chamada retorna uma promessa normal:
getUser(123).then(data => {
  console.log(data);
});

---

Trabalhando com APIs de callback do Node.js

Uso de thunkify ou wrappers com promessas:

const thunkify = require('thunkify');
const fs = require('fs');

const readFile = thunkify(fs.readFile);

co(function* () {
  const content = yield readFile('config.json', 'utf8');
  console.log(JSON.parse(content));
});

---

Execução paralela (Arrays e Objetos)

co(function* () {
  // Resolução paralela em array
  const [user, profile] = yield [fetchUser(), fetchProfile()];

  // Resolução paralela em objeto
  const data = yield {
    user: fetchUser(),
    profile: fetchProfile()
  };
  console.log(data.user, data.profile);
});