JavaScript метод WebSocket.send()
Определение и применение
JavaScript метод send() объекта
WebSocket
позволяет передать данные на сервер через WebSocket соединение.
Поддержка браузерами
Спецификация: websockets.spec.whatwg
Поддерживается во всех основных браузерах с 2015 года.
| Возможность | Компьютеры | Мобильные | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
send | 5 | 12 | 18 Версия 18 выпущена в 2013 г. Версия 11 выпущена в 2012 г. — Удалено в 18 Примечание MDN (англ.) Only parameter of type Версия 8 выпущена в 2011 г. — Удалено в 11 Примечание MDN (англ.) Only parameter of type Версия 7 выпущена в 2011 г. — Удалено в 8 Примечание MDN (англ.) Only parameter of type | 12.1 | 5 | 18 | 18 Версия 18 выпущена в 2013 г. Версия 14 выпущена в 2012 г. — Удалено в 18 Примечание MDN (англ.) Only parameter of type Версия 8 выпущена в 2011 г. — Удалено в 14 Примечание MDN (англ.) Only parameter of type Версия 7 выпущена в 2011 г. — Удалено в 8 Примечание MDN (англ.) Only parameter of type | 12.1 | 4.2 | 1.0 | 4.4 | 4.2 |
поддерживаетсяс ограниченияминет поддержкинет данных≤31 — не позднее версии 31
JavaScript синтаксис
socket.send(data);
Спецификация
Значения параметров
| Параметр | Описание |
|---|---|
data |
Данные, предназначенные для отправки на сервер. Они могут быть одним из следующих типов:
|
Исключения
| Тип исключения | Описание |
|---|---|
InvalidStateError |
Возникает, если соединение находится в состоянии CONNECTING. В состояниях CLOSING и
CLOSED исключения нет: данные отбрасываются, а bufferedAmount увеличивается.
|
Пример использования
Для запуска нужен WebSocket-сервер по адресу ws://localhost:8080. Запустите свой сервер или замените
адрес в коде; обычного HTTP-сервера недостаточно. Это листинг для отдельной страницы, соединение на сайте не
открывается.
// создаем WebSocket подключение
const socket = new WebSocket("ws://localhost:8080");
// устанавливаем обработчик событий, вызываемый при открытии соединения
socket.onopen = function(event) {
socket.send("соединение с сервером установлено");
// отправляем определенные данные в формате JSON
const data = { type: "message", text: "Привет" };
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) {
console.log("Соединение с сервером завершено");
}