CKTIS / HTML
onunhandledrejection — neobravnavana zavrnitev obljube
Atribut onunhandledrejection na body registrira obravnavo dogodka unhandledrejection objekta Window. Omogoča dostop do razloga zavrnitve obljube, ki v trenutku obvestila še nima obravnave zavrnitve.
Različica: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaksa
<body onunhandledrejection="/* JavaScript using event */">onunhandledrejection je atribut za obravnavo dogodka, katerega vrednost je koda JavaScript. Na body nastavi obravnavo dogodka unhandledrejection objekta Window, ne pa ločenega dogodka elementa. Ne gre za običajen globalni atribut HTML, ki bi bil na voljo na vsakem elementu. Ustrezna lastnost v JavaScriptu je window.onunhandledrejection.
Obvestilo je asinhrono. Če je obravnava zavrnitve dodana dovolj zgodaj, se dogodek ne sproži. Objekt event je vrste PromiseRejectionEvent: event.promise označuje zavrnjeno obljubo, event.reason pa vsebuje razlog zavrnitve.
Klic event.preventDefault() prekliče privzeto poročanje o tem dogodku v konzoli; obljube ne popravi. Pričakovane napake obravnavaj na njihovem izvoru, namesto da bi se zanašal samo na globalno obvestilo.
Primer nastavi atribut na body in obravnava zavrnitev obljube z promise.catch(() => {}). Klic window.dispatchEvent() na objektu window sproži sintetični dogodek unhandledrejection, ki ga je mogoče preklicati. S tem se izvede funkcija za obravnavo dogodka, ki v konzolo izpiše event.reason. Primer pokaže, da je funkcija povezana z dogodkom, ne pa, kako brskalnik obvesti o neobravnavani zavrnitvi. Klic event.preventDefault() se tu nanaša le na sintetični dogodek in ne prikazuje preprečitve privzetega poročanja brskalnika o neobravnavani zavrnitvi. Vdelana koda zahteva dovoljenje v skladu z varnostnim pravilnikom strani.
Primeri
<!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>Rezultat
reason: demo
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.