Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Funkcje resolve i reject w executorze Promise

Konstruktor `Promise` przekazuje executorowi dwie funkcje. Pierwsze wywołanie jednej z nich wiąże wynik obietnicy, ale nie zawsze natychmiast kończy oczekiwanie.

Wersja: ECMAScript 2024 and the current web platform; runtime support varies

Składnia

new Promise((resolve, reject) => { /* Call resolve(value) or reject(reason). */ });

new Promise(executor) wymaga funkcji i wywołuje ją synchronicznie, przekazując najpierw resolve, a potem reject. To umowne nazwy parametrów, a każda para funkcji jest związana z jedną nową obietnicą. Funkcje zwracają undefined i można je zachować, by wywołać je później, na przykład w funkcji zwrotnej. W przeciwieństwie do nich statyczne metody Promise.resolve() i Promise.reject() zwracają obietnice.

resolve(value) natychmiast spełnia obietnicę wartością prymitywną. Przekazanie do resolve tej samej obietnicy powoduje odrzucenie z TypeError. Dla każdego innego obiektu JavaScript odczytuje właściwość then synchronicznie. Jeśli odczytana wartość nie jest wywoływalna, obietnica natychmiast spełnia się samym obiektem, nawet jeśli jest on inną obietnicą. Jeśli odczytana wartość jest wywoływalna, obiekt jest thenable: JavaScript wywołuje then później, a obietnica przejmuje wynik tego obiektu i może nadal oczekiwać. Wyjątek przy odczycie then lub podczas jego wywołania, zanim użyje ono którejkolwiek z przekazanych mu funkcji zwrotnych, również powoduje odrzucenie.

reject(reason) natychmiast odrzuca obietnicę z podaną przyczyną, nie przejmując jej wyniku nawet wtedy, gdy jest ona obietnicą. Przyczyną może być dowolna wartość, ale zwykle warto użyć obiektu Error. Pominięty argument oznacza undefined. Liczy się tylko pierwsze wywołanie z danej pary, nawet jeśli obietnica nadal oczekuje. Wynik jest już związany (resolved), lecz stan jest ostateczny (settled) dopiero po spełnieniu lub odrzuceniu. Funkcje obsługi z then() i catch() wykonują się asynchronicznie.

Konstruktor ignoruje wartość zwróconą przez executor. Wyjątek, który synchronicznie wydostanie się z executora, odrzuca obietnicę tylko wtedy, gdy żadna z funkcji nie została jeszcze wywołana. Jeśli żadna z nich nie zostanie nigdy wywołana i executor nie zgłosi wyjątku, obietnica pozostanie w stanie oczekiwania. Nie używaj executora async: konstruktor ignoruje zwróconą przez niego obietnicę, więc jej odrzucenie nie odrzuca obietnicy zewnętrznej.

Przykłady

{
  let finish;
  const inner = new Promise((resolve) => {
    finish = resolve;
  });

  const outer = new Promise((resolve, reject) => {
    console.log("executor");
    resolve(inner);
    reject(new Error("ignored"));
  });

  console.log("after constructor");
  outer.then((value) => {
    console.log(`fulfilled: ${value}`);
    return new Promise((resolve, reject) => {
      reject(new Error("failed"));
    });
  }).catch((reason) => {
    console.log(`rejected: ${reason.message}`);
  });
  finish(42);
}

Wynik

executor
after constructor
fulfilled: 42
rejected: failed

`executor` pojawia się przed `after constructor`, bo executor działa synchronicznie. `resolve(inner)` wiąże wynik `outer`, choć `inner` nadal oczekuje, więc `reject(new Error("ignored"))` nie ma skutku. `finish(42)` spełnia `inner`; funkcja obsługi wypisuje `fulfilled: 42`, a następnie `catch()` obsługuje odrzucenie osobnej obietnicy z komunikatem `failed`.

Powiązane lekcje

  • JavaScript · Lekcja 14 · Średniozaawansowany · Wersja: 3
  • JavaScript · Lekcja 15 · Średniozaawansowany · Wersja: 3

Źródła