Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

MessageEvent: vlastnosti source, origin a data

Rozliš odkaz na odesílatele, jeho původ v okamžiku odeslání a data, která je třeba ověřit před zpracováním zprávy mezi okny.

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

Syntaxe

event.source
 event.origin
 event.data

source, origin a data jsou vlastnosti instance MessageEvent pouze pro čtení. Patří do API webové platformy, nikoli do ECMAScriptu 2024; jejich dostupnost závisí na běhovém prostředí.

U Window.postMessage() je event.source objekt WindowProxy kontextu prohlížení odesílatele. Když okno pošle zprávu samo sobě, mají odesílatel i příjemce stejný objekt WindowProxy. V závislosti na API může být source také MessagePort (například při události connect sdíleného workeru), ServiceWorker nebo null. U běžné události message doručené přes MessagePort má source hodnotu null a origin hodnotu "".

Při komunikaci mezi okny obsahuje event.origin serializovaný původ odesílatele v okamžiku odeslání: schéma, hostitele a případně port, bez cesty, dotazu a fragmentu. Po navigaci může tentýž WindowProxy odkazovat na jiný dokument, takže origin neříká, co je načteno právě teď. Neprůhledný původ se serializuje jako řetězec "null", který se liší od prázdného řetězce "" i od hodnoty null v JavaScriptu.

event.data obsahuje odeslaná data. Window.postMessage() používá strukturované klonování, nikoli JSON ani přímý odkaz na původní objekt. Při odeslání hodnoty, kterou nelze klonovat, například funkce, vznikne na straně odesílatele výjimka DataCloneError.

Před zpracováním data porovnej origin s přesným očekávaným původem pomocí ===, zkontroluj source, pokud znáš očekávané okno, a ověř strukturu a hodnoty dat. Při odesílání nebo odpovědi zadej přesný targetOrigin, pokud ho znáš. Omezuje příjemce a nenahrazuje jeho kontroly příchozích zpráv. Neposílej důvěrná data s "*".

Příklady

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

Výsledek

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

Zpřístupni soubor HTML přes HTTP(S) a otevři ho na kartě prohlížeče bez sandboxu. Okno pošle zprávu samo sobě. Tři řádky se vypíšou asynchronně do konzole prohlížeče poté, co obsluha události přijme zprávu a odebere svůj posluchač.

Související lekce

  • JavaScript · Lekce 5 · Pokročilá · Verze: 4

Zdroje