CKTIS / JavaScript
MessageEvent: svojstva source, origin i data
Razlikuj referencu na pošiljatelja, njegovo podrijetlo u trenutku slanja i podatke koje treba provjeriti prije obrade poruke između prozora.
Verzija: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
event.source
event.origin
event.datasource, origin i data svojstva su instance MessageEvent dostupna samo za čitanje. Pripadaju API-ju web-platforme, a ne ECMAScriptu 2024; dostupnost ovisi o izvršnom okruženju.
Kod Window.postMessage(), event.source je WindowProxy konteksta pregledavanja pošiljatelja. Kad prozor pošalje poruku samome sebi, pošiljatelj i primatelj imaju isti WindowProxy. Ovisno o API-ju, source može biti i MessagePort (primjerice u događaju connect dijeljenog workera), ServiceWorker ili null. U uobičajenom događaju message primljenom preko MessagePort vrijednost source je null, a vrijednost origin je "".
U komunikaciji između prozora event.origin sadrži serijalizirano podrijetlo pošiljatelja u trenutku slanja: shemu, naziv hosta i po potrebi port, bez putanje, upita ili fragmenta. Isti WindowProxy može nakon navigacije upućivati na drugi dokument, pa origin ne govori što je trenutačno učitano. Neprozirno podrijetlo serijalizira se kao niz "null", koji se razlikuje od praznog niza "" i JavaScript vrijednosti null.
event.data sadrži poslane podatke. Window.postMessage() koristi strukturirano kloniranje, a ne JSON ni izravnu referencu na izvorni objekt. Slanje vrijednosti koja se ne može klonirati, poput funkcije, izaziva iznimku DataCloneError na strani pošiljatelja.
Prije obrade data usporedi origin s točnim očekivanim podrijetlom pomoću ===, provjeri source ako znaš koji prozor očekuješ te provjeri strukturu i vrijednosti podataka. Pri slanju ili odgovaranju navedi točan targetOrigin ako ga znaš. On ograničava primatelja i ne zamjenjuje njegove provjere dolaznih poruka. Ne šalji povjerljive podatke s "*".
Primjeri
<!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
Učini HTML datoteku dostupnom putem HTTP(S)-a i otvori je na kartici preglednika bez sandbox ograničenja. Prozor šalje poruku samome sebi. Tri retka ispisuju se asinkrono u konzoli preglednika nakon što obrađivač prihvati poruku i ukloni svoj slušač događaja.
Povezane lekcije
- JavaScript · Lekcija 5 · Napredno · Verzija: 4