--- title: 'Window: message event' slug: Web/API/Window/message_event tags: - Evènement - Window translation_of: Web/API/Window/message_event ---
{{APIRef}}

L'événement message est déclenché sur un objet {{domxref('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 {{domxref("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
{{SpecName('HTML WHATWG', 'indices.html#event-message')}} {{Spec2('HTML WHATWG')}}

Compatibilité des navigateurs

{{Compat("api.Window.message_event")}}

Voir également