Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / HTML

onmessageerror — obravnava napake pri deserializaciji sporočil

Atribut onmessageerror na body nastavi obravnavo dogodka messageerror za objekt Window. Dogodek označuje neuspešno deserializacijo prejetega sporočila, ne pa poljubne napake pri komunikaciji.

Različica: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaksa

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

onmessageerror je atribut HTML za obravnavo dogodka messageerror. Na elementu body nastavi obravnavo za povezani Window, ne pa za dogodek, usmerjen na sam element. Ne gre za globalni atribut za poljubne elemente. Vrednost atributa je koda JavaScript; parameter event omogoča dostop do objekta MessageEvent.

Pri komunikaciji prek postMessage() prejemnik obnovi prenesene podatke s strukturirano deserializacijo. Če ta korak ne uspe, prejme messageerror namesto message. To ni splošno obvestilo o izgubljenih sporočilih ali napaka pri izvajanju kode prejemnika. Napaka pri serializaciji na strani pošiljatelja lahko namesto tega ob klicu postMessage() sproži sinhrono izjemo DataCloneError.

V JavaScriptu funkcijo dodelite window.onmessageerror ali uporabite window.addEventListener("messageerror", handler). Atribut na body in lastnost window.onmessageerror se nanašata na isto obravnavo; naslednja dodelitev jo nadomesti, dodelitev null pa odstrani. addEventListener() omogoča dodajanje neodvisnih poslušalcev.

Primer namenoma sproži sintetični dogodek na window, da zagotovi determinističen rezultat. Preveri povezavo atributa z obravnavo dogodka, vendar ne povzroči dejanske napake pri deserializaciji. Varnostna politika, ki blokira vstavljene skripte ali obravnavo dogodkov, lahko prepreči izvajanje.

Primeri

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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri