WebSocket
(url[, protokols])Наследник EventTarget
bufferedAmount
Количество символов сообщения, переданного методу send(), которые еще не были отправлены фактически. Это свойство можно использовать при передаче больших объемов данных, чтобы гарантировать, что программа не будет отправлять сообщения быстрее, чем они могут быть переданы по сети.
onclose
Событие «close» генерируется после закрытия соединения (и свойство readyState получит значение CLOSED). Обработчику события передается объект CloseEvent, который определяет, было соединение закрыто без ошибок или нет.
onerror
Событие «error» генерируется, когда возникает сетевая ошибка или ошибка протокола веб-сокетов. Обработчику события передается обычный объект Event.
onmessage
Когда сервер отправляет данные через веб-сокет, объект WebSocket возбуждает событие «message» и передает обработчику объект MessageEvent, свойство data которого ссылается на принятое сообщение.
onopen
Конструктор WebSocket() возвращает управление еще до того, как будет установлено соединение с адресом url. Когда процедура установления соединения завершится и объект WebSocket будет готов к отправке и приему данных, будет возбужденособытие «open». Обработчику события передается обычный объект Event.
protocol
Если конструктору WebSocket() был передан массив подпротоколов, это свойство будет хранить один из них, выбранный сервером. Обратите внимание, что в первый момент после создания объекта WebSocket соединение еще не установлено и выбор сервера неизвестен, поэтому первоначально это свойство содержит пустую строку. Если конструктору был передан список протоколов, значение этого свойства изменится в соответствии с выбором сервера, когда будет сгенерировано событие «open».
readyState
Текущее состояние соединения.
CONNECTING = 0, Продолжается выполнение процедуры установления соединения.
OPEN = 1, Объект WebSocket соединен с сервером; можно отправлять и принимать сообщения.
CLOSING = 2, Соединение закрывается.
CLOSED = 3, Соединение закрыто.
url
Это свойство хранит URL-адрес, который был передан конструктору WebSocket().
close
()Если соединение еще не закрыто или для него еще не была запущена процедура закрытия, этот метод инициирует процесс его закрытия и присваивает свойству readyState значение CLOSING. События «message» могут продолжать возбуждаться даже после вызова метода close(), пока свойство readyState не получит значение CLOSED и не будет возбуждено событие «close».
send
(string data)Отправляет данные data на сервер, подключенный к другому концу соединения. Этот метод возбуждает исключение, когда вызывается до того, как будет сгенерировано событие «open», т. е. пока свойство readyState имеет значение CONNECTING. Протокол веб-сокетов поддерживает обмен двоичными данными, но на момент на писания этих строк текущая версия прикладного интерфейса веб-сокетов поддерживала только текстовые сообщения.