CKTIS / JavaScript
window.postMessage — komunikacja między oknami
window.postMessage wysyła dane asynchronicznie do wskazanego okna, również między różnymi originami. Zaleca się podawanie dokładnego `targetOrigin`; jego pominięcie ogranicza dostarczenie do tego samego originu. Odbiorca powinien sprawdzać origin i okno nadawcy oraz strukturę danych.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
targetWindow.postMessage(message, targetOrigin[, transfer])
targetWindow.postMessage(message[, { targetOrigin, transfer }])window.postMessage to API przeglądarki z HTML Living Standard, a nie funkcja z konkretnej edycji ECMAScript. Jest obsługiwane przez współczesne silniki przeglądarek; obecność Node 24 w repozytorium nie dowodzi jego dostępności. Wywołaj metodę na oknie odbiorcy, np. iframe.contentWindow lub referencji do otwartego okna. Przekazywanie wiadomości nie daje dostępu do DOM innego originu.
Odbiorca otrzymuje asynchroniczne zdarzenie message: event.data zawiera dane, event.origin — zserializowany origin nadawcy z chwili wysłania, a event.source — referencję do okna nadawcy. W przypadku originu w postaci krotki o jego tożsamości decydują schemat, host i port, a nie ścieżka. Nieprzezroczysty origin nie ma takiej krotki i jest serializowany jako ciąg znaków "null". Samo sprawdzenie tej wartości nie pozwala odróżnić jednego nieprzezroczystego originu od innego. Zarejestruj nasłuchiwanie przed wysłaniem; dla nowej ramki uzgodnij gotowość odbiorcy.
Podawaj dokładny targetOrigin. Niezgodność originu odbiorcy powoduje odrzucenie wiadomości. W wariancie z obiektem opcji pominięty targetOrigin ma wartość "/", czyli ogranicza odbiór do tego samego originu. "*" dopuszcza dowolny origin — nie używaj go do poufnych danych. Odbiorca powinien sprawdzać event.origin, event.source i strukturę danych; nie traktuj wiadomości jako kodu.
Dane są serializowane algorytmem klonowania strukturalnego, nie JSON. Funkcji nie można klonować. Lista transfer przenosi zasoby zamiast je kopiować: przeniesiony ArrayBuffer zostaje odłączony po stronie nadawcy. Nieklonowalne dane lub duplikaty na liście mogą spowodować DataCloneError. W przykładzie ramka iframe działająca w piaskownicy wysyła wiadomość do okna nadrzędnego za pomocą window.parent.postMessage. Okno nadrzędne sprawdza, czy event.origin ma wartość "null" i czy event.source wskazuje okno tej ramki. Następnie sprawdza dane i wypisuje w konsoli received: 42.
Przykłady
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Send a message from an iframe</title>
</head>
<body>
<script>
const frame = document.createElement('iframe');
frame.title = 'Message sender';
frame.hidden = true;
frame.setAttribute('sandbox', 'allow-scripts');
// Use the page's exact origin when it has an HTTP(S) origin.
// The wildcard fallback carries only the fixed, non-sensitive fixture.
const targetOrigin = /^https?:\/\//.test(window.origin) ? window.origin : '*';
function receive(event) {
// The sandboxed sender has an opaque origin, serialized as "null".
if (event.origin !== 'null' || event.source !== frame.contentWindow) return;
const data = event.data;
if (data === null || typeof data !== 'object' || Array.isArray(data)) return;
if (data.type !== 'cktis-demo' || data.value !== 42) return;
window.removeEventListener('message', receive);
console.log(`received: ${data.value}`);
}
window.addEventListener('message', receive);
frame.srcdoc = `<!doctype html>
<html lang="en">
<head><meta charset="utf-8"><title>Message sender</title></head>
<body>
<script>
window.parent.postMessage({ type: 'cktis-demo', value: 42 }, ${JSON.stringify(targetOrigin)});
<\/script>
</body>
</html>`;
document.body.append(frame);
</script>
</body>
</html>Wynik
received: 42
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.