Objeto Promise do JavaScript

Um objeto Promise representa a conclusão ou falha de uma operação assíncrona e seu resultado.

Uma Promise pode ter os seguintes 3 estados:

Pendente Estado inicial
Rejeitado Falha
Cumprido Operação concluída

Instância

// Cria um objeto Promise
let myPromise = new Promise(function(myResolve, myReject) {
  let result = true;
// Aqui deve ser colocado código que pode demorar mais tempo para ser executado
  if (result == true) {
    myResolve("OK");
  }
    myReject("Error");
  }
});
// Use then() para exibir o resultado
myPromise.then(x => myDisplay(x), x => myDisplay(x));

Experimente você mesmo

Métodos e propriedades de Promise do JavaScript

Nome Descrição
Promise.all()

Retorna uma única Promise a partir de um grupo de Promises.

Quando todas as Promises forem concluídas.
Promise.allSettled()

Retorna uma única Promise a partir de um grupo de Promises.

Quando todas as Promises forem resolvidas.
Promise.any()

Retorna uma única Promise a partir de um grupo de Promises.

Quando qualquer Promise for resolvida.
Promise.race()

Retorna uma única Promise a partir de um grupo de Promises.

Quando uma Promise mais rápida for resolvida.
Promise.reject() Retorna um objeto Promise rejeitado e com valor.
Promise.resolve() Retorna um objeto Promise resolvido e com valor.
catch() Fornece uma função que é chamada quando uma Promise é rejeitada.
finally() Fornece uma função que é chamada quando uma Promise é resolvida ou rejeitada.
then() Fornece duas funções que são chamadas quando uma Promise é resolvida ou rejeitada.

Veja também:

Tutorial:Promise do JavaScript