CKTIS / JavaScript
Promise.reject — vytvorenie zamietnutého prísľubu
Promise.reject(reason) vytvorí nový zamietnutý prísľub s uvedeným dôvodom. Obslužné funkcie zamietnutia sa vykonávajú asynchrónne, hoci vrátený prísľub je zamietnutý už pri vrátení.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
Promise.reject(reason)Promise.reject(reason) je statická metóda konštruktora Promise. Vráti nový prísľub v stave zamietnutia, ktorého dôvodom zamietnutia je reason. Dôvodom môže byť ľubovoľná hodnota; ak argument vynecháte, použije sa undefined. Pri chybách uprednostnite objekt Error.
Metóda nepreberá stav odovzdaného prísľubu ani objektu s metódou then (thenable). Samotný tento argument sa stane dôvodom zamietnutia. Na rozdiel od Promise.resolve nevracia Promise.reject odovzdaný prísľub bez zmeny.
Bežné volanie Promise.reject(reason) nie je synchrónny throw: okolitý try...catch samotné zamietnutie nezachytí. Použite .catch(...) alebo try...catch okolo await. Obslužné funkcie prísľubov sa spustia až po dokončení aktuálneho synchrónneho kódu. Zamietnutia spracúvajte; reakcia hostiteľského prostredia na nespracované zamietnutie závisí od prostredia.
V príklade sa sync zobrazí pred spustením obslužnej funkcie zamietnutia a true potvrdzuje, že dôvod si zachováva svoju identitu. Metódu volajte ako Promise.reject(...): jej this musí byť konštruktor kompatibilný s konvenciami konštruktora Promise, takže oddelené volanie bez správneho prijímateľa môže vyvolať TypeError.
Prí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ýsledok
sync true Invalid input
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.