CKTIS / JavaScript
MessageEvent: свойствата source, origin и data
Разграничавай препратката към подателя, неговия произход при изпращането и данните, които трябва да провериш преди обработка на съобщение между прозорци.
Версия: ECMAScript 2024 and the current web platform; runtime support varies
Синтаксис
event.source
event.origin
event.datasource, origin и data са свойства на екземпляр на MessageEvent, достъпни само за четене. Те са част от API на уеб платформата, а не от ECMAScript 2024; наличността им зависи от средата за изпълнение.
При Window.postMessage() event.source е обектът WindowProxy на контекста за разглеждане на подателя. Когато прозорец изпрати съобщение до себе си, подателят и получателят имат един и същ обект WindowProxy. В зависимост от API source може да бъде също MessagePort (например при събитие connect на споделен worker), ServiceWorker или null. При обикновено събитие message, получено през MessagePort, source е null, а origin е "".
При обмен между прозорци event.origin съдържа сериализирания произход на подателя в момента на изпращане: схема, хост и евентуално порт, без път, заявка или фрагмент. След навигация същият WindowProxy може да сочи към друг документ, така че origin не показва какво е заредено в момента. Непрозрачният произход се сериализира като низа "null", различен от празния низ "" и от стойността null в JavaScript.
event.data съдържа изпратените данни. Window.postMessage() използва структурирано клониране, а не JSON или пряка препратка към първоначалния обект. При изпращане на стойност, която не може да се клонира, например функция, при подателя се поражда изключение DataCloneError.
Преди да обработиш data, сравни origin с точния очакван произход чрез ===, провери source, ако знаеш кой прозорец очакваш, и провери структурата и стойностите на данните. Когато изпращаш или отговаряш, посочи точен targetOrigin, ако го знаеш. Той ограничава получателя, но не замества неговите проверки на входящите съобщения. Не изпращай поверителни данни с "*".
Примери
<!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>Резултат
source === window: true origin === expectedOrigin: true data.count: 7
Предостави HTML файла през HTTP(S) и го отвори в раздел на браузъра без ограничения от sandbox. Прозорецът изпраща съобщение до себе си. Трите реда се появяват асинхронно в конзолата на браузъра, след като обработчикът приеме съобщението и се отпише от събитието.
Свързани уроци
- JavaScript · Урок 5 · Напреднало · Версия: 4