MessagePort

Интерфейс MessagePort API канала сообщений представляет собой один из двух портов MessageChannel, позволяющий отправлять сообщения с одного порта и прослушивать их получение на другом.

class MessagePort extends EventTarget {

onmessage: ((this: MessagePort, ev: MessageEvent) => any) | null;


onmessageerror: ((this: MessagePort, ev: MessageEvent) => any) | null;



addEventListener<K extends keyof MessagePortEventMap>(
type: K,

listener: (this: MessagePort, ev: MessagePortEventMap[K]) => any,

options?: boolean | AddEventListenerOptions,
): void;

addEventListener(
type: string,

listener: EventListenerOrEventListenerObject,

options?: boolean | AddEventListenerOptions,
): void;

close(): void;

postMessage(message: any, transfer: Transferable[]): void;

postMessage(message: any, options?: StructuredSerializeOptions): void;

removeEventListener<K extends keyof MessagePortEventMap>(
type: K,

listener: (this: MessagePort, ev: MessagePortEventMap[K]) => any,

options?: boolean | EventListenerOptions,
): void;

removeEventListener(
type: string,

listener: EventListenerOrEventListenerObject,

options?: boolean | EventListenerOptions,
): void;

start(): void;
}

Extends

EventTarget

Свойства

onmessage: ((this: MessagePort, ev: MessageEvent) => any) | null

onmessageerror: ((this: MessagePort, ev: MessageEvent) => any) | null

Методы

addEventListener<K extends keyof MessagePortEventMap>(type: K, listener: (this: MessagePort, ev: MessagePortEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void

addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void

close(): void

Отключает порт, делая его неактивным.

postMessage(message: any, transfer: Transferable[]): void

Отправляет сообщение по каналу. Объекты, перечисленные в transfer, передаются, а не просто клонируются, что означает, что они больше не доступны на стороне отправки.

Выбрасывает исключение "DataCloneError" DOMException, если transfer содержит дубликаты объектов или порты, или если сообщение не может быть клонировано.

postMessage(message: any, options?: StructuredSerializeOptions): void

removeEventListener<K extends keyof MessagePortEventMap>(type: K, listener: (this: MessagePort, ev: MessagePortEventMap[K]) => any, options?: boolean | EventListenerOptions): void

removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void

start(): void

Начинает обработку сообщений, полученных на порту. Это вызывается неявно при присвоении значения this.onmessage.