JavaScript Promise-objekti

Promise-objekti edustaa asynkronisen toiminnan valmistumista tai epäonnistumista sekä tulosta.

Yksi Promise voi olla seuraavassa 3 tilassa:

Odottava Alkuperäinen tila
Hylätty Toiminto epäonnistui
Täytetty Toiminto valmis

Esimerkki

// Luo Promise-objekti
let myPromise = new Promise(function(myResolve, myReject) {
  let result = true;
// Tässä voidaan sijoittaa mahdollisesti pitkäaikainen koodi
  if (result == true) {
    myResolve("OK");
  }
    myReject("Error");
  }
});
// Näytä tulokset then() -funktiolla
myPromise.then(x => myDisplay(x), x => myDisplay(x));

Kokeile itse

JavaScript Promise-metodit ja -ominaisuudet

Nimi Kuvaus
Promise.all()

Palauttaa yhden ainoan Promise-objektin joukosta Promise-objekteja.

Kun kaikki Promise-objektit on täytetty.
Promise.allSettled()

Palauttaa yhden ainoan Promise-objektin joukosta Promise-objekteja.

Kun kaikki Promise-objektit on ratkaistu.
Promise.any()

Palauttaa yhden ainoan Promise-objektin joukosta Promise-objekteja.

Kun jokin Promise ratkaistaan.
Promise.race()

Palauttaa yhden ainoan Promise-objektin joukosta Promise-objekteja.

Kun nopeampi Promise ratkaistaan.
Promise.reject() Palauttaa hylätyin ja arvolle varattun Promise-objektin.
Promise.resolve() Palauttaa ratkaistun ja arvolle varattun Promise-objektin.
catch() Tarjoaa funktiota, joka kutsutaan kun Promise on hylätty.
finally() Tarjoaa funktiota, joka kutsutaan kun Promise on täytetty tai hylätty.
then() Tarjoaa kaksi funktiota, jotka kutsutaan kun Promise on täytetty tai hylätty.

Katso myös:

Ohje:JavaScript Promise