Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / HTML

onmessageerror — gérer un échec de désérialisation de message

L’attribut onmessageerror de body définit le gestionnaire messageerror de l’objet Window. L’événement signale l’échec de la désérialisation d’un message reçu, et non une erreur de communication quelconque.

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

Syntaxe

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

onmessageerror est un attribut HTML de gestionnaire d’événement pour messageerror. Sur body, il définit un gestionnaire pour le Window associé, et non pour un événement ciblant l’élément lui-même. Ce n’est pas un attribut global destiné à n’importe quel élément. La valeur de l’attribut est du code JavaScript ; le paramètre event donne accès à un MessageEvent.

Pour une communication via postMessage(), le destinataire reconstitue les données transmises au moyen de la désérialisation structurée. Si cette étape échoue, il reçoit messageerror au lieu de message. Il ne s’agit ni d’un signal général de perte de messages ni d’une erreur d’exécution du code du destinataire. Un échec de sérialisation côté expéditeur peut plutôt provoquer une exception synchrone DataCloneError lors de l’appel à postMessage().

En JavaScript, affectez une fonction à window.onmessageerror ou utilisez window.addEventListener("messageerror", handler). L’attribut sur body et la propriété window.onmessageerror désignent le même gestionnaire ; une nouvelle affectation le remplace, et l’affectation de null le supprime. addEventListener() permet d’ajouter des écouteurs indépendants.

L’exemple déclenche volontairement un événement synthétique sur window afin d’obtenir un résultat déterministe. Il vérifie le branchement de l’attribut au gestionnaire d’événement, mais ne provoque pas un véritable échec de désérialisation. Une politique de sécurité qui bloque les scripts intégrés ou les gestionnaires d’événement intégrés peut empêcher son exécution.

Exemples

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

Résultat

messageerror

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources