Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / HTML

onmessage — gestire i messaggi della finestra

L’attributo onmessage di body imposta il gestore dell’evento message dell’oggetto Window. Riceve, tra gli altri, i messaggi inviati con postMessage; controlla il mittente e i dati prima di usare i dati ricevuti.

Versione: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintassi

<body onmessage="handleMessage(event)">
window.onmessage = handleMessage;
window.addEventListener("message", handleMessage);

onmessage è un attributo gestore dell’evento message. In HTML può comparire sull’elemento body; non è un attributo globale. Il suo codice gestisce gli eventi dell’oggetto Window, non i messaggi indirizzati all’elemento body stesso. Il valore dell’attributo è codice JavaScript che può accedere al parametro event.

In JavaScript, window.onmessage = handleMessage imposta lo stesso gestore. Un’assegnazione successiva lo sostituisce, mentre assegnare null lo rimuove. window.addEventListener("message", handleMessage) consente di registrare altri listener senza sostituire quel gestore.

Un messaggio inviato con postMessage viene recapitato in modo asincrono come MessageEvent: event.data contiene i dati, event.origin identifica l’origine del mittente ed event.source identifica la sorgente. Controlla l’origine e la sorgente attese, oltre alla struttura dei dati. Quando invii, specifica l’origine di destinazione esatta invece di "*", soprattutto per i dati riservati. L’attributo da solo non invia messaggi.

L’esempio invia un messaggio alla stessa finestra. Eseguilo tramite HTTP locale, non come documento file:. Il risultato atteso è che Waiting diventi Hello. Una CSP che blocca il codice inline può impedire l’esecuzione dello script o dell’attributo; in tal caso, sposta il codice in un file JavaScript consentito e usa addEventListener.

Esempi

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Body onmessage handler</title>
</head>
<body onmessage="if (event.source === window &amp;&amp; event.origin === window.origin &amp;&amp; event.data === 'Hello') document.getElementById('result').textContent = event.data;">
  <p id="result" aria-live="polite">Waiting</p>
  <script>
    // The destination is this same window, and the payload is not sensitive.
    // A wildcard also works when the document has an opaque origin.
    window.postMessage('Hello', '*');
  </script>
</body>
</html>

Risultato

Hello

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti