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
- Événements liés:
messageerror
. Window.postMessage()
.