Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

MessageChannel — komunikacija prek povezanih vrat

MessageChannel ustvari dve povezani vrati za asinhrono dvosmerno izmenjavo sporočil. Spoznajte prejemanje dogodkov, zagon dostave, kloniranje podatkov in zapiranje vrat.

Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaksa

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() ustvari dva povezana objekta MessagePort, dostopna prek lastnosti samo za branje port1 in port2. Sporočilo, poslano prek enih vrat, prispe do drugih kot dogodek message; podatke preberemo iz event.data. Dostava je asinhrona in ne prekine trenutne naloge.

Dodelitev onmessage samodejno zažene sprejemno vrsto vrat. Pri uporabi addEventListener('message', handler) pokličite start() na sprejemnih vratih. Primer najprej izpiše sent, nato pa received: hello; po prejemu sporočila zapre oboja vrata z close().

postMessage() uporablja strukturirano kloniranje, namesto da bi si običajne objekte delili. Podatki, ki jih ni mogoče klonirati, povzročijo DataCloneError. Izbirni seznam za prenos prenese podprte objekte namesto njihovega kopiranja; tudi sam MessagePort je mogoče prenesti v drugo okno ali worker.

To je spletni API, opredeljen v standardu HTML, ne pa funkcija določene izdaje ECMAScripta. Konstruktor je na voljo v kontekstih Window in Worker, podpirajo pa ga trenutni brskalniški pogoni. Prisotnost Node 24 v repozitoriju ne dokazuje podpore v ciljnem brskalniku.

Primeri

(() => {
  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');
})();

Rezultat

sent
received: hello

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri