CKTIS / JavaScript
MessageEvent: właściwości source, origin i data
Rozróżniaj źródło wiadomości, pochodzenie nadawcy i przesłaną wartość oraz sprawdzaj je przed obsłużeniem wiadomości między oknami.
Wersja: ECMAScript 2024 and the current web platform; runtime support varies
Składnia
event.source
event.origin
event.datasource, origin i data to właściwości instancji MessageEvent tylko do odczytu. Należą do API platformy webowej, nie do ECMAScript 2024; dostępność zależy od środowiska uruchomieniowego.
Po wywołaniu Window.postMessage() właściwość event.source wskazuje WindowProxy kontekstu przeglądania nadawcy. Gdy okno wysyła wiadomość do siebie, nadawca i odbiorca mają ten sam WindowProxy. W zależności od API source może też być obiektem MessagePort (np. w zdarzeniu connect workera współdzielonego), obiektem ServiceWorker albo mieć wartość null. W zwykłym zdarzeniu message dostarczonym przez MessagePort właściwości source i origin mają odpowiednio wartości null i "".
W komunikacji między oknami event.origin to zserializowane pochodzenie nadawcy w chwili wysłania: schemat, host i ewentualny port, bez ścieżki, zapytania ani fragmentu. Ten sam WindowProxy może po nawigacji wskazywać inny dokument, więc origin nie mówi, co jest załadowane teraz. Nieprzezroczyste pochodzenie jest zapisywane jako ciąg "null", odmienny od pustego ciągu "" i wartości JavaScript null.
event.data zawiera przesłaną wartość. W przypadku Window.postMessage() dane są przekazywane przez klonowanie strukturalne, a nie przez JSON ani przez przekazanie samego odwołania do oryginalnego obiektu. Próba wysłania wartości, której nie można sklonować, np. funkcji, powoduje DataCloneError po stronie nadawcy.
Przed użyciem data porównaj origin z dokładnym oczekiwanym pochodzeniem za pomocą ===, sprawdź source, jeśli znasz oczekiwane okno, i zweryfikuj strukturę oraz wartości danych. Przy wysyłaniu lub odpowiadaniu podaj dokładne targetOrigin, jeśli jest znane. To ograniczenie dotyczy odbiorcy i nie zastępuje jego kontroli wiadomości przychodzących. Nie przesyłaj poufnych danych z "*".
Przykłady
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>MessageEvent: source, origin, and data</title>
</head>
<body>
<script>
(() => {
const expectedOrigin = window.location.origin;
const expectedSource = window;
function receive(event) {
if (event.origin !== expectedOrigin || event.source !== expectedSource) return;
const data = event.data;
if (data === null || typeof data !== "object" ||
data.type !== "cktis:count" || !Number.isInteger(data.count)) return;
window.removeEventListener("message", receive);
console.log(`source === window: ${event.source === window}`);
console.log(`origin === expectedOrigin: ${event.origin === expectedOrigin}`);
console.log(`data.count: ${data.count}`);
}
window.addEventListener("message", receive);
window.postMessage({ type: "cktis:count", count: 7 }, expectedOrigin);
})();
</script>
</body>
</html>Wynik
source === window: true origin === expectedOrigin: true data.count: 7
Udostępnij plik HTML przez HTTP(S) i otwórz go w przeglądarce bez ograniczeń sandboxa. Okno wysyła wiadomość do siebie. Trzy wiersze pojawią się asynchronicznie w konsoli przeglądarki, gdy procedura obsługi zaakceptuje wiadomość i usunie nasłuchiwanie.
Powiązane lekcje
- JavaScript · Lekcja 5 · Zaawansowany · Wersja: 4