CKTIS / JavaScript
Promise.reject — tworzenie odrzuconej obietnicy
Promise.reject(reason) tworzy nową, odrzuconą obietnicę z podaną przyczyną. Obsługa odrzucenia wykonuje się asynchronicznie, mimo że obietnica jest odrzucona już przy zwrocie.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
Promise.reject(reason)Promise.reject(reason) jest metodą statyczną konstruktora Promise. Zwraca nową obietnicę w stanie odrzuconym z przyczyną reason. Przyczyną może być dowolna wartość; pominięcie argumentu oznacza undefined. W przypadku błędów warto przekazywać obiekt Error.
Metoda nie przejmuje stanu przekazanej obietnicy ani obiektu z metodą then (thenable). Taki argument sam staje się przyczyną odrzucenia. W przeciwieństwie do Promise.resolve, Promise.reject nie zwraca przekazanej obietnicy bez zmian.
Zwykłe wywołanie Promise.reject(reason) nie jest synchronicznym throw: zewnętrzny try...catch nie przechwyci samego odrzucenia. Użyj .catch(...) albo try...catch wokół await. Procedury obsługi obietnicy uruchamiają się dopiero po zakończeniu bieżącego kodu synchronicznego. Obsługuj odrzucenia; reakcja środowiska na nieobsłużone odrzucenie zależy od środowiska.
W przykładzie sync pojawia się przed obsługą odrzucenia, a true potwierdza zachowanie tożsamości przyczyny. Wywołuj metodę przez Promise.reject(...): jej this musi być konstruktorem zgodnym z konwencją konstruktora Promise, więc odłączone wywołanie bez właściwego odbiorcy może rzucić TypeError.
Przykłady
const reason = new Error("Invalid input");
const rejected = Promise.reject(reason);
rejected.catch((error) => {
console.log(error === reason);
console.log(error.message);
});
console.log("sync");Wynik
sync true Invalid input
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.