Window: message event

L'événement message est déclenché sur un objet Window lorsque la fenêtre reçoit un message, par exemple d'un appel a Window.postMessage() depuis un autre contexte de navigation.

Bulles Non
Annulable Non
Interface MessageEvent
Propriété de gestionnaire d'événements onmessage

Exemples

Supposons qu'un script envoie un message à un contexte de navigation différent, tel qu'un autre <iframe>, en utilisant un code comme celui-ci:

js
const targetFrame = window.top.frames[1];
const targetOrigin = "https://exemple.org";
const windowMessageButton = document.querySelector("#window-message");

windowMessageButton.addEventListener("click", () => {
  targetFrame.postMessage("bonjour", targetOrigin);
});

Le récepteur peut écouter le message en utilisant addEventListener() avec un code comme celui-ci:

js
window.addEventListener("message", (event) => {
  console.log(`Message reçu: ${event.data}`);
});

Alternativement l'écouteur peut utiliser la propriété du gestionnaire d'événements onmessage:

js
window.onmessage = (event) => {
  console.log(`Message reçu: ${event.data}`);
};

Spécifications

Specification
HTML Standard
# event-message
HTML Standard
# handler-window-onmessage

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi