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

CKTIS / JavaScript

MessagePort — крайна точка на канал за съобщения

MessagePort е една от двете крайни точки на двупосочен канал. Той позволява асинхронно предаване на данни и прехвърляеми обекти между свързани части от код.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

const { port1, port2 } = new MessageChannel();
port1.postMessage(message);
port1.postMessage(message, transfer);
port1.postMessage(message, { transfer });
port2.addEventListener("message", handler);
port2.start();
port1.close();
port2.close();

MessagePort е интерфейс на Web API, дефиниран в HTML, а не в ECMAScript. Не се създава с new MessagePort(): new MessageChannel() предоставя свързаните портове port1 и port2. Съобщение, изпратено през единия порт, достига другия като събитие message; съдържанието му се прочита чрез event.data.

postMessage() поставя доставянето на опашка, вместо да извика получателя синхронно. Данните се подлагат на структурирано клониране. Незадължителен списък transfer прехвърля прехвърляеми обекти, вместо да ги копира; може да се прехвърли и самият порт. След това обектът от страната на подателя става неизползваем.

При addEventListener("message", handler) извикайте start() върху получаващия порт. Задаването на onmessage стартира получаването автоматично. DataCloneError показва грешка при сериализация или в списъка за прехвърляне; messageerror сигнализира за неуспешна десериализация при получателя. Когато комуникацията приключи, затворете портовете с close().

Примерът използва и двата порта в рамките на една страница. Това е API за браузър; наличието на Node 24 в хранилище не доказва поддръжка в браузър.

Примери

(() => {
  const { port1, port2 } = new MessageChannel();

  port2.addEventListener("message", (event) => {
    console.log(`received: ${event.data.value}`);
    port1.close();
    port2.close();
  }, { once: true });
  port2.start();

  port1.postMessage({ value: 42 });
  console.log("sent");
})();

Резултат

sent
received: 42

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

Източници