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

CKTIS / JavaScript

unhandledrejection — необработено отхвърляне на Promise

Събитието unhandledrejection съобщава за отхвърляне на 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

Синтаксис

window.addEventListener("unhandledrejection", (event) => { /* event.promise, event.reason */ });

unhandledrejection е събитие от Web платформата, което се изпраща до глобален обект, например window, като PromiseRejectionEvent. То не е синтаксис на ECMAScript. event.promise посочва отхвърления Promise, а event.reason съдържа причината за отхвърлянето — произволна стойност, не непременно обект Error.

Уведомяването е асинхронно: браузърът взема предвид обработчиците, добавени по време на обработката на микрозадачите, и проверява отново състоянието на обработката преди изпращането на събитието. Затова само Promise.reject() не гарантира събитие. Навременно добавен .catch() може да го предотврати; обработчик, добавен след уведомяването, може да предизвика отделно събитие rejectionhandled.

Събитието може да бъде отменено. event.preventDefault() потиска стандартното съобщение в конзолата за това отхвърляне, но не променя състоянието на Promise и не замества .catch() или try/catch около await. Използвайте го внимателно, за да не прикривате дефекти. Този механизъм не е пълен регистър на грешките: проследяването се пропуска за скриптове с флага muted errors, включително в някои случаи със скриптове от различен произход.

Примерът филтрира събитията според идентичността на Promise, извежда причината и премахва слушателя. Стартирайте го като скрипт в празна страница на браузъра, а не в Node.js. Този API е определен в HTML Living Standard; издание на ECMAScript или наличието на Node 24 не доказва поддръжка в браузърите.

Примери

(() => {
  let rejected;

  function report(event) {
    if (event.promise !== rejected) return;
    event.preventDefault();
    window.removeEventListener("unhandledrejection", report);
    console.log("unhandled:", event.reason);
  }

  window.addEventListener("unhandledrejection", report);
  rejected = Promise.reject("demo");
})();

Резултат

unhandled: demo

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

Източници