WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

MessageEvent: source, origin und data

Unterscheide die Referenz auf den Absender, dessen Origin beim Senden und die Nutzdaten und prüfe sie vor dem Verarbeiten einer Fensternachricht.

Version: ECMAScript 2024 and the current web platform; runtime support varies

Syntax

event.source
 event.origin
 event.data

source, origin und data sind schreibgeschützte Instanzeigenschaften von MessageEvent. Sie gehören zu einer Webplattform-API, nicht zu ECMAScript 2024; ihre Verfügbarkeit hängt von der Laufzeitumgebung ab.

Bei Window.postMessage() ist event.source der WindowProxy des sendenden Browsing-Kontexts. Sendet ein Fenster eine Nachricht an sich selbst, haben Absender und Empfänger denselben WindowProxy. Je nach API kann source auch ein MessagePort (etwa beim connect-Ereignis eines Shared Workers), ein ServiceWorker oder null sein. Bei einem gewöhnlichen message-Ereignis über einen MessagePort ist source gleich null und origin gleich "".

Bei Nachrichten zwischen Fenstern enthält event.origin die serialisierte Origin des Absenders zum Sendezeitpunkt: Schema, Host und gegebenenfalls Port, ohne Pfad, Query oder Fragment. Derselbe WindowProxy kann nach einer Navigation auf ein anderes Dokument verweisen; origin sagt also nicht, was gerade geladen ist. Eine opake Origin wird als Zeichenkette "null" serialisiert. Diese unterscheidet sich von der leeren Zeichenkette "" und dem JavaScript-Wert null.

event.data enthält die Nutzdaten. Window.postMessage() verwendet den strukturierten Klonalgorithmus, nicht JSON oder einen direkten Verweis auf das ursprüngliche Objekt. Beim Senden eines nicht klonbaren Werts, etwa einer Funktion, wird auf der Senderseite DataCloneError ausgelöst.

Vergleiche vor der Verarbeitung von data die origin per === mit der exakt erwarteten Origin, prüfe source, wenn du das erwartete Fenster kennst, und validiere Struktur und Werte der Nutzdaten. Gib beim Senden oder Antworten eine exakte targetOrigin an, sofern sie bekannt ist. Sie schränkt den Empfänger ein und ersetzt dessen Prüfungen eingehender Nachrichten nicht. Sende keine vertraulichen Daten mit "*".

Beispiele

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>MessageEvent: source, origin, and data</title>
</head>
<body>
<script>
(() => {
  const expectedOrigin = window.location.origin;
  const expectedSource = window;

  function receive(event) {
    if (event.origin !== expectedOrigin || event.source !== expectedSource) return;

    const data = event.data;
    if (data === null || typeof data !== "object" ||
        data.type !== "cktis:count" || !Number.isInteger(data.count)) return;

    window.removeEventListener("message", receive);
    console.log(`source === window: ${event.source === window}`);
    console.log(`origin === expectedOrigin: ${event.origin === expectedOrigin}`);
    console.log(`data.count: ${data.count}`);
  }

  window.addEventListener("message", receive);
  window.postMessage({ type: "cktis:count", count: 7 }, expectedOrigin);
})();
</script>
</body>
</html>

Ergebnis

source === window: true
origin === expectedOrigin: true
data.count: 7

Stelle die HTML-Datei über HTTP(S) bereit und öffne sie in einem Browser-Tab ohne Sandbox. Das Fenster sendet sich selbst eine Nachricht. Die drei Zeilen erscheinen asynchron in der Browserkonsole, nachdem der Handler die Nachricht angenommen und seinen Listener entfernt hat.

Zugehörige Lektionen

  • JavaScript · Lektion 5 · Fortgeschritten · Version: 4

Quellen