Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

MessageEvent : source, origin et data

Distinguez la référence à l’émetteur, son origine au moment de l’envoi et les données à valider avant de traiter un message entre fenêtres.

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

Syntaxe

event.source
 event.origin
 event.data

source, origin et data sont des propriétés d’instance de MessageEvent en lecture seule. Elles relèvent d’une API de la plateforme web, pas d’ECMAScript 2024 ; leur disponibilité dépend de l’environnement d’exécution.

Avec Window.postMessage(), event.source est le WindowProxy du contexte de navigation de l’émetteur. Lorsqu’une fenêtre s’envoie un message à elle-même, l’émetteur et le destinataire ont le même WindowProxy. Selon l’API, source peut aussi être un MessagePort (par exemple lors de l’événement connect d’un worker partagé), un ServiceWorker ou null. Pour un événement message ordinaire reçu via un MessagePort, source vaut null et origin vaut "".

Dans les échanges entre fenêtres, event.origin contient l’origine sérialisée de l’émetteur au moment de l’envoi : schéma, hôte et, le cas échéant, port, sans chemin, paramètres de requête ni fragment. Après une navigation, le même WindowProxy peut désigner un autre document : origin n’indique donc pas ce qui est chargé actuellement. Une origine opaque est sérialisée sous la forme de la chaîne "null", distincte de la chaîne vide "" et de la valeur JavaScript null.

event.data contient les données transmises. Window.postMessage() utilise le clonage structuré, et non JSON ni une référence directe à l’objet d’origine. L’envoi d’une valeur impossible à cloner, comme une fonction, déclenche DataCloneError du côté émetteur.

Avant d’utiliser data, comparez origin à l’origine exacte attendue avec ===, vérifiez source si vous connaissez la fenêtre attendue, puis validez la structure et les valeurs des données. À l’envoi ou lors d’une réponse, indiquez une targetOrigin exacte si elle est connue. Elle restreint le destinataire et ne remplace pas les contrôles qu’il effectue à la réception. N’envoyez pas de données confidentielles avec "*".

Exemples

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

Résultat

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

Servez le fichier HTML via HTTP(S) et ouvrez-le dans un onglet du navigateur sans bac à sable. La fenêtre s’envoie un message à elle-même. Les trois lignes s’affichent de façon asynchrone dans la console du navigateur après l’acceptation du message et le retrait du gestionnaire d’événement.

Leçons associées

  • JavaScript · Leçon 5 · Avancé · Version : 4

Sources