CKTIS / JavaScript
MessageChannel — комуникация чрез свързани портове
MessageChannel създава два свързани порта за асинхронна двупосочна размяна на съобщения. Научете как да получавате събития, да стартирате доставянето, да клонирате данни и да затваряте портовете.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
const channel = new MessageChannel();
channel.port2.onmessage = (event) => {
/* event.data */
channel.port1.close();
channel.port2.close();
};
// With addEventListener('message', handler), call port.start().
channel.port1.postMessage(value);new MessageChannel() създава два свързани обекта MessagePort, достъпни чрез свойствата само за четене port1 и port2. Съобщение, изпратено през единия порт, достига до другия като събитие message; данните му се четат от event.data. Доставянето е асинхронно и не прекъсва текущата задача.
Присвояването на onmessage автоматично стартира опашката за получаване на порта. При addEventListener('message', handler) извикайте start() на приемащия порт. Примерът първо извежда sent, а след това received: hello; след получаването на съобщението затваря двата порта с close().
postMessage() използва структурирано клониране, а не споделяне на обикновени обекти. Данни, които не могат да бъдат клонирани, причиняват DataCloneError. Незадължителен списък за прехвърляне прехвърля поддържаните обекти, вместо да ги копира; самият MessagePort може да бъде прехвърлен към друг прозорец или worker.
Това е Web API, дефиниран от HTML, а не функция на конкретно издание на ECMAScript. Конструкторът е достъпен в контексти Window и Worker и се поддържа от съвременните браузърни енджини. Наличието на Node 24 в хранилище не доказва поддръжка в целевия браузър.
Примери
(() => {
const channel = new MessageChannel();
channel.port2.addEventListener('message', (event) => {
console.log(`received: ${event.data.text}`);
channel.port1.close();
channel.port2.close();
}, { once: true });
channel.port2.start();
channel.port1.postMessage({ text: 'hello' });
console.log('sent');
})();Резултат
sent received: hello
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.