JavaScript метод WebSocket.send()

JavaScript WebSocket

Определение и применение

JavaScript метод send() объекта WebSocket позволяет передать данные на сервер через WebSocket соединение.


Обращаю Ваше внимание на то, что если данные не могут быть отправлены (например, потому что они должны быть буферизованы, но буфер заполнен), то в этом случае сокет закрывается автоматически.


Поддержка браузерами

МетодChrome
Chrome
Firefox
Firefox
Opera
Opera
Safari
Safari
Internet Explorer
IExplorer
Microsoft Edge
Edge
send()ДаДаДаДа10.0Да

JavaScript синтаксис:

WebSocket.send(data);

data - Any

Cпецификация

WebSocket

Значения параметров

ПараметрОписание
dataДанные, предназначенные для отправки на сервер. Они могут быть одним из следующих типов:
  • USVString - Текстовая строка. Строка добавляется в буфер в формате UTF-8, а значение свойства bufferedAmount (число байтов данных в очереди) увеличивается на количество байтов, необходимых для представления строки UTF-8.
  • ArrayBuffer - Базовые двоичные данные, используемые типизированным объектом Array, его содержимое двоичных данных помещается в очередь в буфер, увеличивая значение свойства bufferedAmount на необходимое количество байтов.
  • Blob - объект Blob (представляет собой файлоподобный объект неизменяемых необработанных данных). Значение свойства bufferedAmount увеличивается на размер байта этих необработанных данных.
  • ArrayBufferView - любой типизированный объект массива JavaScript в виде двоичного фрейма, его содержимое двоичных данных помещается в очередь в буфер, увеличивая значение свойства bufferedAmount на необходимое количество байтов.

Исключения

Тип исключенияОписание
INVALID_STATE_ERRВозникает в том случае, если соединение в настоящее время не открыто.
SYNTAX_ERRВозникает в том случае, если данные представляют из себя строку, которая содержит непарные суррогаты.

Пример использования

// создаем WebSocket подключение
const socket = new WebSocket("ws://localhost:8080");

// устанавливаем обработчик событий, вызываемый при открытии соединения
socket.onopen = function(event) {
    socket.send("соединение с сервером установлено");
    // отправляем определенные данные в формате JSON
    socket.send(JSON.stringify(data));
};
// устанавливаем обработчик событий, вызываемый при получении сообщения от сервера
socket.onmessage = function(event) {
    console.log("сообщение от сервера получено", event.data);
}
// устанавливаем обработчик событий, вызываемый при ошибке
socket.onerror = function(event) {
  console.error("Ошибка WebSocket");
  socket.close(); // закрываем подключение к серверу
}
// устанавливаем обработчик событий, вызываемый при закрытии соединения
socket.onclose = function(event) {
  socket.send("соединение с сервером завершено");
}
JavaScript WebSocket
×

Кажется, вы используете блокировщик рекламы :(

Этот ресурс не является коммерческим проектом и развивается на энтузиазме автора сайта, который посвящает все свое свободное время этому проекту.

Добавьте, пожалуйста, basicweb.ru в исключения блокировщика рекламы, этим вы поможете развитию проекта.