Книга: JavaScript. Подробное руководство, 6-е издание

MessageEvent

MessageEvent

сообщение из другого контекста выполнения Event

Различные прикладные интерфейсы используют события «message» для организации асинхронных взаимодействий между независимыми контекстами выполнения. Все объекты - Window, Worker, WebSocket, EventSource и MessagePort - определяют свойство onmessage для регистрации обработчика события «message». Сообщение, связанное с событием «message», может быть любым значением, допустимым в языке JavaScript, которое можно скопировать, как описывается во врезке «Структурированные копии» в главе 22. Сообщение заключается в объект MessageEvent и доступно в виде свойства data. Различные прикладные интерфейсы, опирающиеся на событие «message», могут определять дополнительные свойства в объекте MessageEvent. События «message» не всплывают, и для них не предусмотрено действий по умолчанию, которые можно было бы отменить.

Свойства

readonly any data

Это свойство хранит доставленное сообщение. Свойство data может иметь значение любого типа, которое можно скопировать с применением алгоритма структурированного копирования (врезка «Структурированные копии» в главе 22). К ним относятся значения базового JavaScript, включая объекты и массивы, но не функции. Некоторые значения клиентского JavaScript, такие как узлы Document и Element, не могут передаваться, но могут передаваться объекты Blob и ArrayBuffer.

readonly string lastEventld

Для событий «message» в интерфейсе EventSource (раздел 18.3) это поле содержит строку lastEventld, если имеется, отправленную сервером.

readonly string origin

Для событий «message» в интерфейсах EventSource (раздел 18.3) или Window (раздел 22.3) это свойство содержит URL-адрес отправителя сообщения.

readonly MessagePort[] ports

Для событий «message» в интерфейсах Window (раздел 22.3), Worker (раздел 22.4) и MessagePort это свойство содержит массив объектов MessagePort, если он был передан соответствующему вызову postMessage().
readonly Window source

Для событий «message» в интерфейсе Window (раздел 22.3) это свойство ссылается на объект Window, отправивший сообщение.

Оглавление книги