RTCDataChannel: метод send()

Метод send() интерфейса RTCDataChannel отправляет данные по каналу связи удалённому участнику. Это можно сделать в любое время, кроме начального процесса создания канала транспорта. Данные, отправленные до подключения, буферизуются, если это возможно (или происходит ошибка, если это невозможно), а также буферизуются, если отправляются во время закрытия или закрытого соединения.

data

Данные для передачи по подключению. Это может быть строка, Blob, ArrayBuffer, TypedArray или DataView объект.

Ничего (undefined).

InvalidStateError DOMException

Выбрасывается, когда канал данных не завершил установку собственного соединения (то есть его readyState является connecting). Канал данных должен установить собственное соединение, потому что он использует канал транспорта, отдельный от канала медиа-контента. Эта ошибка возникает без отправки или буферизации data.

NetworkError DOMException

Выбрасывается, когда указанные data должны быть буферизованы, а в буфере нет места. В этом случае основной транспорт сразу закрывается.

TypeError

Выбрасывается, если указанные data слишком велики для получения другим участником. Поскольку существует несколько методов разбиения больших данных на меньшие части для передачи, возможны ситуации, в которых другой участник не поддерживает те же методы. Например, если один участник — это современный браузер, поддерживающий использование флага EOR (конец записи) для указания того, что полученное сообщение является последней частью объекта, отправленного частями с использованием send(). Дополнительную информацию об ограничениях на размер сообщений см. в Ограничения на размер сообщений.

В этом примере создается функция sendMessage(); она принимает объект в качестве входных данных и отправляет удалённому участнику через RTCDataChannel строку JSON с указанным объектом и отметкой времени.

const pc = new RTCPeerConnection();
const dc = pc.createDataChannel("BackChannel");

function sendMessage(msg) {
  const obj = {
    message: msg,
    timestamp: new Date(),
  };
  dc.send(JSON.stringify(obj));
}

• WebRTC
• RTCDataChannel
• RTCDataChannel.readyState
• close событие