CKTIS / HTML
onmessage — gérer les messages de la fenêtre
L’attribut onmessage de body définit le gestionnaire de l’événement message de l’objet Window. Il reçoit notamment les messages envoyés avec postMessage ; vérifiez l’expéditeur et les données avant de les utiliser.
Version : WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
<body onmessage="handleMessage(event)">
window.onmessage = handleMessage;
window.addEventListener("message", handleMessage);onmessage est un attribut de gestionnaire d’événement pour message. En HTML, il peut apparaître sur l’élément body ; ce n’est pas un attribut global. Son code gère les événements de l’objet Window, et non les messages adressés à l’élément body lui-même. La valeur de l’attribut est du code JavaScript qui peut accéder au paramètre event.
En JavaScript, window.onmessage = handleMessage définit le même gestionnaire. Une autre affectation le remplace, et l’affectation de null le supprime. window.addEventListener("message", handleMessage) permet d’ajouter des écouteurs sans remplacer ce gestionnaire.
Un message envoyé avec postMessage est transmis de façon asynchrone sous forme de MessageEvent : event.data contient les données, event.origin indique l’origine de l’expéditeur et event.source identifie la source. Vérifiez l’origine et la source attendues, ainsi que la structure des données. Lors de l’envoi, indiquez l’origine cible exacte plutôt que "*", en particulier pour les données confidentielles. L’attribut lui-même n’envoie pas de messages.
L’exemple envoie un message à la même fenêtre. Exécutez-le via HTTP local, et non comme un document file:. Le résultat attendu est que Waiting devienne Hello. Une CSP qui bloque le code intégré peut empêcher l’exécution du script ou de l’attribut ; dans ce cas, placez le code dans un fichier JavaScript autorisé et utilisez addEventListener.
Exemples
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Body onmessage handler</title>
</head>
<body onmessage="if (event.source === window && event.origin === window.origin && event.data === 'Hello') document.getElementById('result').textContent = event.data;">
<p id="result" aria-live="polite">Waiting</p>
<script>
// The destination is this same window, and the payload is not sensitive.
// A wildcard also works when the document has an opaque origin.
window.postMessage('Hello', '*');
</script>
</body>
</html>Résultat
Hello
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.