Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / HTML

onmessageerror — obrada pogreške pri deserijalizaciji poruke

Atribut onmessageerror na body postavlja obrađivač messageerror objekta Window. Događaj označava neuspjelu deserijalizaciju primljene poruke, a ne proizvoljnu komunikacijsku pogrešku.

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

Sintaksa

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

onmessageerror je HTML atribut za obradu događaja messageerror. Na elementu body postavlja obrađivač za povezani Window, a ne za događaj usmjeren na sam element. Nije globalni atribut za proizvoljne elemente. Vrijednost atributa je JavaScript kod; parametar event omogućuje pristup objektu MessageEvent.

Pri komunikaciji putem postMessage() primatelj rekonstruira prenesene podatke strukturiranom deserijalizacijom. Ako taj korak ne uspije, prima messageerror umjesto message. To nije opća obavijest o izgubljenim porukama ni pogreška pri izvršavanju koda primatelja. Pogreška pri serijalizaciji na strani pošiljatelja može umjesto toga pri pozivu postMessage() izazvati sinkronu iznimku DataCloneError.

U JavaScriptu dodijelite funkciju svojstvu window.onmessageerror ili upotrijebite window.addEventListener("messageerror", handler). Atribut na body i svojstvo window.onmessageerror odnose se na isti obrađivač; nova ga dodjela zamjenjuje, a dodjela vrijednosti null uklanja ga. addEventListener() omogućuje dodavanje neovisnih slušatelja.

Primjer namjerno šalje sintetički događaj objektu window kako bi rezultat bio deterministički. Provjerava povezivanje atributa s obrađivačem događaja, ali ne uzrokuje stvarnu pogrešku pri deserijalizaciji. Sigurnosna pravila koja blokiraju umetnute skripte ili obrađivače događaja mogu spriječiti njegovo izvođenje.

Primjeri

<!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>

Rezultat

messageerror

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori