Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / HTML

onunhandledrejection — nespracované odmietnutie prísľubu

Atribút onunhandledrejection na body registruje obslužnú rutinu udalosti unhandledrejection objektu Window. Sprístupňuje dôvod odmietnutia prísľubu, ktorý v čase oznámenia stále nemá obslužnú rutinu odmietnutia.

Verzia: WHATWG HTML Living Standard; index snapshot date recorded separately

Syntax

<body onunhandledrejection="/* JavaScript using event */">

onunhandledrejection je atribút obslužnej rutiny udalosti, ktorého hodnotou je kód JavaScriptu. Na body nastavuje obslužnú rutinu udalosti unhandledrejection objektu Window, nie samostatnej udalosti prvku. Nie je to bežný globálny atribút HTML dostupný na každom prvku. Zodpovedajúcou vlastnosťou v JavaScripte je window.onunhandledrejection.

Oznámenie je asynchrónne. Ak sa obslužná rutina odmietnutia pripojí dostatočne skoro, udalosť nenastane. Objekt event je typu PromiseRejectionEvent: event.promise označuje odmietnutý prísľub a event.reason obsahuje dôvod odmietnutia.

Volanie event.preventDefault() zruší predvolené hlásenie tejto udalosti v konzole; prísľub tým neopraví. Očakávané chyby riešte v mieste ich vzniku, namiesto spoliehania sa výlučne na globálne oznámenie.

Príklad nastaví atribút na body a spracuje odmietnutie prísľubu pomocou promise.catch(() => {}). Volanie window.dispatchEvent() vyvolá na objekte window syntetickú udalosť unhandledrejection, ktorú možno zrušiť. Tým sa spustí obslužná rutina, ktorá vypíše event.reason do konzoly. Príklad ukazuje, že obslužná rutina je pripojená, nie to, ako prehliadač oznamuje nespracované odmietnutie. Volanie event.preventDefault() sa tu týka iba syntetickej udalosti a neukazuje potlačenie predvoleného hlásenia prehliadača o nespracovanom odmietnutí. Vložený kód vyžaduje povolenie podľa bezpečnostnej politiky stránky.

Prí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ýsledok

reason: demo

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje