Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

MessagePort — un extremo de un canal de mensajes

MessagePort es uno de los dos extremos de un canal bidireccional. Permite la transmisión asíncrona de datos y objetos transferibles entre partes de código conectadas.

Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxis

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 es una interfaz de la API Web definida por HTML, no por ECMAScript. No se crea con new MessagePort(): new MessageChannel() proporciona los puertos conectados port1 y port2. Un mensaje enviado por un puerto llega al otro como un evento message; su contenido se lee mediante event.data.

postMessage() pone la entrega en cola en lugar de llamar al receptor de forma síncrona. Los datos se someten a clonación estructurada. Una lista transfer opcional transfiere objetos transferibles en vez de copiarlos; también se puede transferir el propio puerto. El objeto del lado emisor deja entonces de poder utilizarse.

Con addEventListener("message", handler), llama a start() en el puerto receptor. Asignar onmessage inicia la recepción automáticamente. DataCloneError indica un error de serialización o de la lista de transferencia; messageerror señala que ha fallado la deserialización en el receptor. Cuando termine la comunicación, cierra los puertos con close().

El ejemplo utiliza ambos puertos dentro de una misma página. Esta es una API de navegador; que Node 24 esté presente en un repositorio no demuestra la compatibilidad con navegadores.

Ejemplos

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

Resultado

sent
received: 42

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes