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

CKTIS / JavaScript

MessageChannel — comunicación mediante puertos emparejados

MessageChannel crea dos puertos conectados para intercambiar mensajes de forma asíncrona y bidireccional. Aprende a recibir eventos, iniciar la entrega, clonar datos y cerrar los puertos.

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 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() crea dos objetos MessagePort conectados, accesibles mediante las propiedades de solo lectura port1 y port2. Un mensaje enviado por un puerto llega al otro como un evento message; sus datos se leen en event.data. La entrega es asíncrona y no interrumpe la tarea actual.

Asignar onmessage inicia automáticamente la cola de recepción del puerto. Con addEventListener('message', handler), llama a start() en el puerto receptor. El ejemplo muestra primero sent y después received: hello; al recibir el mensaje, cierra ambos puertos con close().

postMessage() utiliza clonación estructurada en lugar de compartir objetos ordinarios. Los datos que no se pueden clonar provocan DataCloneError. Una lista de transferencia opcional transfiere los objetos compatibles en vez de copiarlos; también se puede transferir un MessagePort a otra ventana o a un worker.

Esta es una API web definida por HTML, no una característica de una edición concreta de ECMAScript. El constructor está disponible en contextos Window y Worker y es compatible con los motores de navegador actuales. La presencia de Node 24 en un repositorio no demuestra que sea compatible con el navegador de destino.

Ejemplos

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

Resultado

sent
received: hello

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