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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.