CKTIS / JavaScript
MessageEvent: source, origin e data
Distingui il riferimento al mittente, la sua origine al momento dell’invio e i dati da convalidare prima di elaborare un messaggio tra finestre.
Versione: ECMAScript 2024 and the current web platform; runtime support varies
Sintassi
event.source
event.origin
event.datasource, origin e data sono proprietà di istanza di MessageEvent in sola lettura. Appartengono a un’API della piattaforma web, non a ECMAScript 2024; la loro disponibilità dipende dall’ambiente di esecuzione.
Con Window.postMessage(), event.source è il WindowProxy del contesto di navigazione del mittente. Quando una finestra invia un messaggio a se stessa, mittente e destinatario hanno lo stesso WindowProxy. A seconda dell’API, source può anche essere un MessagePort (per esempio nell’evento connect di un worker condiviso), un ServiceWorker o null. In un normale evento message ricevuto tramite un MessagePort, source vale null e origin vale "".
Nella comunicazione tra finestre, event.origin contiene l’origine serializzata del mittente al momento dell’invio: schema, host ed eventuale porta, senza percorso, query o frammento. Dopo una navigazione, lo stesso WindowProxy può riferirsi a un altro documento, quindi origin non indica cosa è caricato in quel momento. Un’origine opaca si serializza come stringa "null", distinta dalla stringa vuota "" e dal valore JavaScript null.
event.data contiene i dati inviati. Window.postMessage() usa la clonazione strutturata, non JSON né un riferimento diretto all’oggetto originale. L’invio di un valore non clonabile, come una funzione, genera DataCloneError dal lato del mittente.
Prima di usare data, confronta origin con l’origine esatta attesa usando ===, controlla source se conosci la finestra attesa e convalida struttura e valori dei dati. Quando invii un messaggio o rispondi, specifica un targetOrigin esatto se lo conosci. Limita il destinatario, ma non sostituisce i controlli che questo esegue alla ricezione. Non inviare dati riservati con "*".
Esempi
<!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>Risultato
source === window: true origin === expectedOrigin: true data.count: 7
Servi il file HTML tramite HTTP(S) e aprilo in una scheda del browser senza sandbox. La finestra invia un messaggio a se stessa. Le tre righe compaiono in modo asincrono nella console del browser dopo che il gestore ha accettato il messaggio e rimosso il listener.
Lezioni correlate
- JavaScript · Lezione 5 · Avanzato · Versione: 4