Текущее состояние соединения. Значением этого свойства может быть одна из констант, перечисленных выше.

Это свойство хранит URL-адрес, который был передан конструктору

Методы

Если соединение еще не закрыто или для него еще не была запущена процедура закрытия, этот метод инициирует процесс его закрытия и присваивает свойству

значение CLOSING. События «message» могут продолжать возбуждаться даже после вызова метода пока свойство не получит значение CLOSED и не будет возбуждено событие «close».

Отправляет данные

на сервер, подключенный к другому концу соединения. Этот метод возбуждает исключение, когда вызывается до того, как будет сгенерировано событие «open», т.е. пока свойство имеет значение CONNECTING. Протокол веб-сокетов поддерживает обмен двоичными данными, но на момент написания этих строк текущая версия прикладного интерфейса веб-сокетов поддерживала только текстовые сообщения.

Обработчики событий

Сетевые взаимодействия по своей природе являются асинхронными, и, подобно объекту

, объект также опирается на использование событий. Он определяет четыре свойства регистрации обработчиков событий, а также реализует интерфейс , благодаря чему обработчики событий можно также регистрировать с помощью методов интерфейса . Все события, описываемые ниже, возбуждаются в объекте . Ни одно из них не всплывает, и ни для одного из них не предусмотрено действий по умолчанию, которые можно было бы отменить. Отметьте, однако, что им передаются различные объекты событий.

Событие «close» генерируется после закрытия соединения (и свойство

получит значение CLOSED). Обработчику события передается объект , который определяет, было соединение закрыто без ошибок или нет.

Событие «error» генерируется, когда возникает сетевая ошибка или ошибка протокола веб-сокетов. Обработчику события передается обычный объект

Когда сервер отправляет данные через веб-сокет, объект

возбуждает событие «message» и передает обработчику объект , свойство которого ссылается на принятое сообщение.

Конструктор

возвращает управление еще до того, как будет установлено соединение с адресом url. Когда процедура установления соединения завершится и объект будет готов к отправке и приему данных, будет возбуждено событие «open». Обработчику события передается обычный объект .

окно, вкладка или фрейм веб-броузера (EventTarget)

Объект

представляет окно, вкладку или фрейм в броузере. Он подробно описан в главе 14. В клиентском JavaScript-коде объект выступает в качестве «глобального» объекта, и все выражения вычисляются в контексте текущего объекта . Это значит, что для обращения к текущему окну не требуется использовать специальный синтаксис и свойства этого объекта можно использовать, как если бы они были глобальными переменными. Например, вместо можно писать . Аналогично можно вызывать методы текущего объекта окна, как если бы они были функциями, например вместо

Некоторые свойства и методы этого объекта фактически позволяют определять и изменять некоторые параметры окна броузера. Другие включены в этот объект просто потому, что он является глобальным объектом. Помимо перечисленных здесь свойств и методов объект

реализует все глобальные функции, определяемые базовым языком JavaScript. Подробности см. в справочной статье Global в третьей части книги. Веб-броузеры возбуждают в окнах множество различных событий. Это означает, что объект определяет массу обработчиков событий и что объекты реализуют методы интерфейса .

В объекте

имеются свойства и , которые ссылаются на само окно. Они позволяют явно задать ссылку на окно.

Объект

может содержать другие объекты , обычно в виде тегов . Каждый объект является объектом, подобным массиву, содержащим вложенные объекты . Однако вместо непосредственного индексирования объекта на практике обычно используется свойство frames, ссылающееся на сам объект, как если бы это был объект, подобный массиву. Свойства и объекта ссылаются непосредственно на родительское окно и на окно верхнего уровня.