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

BCD tables only load in the browser

Voir également