WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / HTML

onmessage — Nachrichten des Fensters verarbeiten

Das onmessage-Attribut von body legt den message-Ereignishandler des Window-Objekts fest. Er empfängt unter anderem Nachrichten, die mit postMessage gesendet wurden. Prüfen Sie Absender und Nutzdaten, bevor Sie empfangene Daten verwenden.

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

Syntax

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

onmessage ist ein Ereignis-Handler-Attribut für message. In HTML kann es am Element body stehen; es ist kein globales Attribut. Sein Code behandelt Ereignisse des Window-Objekts, nicht Nachrichten, die an das Element body selbst gerichtet sind. Der Attributwert ist JavaScript-Code, der auf den Parameter event zugreifen kann.

In JavaScript legt window.onmessage = handleMessage denselben Handler fest. Eine weitere Zuweisung ersetzt ihn; durch Zuweisung von null wird er entfernt. Mit window.addEventListener("message", handleMessage) lassen sich zusätzliche Listener registrieren, ohne diesen Handler zu ersetzen.

Eine mit postMessage gesendete Nachricht wird asynchron als MessageEvent zugestellt: event.data enthält die Nutzdaten, event.origin gibt den Ursprung des Absenders an und event.source bezeichnet die Quelle. Prüfen Sie den erwarteten Ursprung, die Quelle und die Struktur der Nutzdaten. Geben Sie beim Senden den genauen Zielursprung statt "*" an, besonders bei vertraulichen Daten. Das Attribut selbst sendet keine Nachrichten.

Das Beispiel sendet eine Nachricht an dasselbe Fenster. Führen Sie es über lokales HTTP aus, nicht als file:-Dokument. Erwartet wird, dass sich Waiting in Hello ändert. Eine CSP, die Inline-Code blockiert, kann die Ausführung des Skripts oder Attributs verhindern. Verschieben Sie den Code in diesem Fall in eine erlaubte JavaScript-Datei und verwenden Sie addEventListener.

Beispiele

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

Ergebnis

Hello

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen