CKTIS / HTML
onunhandledrejection — необработено отхвърляне на Promise
Атрибутът onunhandledrejection върху body регистрира обработчик за събитието unhandledrejection на обекта Window. Той предоставя причината за отхвърляне на Promise, за който към момента на уведомяването все още няма обработчик за отхвърляне.
Версия: WHATWG HTML Living Standard; index snapshot date recorded separately
Синтаксис
<body onunhandledrejection="/* JavaScript using event */">onunhandledrejection е атрибут за обработчик на събития, чиято стойност е JavaScript код. Върху body той задава обработчика за събитието unhandledrejection на обекта Window, а не за отделно събитие на елемента. Това не е обикновен глобален HTML атрибут, наличен във всеки елемент. Съответстващото свойство в JavaScript е window.onunhandledrejection.
Уведомяването е асинхронно. Ако обработчикът за отхвърляне бъде добавен достатъчно рано, събитието няма да настъпи. Обектът event е от тип PromiseRejectionEvent: event.promise посочва отхвърления Promise, а event.reason съдържа причината за отхвърлянето.
Извикването на event.preventDefault() отменя стандартното докладване на това събитие в конзолата; то не поправя Promise. Обработвайте очакваните грешки при възникването им, вместо да разчитате единствено на глобално уведомяване.
Примерът задава атрибута върху body и обработва отхвърлянето на Promise чрез promise.catch(() => {}). Извикването на window.dispatchEvent() задейства синтетично събитие unhandledrejection върху window, което може да бъде отменено. Така се извиква обработчикът, който извежда event.reason в конзолата. Примерът показва, че обработчикът е свързан със събитието, а не как браузърът уведомява за необработено отхвърляне. Тук извикването на event.preventDefault() се отнася само до синтетичното събитие и не показва как се потиска стандартното докладване на необработено отхвърляне от браузъра. Вграденият код изисква разрешение според правилата за сигурност на страницата.
Примери
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Body onunhandledrejection handler</title>
</head>
<body onunhandledrejection="event.preventDefault(); console.log('reason: ' + event.reason)">
<script>
const reason = 'demo';
const promise = Promise.reject(reason);
// Handle the fixture so the browser does not report a real unhandled rejection.
promise.catch(() => {});
window.dispatchEvent(new PromiseRejectionEvent('unhandledrejection', {
promise,
reason,
cancelable: true
}));
</script>
</body>
</html>Резултат
reason: demo
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.