Explorando Promises: .all vs .allSettled / .race vs .any

As Promises surgiram em 2015, com o lançamento da especificação ECMAScript 6 (ES2015) do JavaScript, para deixar nossa experiência como desenvolvedor menos complicada ao lidar com operações assíncronas.

Se você estuda ou trabalha com JavaScript, com certeza já usou um Promise.all() ou um Promise.race() por aí. E pra facilitar ainda mais a vida do desenvolvedor, com o lançamento de versões mais atuais do JavaScript, tivemos acesso a dois novos métodos de Promises: Promise.allSettled() e Promise.any() (, respectivamente).

Mas qual a diferença entre eles e quando devemos usar cada um?

Sumário

Promise.all vs Promise.allSettled: foco no resultado

Promise.race vs Promise.any: foco na velocidade

é bastante útil quando você precisa garantir que todas as Promises tenham sucesso e a função receba todos os resultados que precisa antes de executar alguma outra ação.

Promise.allSettled()

• Também recebe um array de Promises como argumento;


• Também executa as operações simultaneamente (em paralelo);


• Resolve quando todas as Promises finalizam sua execução, seja com sucesso ou falha, retornando um objeto para cada Promise contendo o status desta (fulfilled ou rejected);


• Nunca rejeita e, consequentemente, não bloqueia a execução das Promises.
  

async function buscarDadosParaleloComFalhas() {   

  const resultados = await Promise.allSettled([

    fetch('/api/usuarios').then(resp => resp.json()),

    fetch('/api/produtos').then(resp => resp.json()),

  ]);



    // Verificar cada resultado individualmente:

  const dados = resultados.map(resultado => {

    if (resultado.status === 'fulfilled') {

      return resultado.value;

    } else {

      console.error(resultado.reason);

      return null;

    }

  });



  return dados;

}

O é bastante útil quando precisamos de uma resposta rápida — o primeiro retorno disponível, independente de ser sucesso ou erro. Também é bastante utilizado com timeouts, como no exemplo acima, para garantir que tenhamos qualquer resposta dentro de um limite de tempo e possamos evitar que requisições lentas continuem consumindo recursos.

Promise.any()

• Também recebe um array de Promises com argumento;


• Executa as operações simultaneamente (em paralelo);


• Retorna a primeira Promise que for concluída com sucesso, ignorando as rejeições;


• Só rejeita se todas as Promises forem rejeitadas.
  

async function buscarDadosUsuario() {

  try {

    // Retorna a primeira busca que responder com sucesso

    const resultado = await Promise.any([

      buscarCache,

      buscarBancoLocal,

      buscarAPI

    ]);



    return resultado;

  } catch (erro) {

    console.log(erro);

    // Só cai aqui se TODAS as buscas falharem

  }

}

O

Em um mundo digital cada vez mais assíncrono, entender como gerenciar múltiplas operações simultâneas em JavaScript tornou-se uma habilidade essencial para desenvolvedores. Nesse artigo, exploramos com alguns exemplos alguns métodos importantes das Promises, mostrando como cada um deles funciona e, mais importante, quando e por que você deveria escolher um em detrimento do outro.

Até a próxima (e prometo que volto em breve)!