База знанияИзпитен център
BGБългарски
Избери език13

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници