CKTIS / JavaScript
Promise.reject — vytvoření zamítnutého příslibu
Promise.reject(reason) vytvoří nový zamítnutý příslib s uvedeným důvodem. Obslužné funkce zamítnutí se spouštějí asynchronně, přestože vrácený příslib je zamítnutý už při vrácení.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
Promise.reject(reason)Promise.reject(reason) je statická metoda konstruktoru Promise. Vrací nový příslib ve stavu zamítnutí, jehož důvodem zamítnutí je reason. Důvodem může být libovolná hodnota; při vynechání argumentu se použije undefined. U chyb je vhodné použít objekt Error.
Metoda nepřebírá stav předaného příslibu ani objektu s metodou then (thenable). Samotný tento argument se stane důvodem zamítnutí. Na rozdíl od Promise.resolve nevrací Promise.reject předaný příslib beze změny.
Běžné volání Promise.reject(reason) není synchronní throw: okolní try...catch samotné zamítnutí nezachytí. Použijte .catch(...) nebo try...catch kolem await. Obslužné funkce příslibů se spustí až po dokončení aktuálního synchronního kódu. Zamítnutí zpracovávejte; reakce hostitelského prostředí na nezpracované zamítnutí závisí na daném prostředí.
V příkladu se sync zobrazí před spuštěním obslužné funkce zamítnutí a true potvrzuje, že důvod zachovává svou identitu. Metodu volejte jako Promise.reject(...): její this musí být konstruktor kompatibilní s konvencemi konstruktoru Promise, takže oddělené volání bez správného příjemce může vyvolat TypeError.
Příklady
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");Výsledek
sync true Invalid input
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.