JavaScript. Подробное руководство, 6-е издание
вернуться

Флэнаган Дэвид
Шрифт:

Предлагаемые к реализации методы

Подобно предлагаемым к реализации свойствам, перечисленным выше, проектом стандарта предлагаются к реализации следующие методы, которые пока не реализованы ни в одном из броузеров.

boolean getModifierState(string modifier)

Для событий мыши и клавиатуры этот метод возвращает true, если в момент возбуждения события удерживалась нажатой указанная клавиша-модификатор modifier, и false - в противном случае. Значением аргумента modifier может быть одна из строк: «Alt», «AltGraph», «CapsLock», «Control», «Fn», «Meta», «NumLock», «Scroll», «Shift», «SymbolLock» и «Win».

EventSource

Comet-соединение c HTTP-сервером (EventTarget)

Объект

EventSource
представляет долгоживущее HTTP-соединение, посредством которого веб-сервер может отправлять клиенту текстовые сообщения. Чтобы использовать события, определяемые стандартом «Server-Sent Events», следует передать URL-адрес сервера конструктору
EventSourсе
и затем зарегистрировать обработчик события «message» в полученном объекте EventSource.

Спецификация «Server-Sent Events» появилась совсем недавно и на момент написания этих строк поддерживалась не во всех броузерах.

Конструктор

new EventSource(string url)

Создает новый объект

EventSource
, подключенный к веб-серверу, определяемому аргументом url. Адрес url интерпретируется относительно URL-адреса документа.

Константы

Следующие константы определяют допустимые значения свойства

readyState
.

unsigned short CONNECTING = 0

Идет установка соединения, или соединение было закрыто и объект

EventSource
пытается восстановить его.

unsigned short OPEN = 1

Соединение установлено и готово к приему событий.

unsigned short CLOSED = 2

Соединение было закрыто либо вызовом метода

close,
либо в результате фатальной ошибки, не позволяющей восстановить его.

Свойства

readonly unsigned short readyState

Состояние соединения. Возможные значения определяются константами, перечисленными выше.

readonly string url

Абсолютный URL-адрес, к которому подключен объект

EventSource
.

Методы

void close

Закрывает соединение. После вызова этого метода объект

EventSource
не может больше использоваться. Если потребуется вновь установить соединение, следует создать новый объект
EventSource
.

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

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

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

onerгог
Вызывается при обнаружении ошибки. Обработчику передается простой объект
Event
.

onmessage
Вызывается при получении сообщения от сервера. Обработчику передается объект события
MessageEvent
, а текст, отправленный сервером, доступен через свойство
data
этого объекта.

оnореп
Вызывается при открытии соединения. Обработчику передается простой объект
Event
.

EventTarget

объект, способный принимать события

Объекты, для которых генерируются события, и объекты, которые находятся на пути всплывающих событий, должны предоставлять возможность определять обработчики этих событий. Такие объекты обычно определяют свойства обработчиков событий, имена которых начинаются с префикса «оn» и, как правило, определяют методы, описываемые ниже. Регистрация обработчиков событий - поразительно сложная тема. За подробностями обращайтесь к разделу 17.2 и обратите внимание, что ІE версии 8 и ниже использует другие методы, чем все остальные броузеры; эти методы будут описаны в специальном разделе ниже.