Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

onmessage — obsługa wiadomości okna

Atrybut onmessage elementu body ustawia procedurę obsługi zdarzenia message obiektu Window. Odbiera ona m.in. wiadomości wysłane przez postMessage; przed użyciem danych należy sprawdzić nadawcę i zawartość.

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

Składnia

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

onmessage jest atrybutem obsługi zdarzenia message. W HTML można go umieścić na elemencie body; nie jest atrybutem globalnym. Jego kod obsługuje zdarzenia obiektu Window, a nie wiadomości kierowane do samego elementu body. Wartością atrybutu jest kod JavaScript, który ma dostęp do parametru event.

W JavaScript window.onmessage = handleMessage ustawia tę samą procedurę obsługi. Kolejne przypisanie ją zastępuje, a przypisanie null ją usuwa. window.addEventListener("message", handleMessage) pozwala rejestrować dodatkowych słuchaczy bez zastępowania tej procedury.

Wiadomość wysłana przez postMessage jest dostarczana asynchronicznie jako MessageEvent: event.data zawiera dane, event.origin pochodzenie nadawcy, a event.source wskazuje źródło. Sprawdzaj oczekiwane pochodzenie, źródło i strukturę danych. Przy wysyłaniu podawaj dokładne docelowe pochodzenie zamiast "*", szczególnie dla danych poufnych. Sam atrybut nie wysyła wiadomości.

Przykład wysyła wiadomość do tego samego okna. Uruchom go przez lokalny HTTP, nie jako plik file:. Oczekiwanym wynikiem jest zmiana Waiting na Hello. Polityka CSP blokująca kod inline może uniemożliwić wykonanie skryptu lub atrybutu; w takim środowisku przenieś kod do dozwolonego pliku JavaScript i użyj addEventListener.

Przykłady

<!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>

Wynik

Hello

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła