CKTIS / JavaScript
window.postMessage — комуникация между прозорци
window.postMessage изпраща данни асинхронно до целеви прозорец, включително между различни origin-и. Препоръчително е да зададете точен `targetOrigin`. Ако го пропуснете, съобщението може да се достави само до прозорец със същия origin. Получателят трябва да проверява origin-а на изпращача, прозореца изпращач и структурата на данните.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
targetWindow.postMessage(message, targetOrigin[, transfer])
targetWindow.postMessage(message[, { targetOrigin, transfer }])window.postMessage е браузърен API, определен от HTML Living Standard, а не функция от конкретно издание на ECMAScript. Съвременните браузърни енджини го поддържат; наличието на Node 24 в хранилище не доказва, че API е достъпен там. Извикайте метода върху прозореца получател, например iframe.contentWindow или препратка към отворен прозорец. Изпращането на съобщения не дава достъп до DOM на друг origin.
Получателят получава асинхронно събитие message: event.data съдържа данните, event.origin съдържа сериализирания origin на изпращача в момента на изпращането, а event.source препраща към прозореца изпращач. Origin от тип кортеж се определя от схемата, хоста и порта, но не и от пътя. Непрозрачният origin няма такъв кортеж и се сериализира като низа "null". Проверката само на този низ не позволява да се различи един непрозрачен origin от друг. Регистрирайте слушателя преди изпращане; при нов frame координирайте готовността на получателя.
Задайте точен targetOrigin. Ако той не съвпада с origin-а на получателя, съобщението се отхвърля. При формата с обект с опции пропуснатият targetOrigin има стойност по подразбиране "/", което ограничава доставянето до същия origin. "*" допуска всеки origin — не го използвайте за поверителни данни. Получателите трябва да проверяват event.origin, event.source и структурата на данните; никога не третирайте съобщенията като код.
Данните се сериализират чрез алгоритъма за структурно клониране, а не като JSON. Функции не могат да бъдат клонирани. Списъкът transfer премества ресурси вместо да ги копира: прехвърлен ArrayBuffer се отделя от страната на изпращача. Данни, които не могат да бъдат клонирани, или дублирани елементи в списъка за прехвърляне могат да причинят DataCloneError. В примера рамка iframe, изолирана в sandbox, изпраща съобщение до родителския си прозорец чрез window.parent.postMessage. Родителският прозорец проверява дали event.origin има стойност "null" и дали event.source сочи към прозореца на рамката. След това проверява данните и извежда received: 42 в конзолата.
Примери
<!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>Резултат
received: 42
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.