CKTIS / HTML
onunhandledrejection — nezpracované odmítnutí příslibu
Atribut onunhandledrejection na body registruje obslužnou rutinu události unhandledrejection objektu Window. Zpřístupňuje důvod odmítnutí příslibu, který v okamžiku oznámení stále nemá obslužnou rutinu odmítnutí.
Verze: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
<body onunhandledrejection="/* JavaScript using event */">onunhandledrejection je atribut obslužné rutiny události, jehož hodnotou je kód JavaScriptu. Na body nastavuje obslužnou rutinu události unhandledrejection objektu Window, nikoli samostatné události prvku. Nejde o běžný globální atribut HTML dostupný na každém prvku. Odpovídající vlastností v JavaScriptu je window.onunhandledrejection.
Oznámení je asynchronní. Pokud se obslužná rutina odmítnutí připojí dostatečně brzy, událost nenastane. Objekt event je typu PromiseRejectionEvent: event.promise označuje odmítnutý příslib a event.reason obsahuje důvod odmítnutí.
Volání event.preventDefault() zruší výchozí hlášení této události v konzoli; příslib tím neopraví. Očekávané chyby řešte v místě jejich vzniku, místo abyste spoléhali pouze na globální oznámení.
Příklad nastaví atribut na body a zpracuje odmítnutí příslibu pomocí promise.catch(() => {}). Volání window.dispatchEvent() vyvolá na objektu window syntetickou událost unhandledrejection, kterou lze zrušit. Tím se spustí obslužná rutina, která vypíše event.reason do konzole. Příklad ukazuje, že je obslužná rutina připojena, nikoli to, jak prohlížeč oznamuje nezpracované odmítnutí. Volání event.preventDefault() se zde týká pouze syntetické události a neukazuje potlačení výchozího hlášení prohlížeče o nezpracovaném odmítnutí. Vložený kód vyžaduje povolení podle zásad zabezpečení stránky.
Příklady
<!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>Výsledek
reason: demo
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.