KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / HTML

onmessage — berichten van het venster afhandelen

Het onmessage-attribuut van body stelt de message-eventhandler van het Window-object in. Deze ontvangt onder andere berichten die via postMessage zijn verzonden; controleer de afzender en de gegevens voordat je ontvangen gegevens gebruikt.

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

Syntax

<body onmessage="handleMessage(event)">
window.onmessage = handleMessage;
window.addEventListener("message", handleMessage);

onmessage is een eventhandlerattribuut voor message. In HTML kan het op het element body staan; het is geen globaal attribuut. De code ervan handelt gebeurtenissen van het Window-object af, niet berichten die aan het element body zelf zijn gericht. De attribuutwaarde is JavaScript-code die toegang heeft tot de parameter event.

In JavaScript stelt window.onmessage = handleMessage dezelfde handler in. Een volgende toewijzing vervangt deze; toewijzing van null verwijdert hem. Met window.addEventListener("message", handleMessage) kun je extra luisteraars registreren zonder die handler te vervangen.

Een bericht dat via postMessage is verzonden, wordt asynchroon afgeleverd als een MessageEvent: event.data bevat de gegevens, event.origin geeft de origin van de afzender aan en event.source identificeert de bron. Controleer de verwachte origin en bron, en de structuur van de gegevens. Geef bij verzending de exacte doel-origin op in plaats van "*", vooral bij vertrouwelijke gegevens. Het attribuut zelf verzendt geen berichten.

Het voorbeeld stuurt een bericht naar hetzelfde venster. Voer het uit via lokale HTTP, niet als een file:-document. Het verwachte resultaat is dat Waiting verandert in Hello. Een CSP die inline code blokkeert, kan voorkomen dat het script of attribuut wordt uitgevoerd; verplaats de code in dat geval naar een toegestaan JavaScript-bestand en gebruik addEventListener.

Voorbeelden

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Body onmessage handler</title>
</head>
<body onmessage="if (event.source === window &amp;&amp; event.origin === window.origin &amp;&amp; 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>

Resultaat

Hello

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen