База знанияИзпитен център
BGБългарски
Избери език13

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници