CKTIS / JavaScript
Promise.reject — създаване на отхвърлен promise
Promise.reject(reason) създава нов отхвърлен promise с посочената причина. Обработчиците на отхвърляне се изпълняват асинхронно, въпреки че върнатият promise вече е отхвърлен в момента на връщането.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
Promise.reject(reason)Promise.reject(reason) е статичен метод на конструктора Promise. Той връща нов promise в състояние на отхвърляне, като reason е причината за отхвърлянето. Причината може да бъде всякаква стойност; ако аргументът е пропуснат, се използва undefined. При грешки предпочитайте обект Error.
Методът не приема състоянието на подаден promise или на обект с метод then (thenable). Самият аргумент става причина за отхвърлянето. За разлика от Promise.resolve, Promise.reject не връща подаден promise без промяна.
Обикновеното извикване на Promise.reject(reason) не е синхронен throw: обгръщащ try...catch няма да улови самото отхвърляне. Използвайте .catch(...) или try...catch около await. Обработчиците на promise се изпълняват едва след като приключи текущият синхронен код. Обработвайте отхвърлянията; реакцията на хост средата към необработено отхвърляне зависи от средата.
В примера sync се появява преди изпълнението на обработчика на отхвърлянето, а true потвърждава, че причината запазва идентичността си. Извиквайте метода като Promise.reject(...): неговото this трябва да бъде конструктор, съвместим с конвенциите на конструктора Promise, затова отделно извикване без правилния получател може да хвърли TypeError.
Примери
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");Резултат
sync true Invalid input
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.