Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / HTML

onmessageerror — zpracování chyby při deserializaci zprávy

Atribut onmessageerror na body nastavuje obslužnou rutinu messageerror objektu Window. Událost signalizuje neúspěšnou deserializaci příchozí zprávy, nikoli libovolnou chybu komunikace.

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

Syntaxe

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

onmessageerror je HTML atribut obsluhy události messageerror. Na prvku body nastavuje obslužnou rutinu pro přidružený objekt Window, nikoli pro událost cílenou na samotný element. Nejde o globální atribut pro libovolné elementy. Hodnotou atributu je kód JavaScriptu; parametr event zpřístupňuje objekt MessageEvent.

Při komunikaci přes postMessage() příjemce rekonstruuje přenesená data pomocí strukturované deserializace. Pokud tento krok selže, obdrží messageerror místo message. Nejde o obecné oznámení ztracených zpráv ani o chybu při vykonávání kódu příjemce. Chyba serializace na straně odesílatele může místo toho při volání postMessage() vyvolat synchronní výjimku DataCloneError.

V JavaScriptu přiřaďte funkci k window.onmessageerror nebo použijte window.addEventListener("messageerror", handler). Atribut na body a vlastnost window.onmessageerror odkazují na stejnou obslužnou rutinu; další přiřazení ji nahradí a přiřazení null ji odstraní. addEventListener() umožňuje přidat nezávislé posluchače.

Příklad záměrně vyvolá syntetickou událost na window, aby byl výsledek deterministický. Ověřuje propojení atributu s obsluhou události, ale nezpůsobuje skutečné selhání deserializace. Bezpečnostní zásady blokující vložené skripty nebo obsluhy událostí mohou zabránit spuštění.

Pří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ýsledek

messageerror

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje