Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje