Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori