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

CKTIS / JavaScript

MessagePort — končna točka sporočilnega kanala

MessagePort je ena od dveh končnih točk dvosmernega kanala. Omogoča asinhroni prenos podatkov in prenosljivih objektov med povezanimi deli kode.

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 { 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 je vmesnik spletnega API-ja, določen v HTML, ne v ECMAScriptu. Ne ustvarite ga z new MessagePort(): new MessageChannel() zagotovi povezana porta port1 in port2. Sporočilo, poslano prek enega porta, prispe na drugega kot dogodek message; njegovo vsebino preberete prek event.data.

postMessage() dostavo uvrsti v čakalno vrsto, namesto da bi prejemnika poklical sinhrono. Podatki se strukturno klonirajo. Izbirni seznam transfer prenese prenosljive objekte, namesto da bi jih kopiral; prenesti je mogoče tudi sam port. Objekt na strani pošiljatelja nato ni več uporaben.

Pri uporabi addEventListener("message", handler) pokličite start() na sprejemnem portu. Z dodelitvijo onmessage se sprejem začne samodejno. DataCloneError označuje napako pri serializaciji ali seznamu za prenos; messageerror sporoča neuspešno deserializacijo pri prejemniku. Ko je komunikacija končana, porta zaprite z close().

Primer uporablja oba porta na eni strani. To je API brskalnika; prisotnost Node 24 v repozitoriju ne dokazuje podpore v brskalniku.

Primeri

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

Rezultat

sent
received: 42

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

Viri