WebSocket: метод send()

Базовая Широко доступная

Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с июля 2015 года.

Примечание: Эта функция доступна в Потоках Web Workers.

Метод WebSocket.send() помещает указанные данные в очередь для передачи на сервер по подключению WebSocket, увеличивая значение bufferedAmount на количество байтов, необходимых для хранения данных. Если данные не могут быть отправлены (например, из-за необходимости буферизации, но буфер заполнен), сокет автоматически закрывается. Браузер выбросит исключение, если вы вызовете send() когда подключение находится в состоянии CONNECTING. Если вы вызовете send() когда подключение находится в состоянии CLOSING или CLOSED , браузер тихо проигнорирует данные.

Синтаксис

send(data)

Параметры

data

Данные для отправки на сервер. Это может быть один из следующих типов:

string: Строка текста. Строка добавляется в буфер в формате UTF-8, и значение bufferedAmount увеличивается на количество байтов, необходимых для представления строки UTF-8.
ArrayBuffer: Можно отправлять исходные двоичные данные, используемые объектом с типом массива; его двоичные данные помещаются в очередь в буфер, увеличивая значение bufferedAmount на требуемое количество байтов.
Blob: Указание Blob помещает исходные данные blob в очередь для передачи в двоичной форме (значение Blob.type игнорируется). Значение bufferedAmount увеличивается на размер этих данных в байтах.
TypedArray или DataView: Можно отправлять любой объект массива JavaScript с типом в качестве двоичного кадра; его двоичные данные помещаются в очередь в буфер, увеличивая значение bufferedAmount на требуемое количество байтов.

Возвращаемое значение

Ничего (undefined).

Исключения

InvalidStateError DOMException: Выбрасывается, если WebSocket.readyState имеет значение CONNECTING.

Спецификации

Спецификация
WebSockets # ref-for-dom-websocket-send①

Совместимость браузеров

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox for Android	Opera Android	Safari на IOS	Samsung Internet	WebView Android
`send`	5	12	18 11–18 Поддерживаются только параметры типа `ArrayBuffer` и `String`. 8–11 Поддерживается только параметр типа `String`. 7–8 Поддерживается только параметр типа `String`. Возвращает `boolean`.	12.1	5	18	18 14–18 Поддерживаются только параметры типа `ArrayBuffer` и `String`. 8–14 Поддерживается только параметр типа `String`. 7–8 Поддерживается только параметр типа `String`. Возвращает `boolean`.	12.1	4.2	1.0	4.4

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/WebSocket/send