Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

MessageEvent: lastnosti source, origin in data

Loči sklic na pošiljatelja, njegov izvor ob pošiljanju in podatke, ki jih je treba preveriti pred obdelavo sporočila med okni.

Različica: ECMAScript 2024 and the current web platform; runtime support varies

Sintaksa

event.source
 event.origin
 event.data

source, origin in data so lastnosti primerka MessageEvent, ki jih lahko le bereš. Pripadajo API-ju spletne platforme, ne ECMAScriptu 2024; njihova razpoložljivost je odvisna od izvajalnega okolja.

Pri Window.postMessage() je event.source objekt WindowProxy pošiljateljevega brskalnega konteksta. Ko okno pošlje sporočilo samo sebi, imata pošiljatelj in prejemnik isti objekt WindowProxy. Odvisno od API-ja je source lahko tudi MessagePort (na primer pri dogodku connect deljenega delavca), ServiceWorker ali null. Pri običajnem dogodku message, dostavljenem prek MessagePort, je source enak null, origin pa "".

Pri sporočanju med okni event.origin vsebuje serializirani izvor pošiljatelja ob pošiljanju: shemo, gostitelja in po potrebi vrata, brez poti, poizvedbe ali fragmenta. Isti WindowProxy se lahko po navigaciji sklicuje na drug dokument, zato origin ne pove, kaj je trenutno naloženo. Nepregleden izvor se serializira v niz "null", ki ni niti prazen niz "" niti vrednost null v JavaScriptu.

event.data vsebuje poslane podatke. Window.postMessage() uporablja strukturirano kloniranje, ne JSON-a ali neposrednega sklica na izvirni objekt. Če pošlješ vrednost, ki je ni mogoče klonirati, na primer funkcijo, se na strani pošiljatelja sproži izjema DataCloneError.

Pred obdelavo data primerjaj origin z natančno pričakovanim izvorom z operatorjem ===, preveri source, če veš, katero okno pričakuješ, in preveri strukturo ter vrednosti podatkov. Pri pošiljanju ali odgovarjanju navedi natančen targetOrigin, če ga poznaš. Ta omeji prejemnika in ne nadomesti njegovega preverjanja prejetih sporočil. Zaupnih podatkov ne pošiljaj z "*".

Primeri

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

Rezultat

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

Datoteko HTML objavi prek HTTP(S) in jo odpri v zavihku brskalnika brez izolacije sandbox. Okno pošlje sporočilo samo sebi. Tri vrstice se izpišejo asinhrono v konzoli brskalnika, ko obdelovalnik sprejme sporočilo in odstrani svoj poslušalnik.

Povezane lekcije

  • JavaScript · Lekcija 5 · Napredna · Različica: 4

Viri