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 && event.origin === window.origin && 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.