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

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

Свойства

DOMSettableTokenList audio

Это свойство определяет аудиопараметры видеозаписи. Параметры указываются в HTML-атрибуте

audio
в виде списка названий параметров, разделенных пробелами, и в программном коде на языке JavaScript отражаются в множество
DOMSettableTokenList
. Однако на момент написания этих строк стандарт HTML5 определял только один параметр («muted»), поэтому данное свойство можно интерпретировать как строку.

unsigned long height

Высота элемента

<video>
на экране в CSS-пикселах. Соответствует HTML-атрибуту
height
.

string poster

URL-адрес изображения, отображаемого в качестве «афиши» до того, как будет запущено проигрывание видеозаписи. Соответствует HTML-атрибуту

poster
.

readonly unsigned long videoHeight

readonly unsigned long videoWidth

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

<video>
не загрузит метаданные (пока свойство
readyState
имеет значение HAVE_NOTHING, и не было сгенерировано событие «loadedmetadata»).

unsigned long width

Желаемая ширина элемента

<video>
на экране в CSS-пикселах. Соответствует HTML-атрибуту
width
.

WebSocket

двунаправленное сетевое соединение, подобное сокету (EventTarget)

Объект

WebSocket
представляет долгоживущее, двунаправленное сетевое соединение с сервером, поддерживающим протокол веб-сокетов. Данная модель сетевых взаимодействий существенно отличается от модели запрос/ответ, которую реализует протокол HTTP. Создать новое сетевое соединение можно вызовом конструктора
WebSocket.
Отправлять текстовые данные на сервер можно с помощью метода
send,
а принимать сообщения от сервера - с помощью обработчика событий «message». Дополнительные сведения приводятся в разделе 22.9.

Веб-сокеты - это новый прикладной интерфейс для веб-приложений; на момент написания этих строк поддерживался не всеми броузерами.

Конструктор

new WebSocket(string url, [string[] protocols])

Конструктор

WebSocket
создает новый объект
WebSocket
и запускает (асинхронный) процесс установления соединения с сервером, поддерживающим протокол веб-сокетов. Аргумент url определяет сервер, с которым требуется установить соединение, и должен быть абсолютным URL-адресом с URL-схемой ws:// или wss://. Аргумент protocols - это массив названий подпротоколов. С помощью этого аргумента клиент может сообщить серверу, какие версии протоколов он поддерживает. Сервер должен выбрать один из них и информировать клиента о своем выборе в процессе установления соединения. В аргументе protocols можно также передать строку, а не массив: в этом случае значение аргумента будет интерпретироваться как массив с единственным элементом.

Константы

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

readyState
.

unsigned short CONNECTING = 0

Продолжается выполнение процедуры установления соединения.

unsigned short OPEN = 1

Объект

WebSocket
соединен с сервером; можно отправлять и принимать сообщения.

unsigned short CLOSING = 2

Соединение закрывается.

unsigned short CLOSED = З

Соединение закрыто.

Свойства

readonly unsigned long bufferedAmount

Количество символов сообщения, переданного методу

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

readonly string protocol

Если конструктору

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