Cette page a été traduite à partir de l'anglais par la communauté.Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.
Window: message event
Baseline Widely available
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis août 2017.
L'événementmessage est déclenché sur un objetWindow lorsque la fenêtre reçoit un message, par exemple d'un appel aWindow.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:
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 utilisantaddEventListener() avec un code comme celui-ci:
window.addEventListener("message", (event) => { console.log(`Message reçu: ${event.data}`);});Alternativement l'écouteur peut utiliser la propriété du gestionnaire d'événementsonmessage:
window.onmessage = (event) => { console.log(`Message reçu: ${event.data}`);};Spécifications
| Specification |
|---|
| HTML # event-message |
| HTML # handler-window-onmessage |
Compatibilité des navigateurs
Voir aussi
- Événements liés:
messageerror. Window.postMessage().