Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

MessageEvent: vlastnosti source, origin a data

Rozlišuj odkaz na odosielateľa, jeho pôvod v okamihu odoslania a údaje, ktoré treba overiť pred spracovaním správy medzi oknami.

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

Syntax

event.source
 event.origin
 event.data

source, origin a data sú vlastnosti inštancie MessageEvent len na čítanie. Patria do API webovej platformy, nie do ECMAScriptu 2024; ich dostupnosť závisí od prostredia, v ktorom kód beží.

Pri Window.postMessage() je event.source objekt WindowProxy kontextu prehliadania odosielateľa. Keď okno odošle správu samo sebe, odosielateľ aj príjemca majú ten istý objekt WindowProxy. Podľa API môže byť source aj MessagePort (napríklad pri udalosti connect zdieľaného workera), ServiceWorker alebo null. Pri bežnej udalosti message doručenej cez MessagePort má source hodnotu null a origin hodnotu "".

Pri komunikácii medzi oknami obsahuje event.origin serializovaný pôvod odosielateľa v okamihu odoslania: schému, hostiteľa a prípadne port, bez cesty, dopytu a fragmentu. Po navigácii môže ten istý WindowProxy odkazovať na iný dokument, takže origin nehovorí, čo je načítané teraz. Nepriehľadný pôvod sa serializuje ako reťazec "null", ktorý sa líši od prázdneho reťazca "" aj od hodnoty null v JavaScripte.

event.data obsahuje odoslané údaje. Window.postMessage() používa štruktúrované klonovanie, nie JSON ani priamy odkaz na pôvodný objekt. Odoslanie hodnoty, ktorú nemožno klonovať, napríklad funkcie, vyvolá na strane odosielateľa výnimku DataCloneError.

Pred spracovaním data porovnaj origin s presným očakávaným pôvodom pomocou ===, skontroluj source, ak poznáš očakávané okno, a over štruktúru a hodnoty údajov. Pri odosielaní alebo odpovedi uveď presný targetOrigin, ak ho poznáš. Obmedzuje príjemcu a nenahrádza jeho kontroly prichádzajúcich správ. Neposielaj dôverné údaje s "*".

Prí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ýsledok

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

Sprístupni súbor HTML cez HTTP(S) a otvor ho na karte prehliadača bez sandboxu. Okno odošle správu samo sebe. Tri riadky sa vypíšu asynchrónne do konzoly prehliadača po tom, čo obsluha udalosti prijme správu a odstráni svoj poslucháč.

Súvisiace lekcie

  • JavaScript · Lekcia 5 · Pokročilá · Verzia: 4

Zdroje