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:

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

Spécifications

Spécification Statut
HTML Living Standard Standard évolutif

Compatibilité des navigateurs

Update compatibility data on GitHub
OrdinateurMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariWebview AndroidChrome pour AndroidFirefox pour AndroidOpera pour AndroidSafari sur iOSSamsung Internet
message eventChrome Support complet 60Edge Support complet ≤79Firefox ? IE ? Opera Support complet 47Safari ? WebView Android Support complet 60Chrome Android Support complet 60Firefox Android ? Opera Android Support complet 47Safari iOS ? Samsung Internet Android Support complet 8.0

Légende

Support complet  
Support complet
Compatibilité inconnue  
Compatibilité inconnue

Voir également