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

CKTIS / HTML

onmessageerror — spracovanie chyby pri deserializácii správy

Atribút onmessageerror na body nastavuje obslužnú funkciu messageerror objektu Window. Udalosť signalizuje neúspešnú deserializáciu prichádzajúcej správy, nie ľubovoľnú chybu komunikácie.

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

Syntax

<body onmessageerror="handler(event)">
window.onmessageerror = handler;
window.addEventListener("messageerror", handler);

onmessageerror je HTML atribút obsluhy udalosti messageerror. Na prvku body nastavuje obslužnú funkciu pre pridružený objekt Window, nie pre udalosť zacielenú na samotný element. Nie je to globálny atribút pre ľubovoľné elementy. Hodnotou atribútu je kód JavaScriptu; parameter event sprístupňuje objekt MessageEvent.

Pri komunikácii cez postMessage() príjemca rekonštruuje prenesené údaje pomocou štruktúrovanej deserializácie. Ak tento krok zlyhá, dostane messageerror namiesto message. Nie je to všeobecné oznámenie o stratených správach ani chyba pri vykonávaní kódu príjemcu. Chyba serializácie na strane odosielateľa môže namiesto toho pri volaní postMessage() vyvolať synchrónnu výnimku DataCloneError.

V JavaScripte priraďte funkciu k window.onmessageerror alebo použite window.addEventListener("messageerror", handler). Atribút na body a vlastnosť window.onmessageerror odkazujú na tú istú obslužnú funkciu; ďalšie priradenie ju nahradí a priradenie null ju odstráni. addEventListener() umožňuje pridať nezávislých poslucháčov.

Príklad zámerne vyšle syntetickú udalosť na window, aby bol výsledok deterministický. Overuje prepojenie atribútu s obsluhou udalosti, ale nespôsobuje skutočné zlyhanie deserializácie. Bezpečnostná politika blokujúca vložené skripty alebo obslužné funkcie udalostí môže zabrániť spusteniu.

Príklady

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onmessageerror demo</title>
<body onmessageerror="document.getElementById('result').textContent = event.type">
<pre id="result">waiting</pre>
<script>
  window.dispatchEvent(new MessageEvent('messageerror'));
</script>
</body>
</html>

Výsledok

messageerror

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

Zdroje