CKTIS / HTML
onunhandledrejection — neobrađeno odbijanje obećanja
Atribut onunhandledrejection na body registrira rukovatelj za događaj unhandledrejection objekta Window. Omogućuje pristup razlogu odbijanja obećanja koje u trenutku obavijesti još nema rukovatelj za odbijanje.
Verzija: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaksa
<body onunhandledrejection="/* JavaScript using event */">onunhandledrejection je atribut rukovatelja događaja čija je vrijednost JavaScript kôd. Na body postavlja rukovatelj za događaj unhandledrejection objekta Window, a ne za zaseban događaj elementa. Nije uobičajen globalni atribut HTML-a dostupan na svakom elementu. Njegov je ekvivalent u JavaScriptu svojstvo window.onunhandledrejection.
Obavijest je asinkrona. Ako se rukovatelj odbijanja doda dovoljno rano, događaj se neće dogoditi. Objekt event vrste je PromiseRejectionEvent: event.promise označava odbijeno obećanje, a event.reason sadrži razlog odbijanja.
Poziv event.preventDefault() otkazuje zadano prijavljivanje tog događaja u konzoli; ne popravlja obećanje. Očekivane pogreške obrađuj na njihovu izvoru, umjesto da se oslanjaš isključivo na globalnu obavijest.
Primjer postavlja atribut na body i obrađuje odbijanje obećanja pomoću promise.catch(() => {}). Poziv window.dispatchEvent() na objektu window pokreće sintetički događaj unhandledrejection koji se može otkazati. Time se poziva rukovatelj koji ispisuje event.reason u konzolu. Primjer pokazuje da je rukovatelj povezan s događajem, a ne kako preglednik obavještava o neobrađenom odbijanju. Poziv event.preventDefault() ovdje se odnosi samo na sintetički događaj i ne pokazuje kako se sprječava zadana prijava neobrađenog odbijanja u pregledniku. Umetnuti kôd zahtijeva dopuštenje prema sigurnosnim pravilima stranice.
Primjeri
<!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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.