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:
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:
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
(en-US):
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()
.