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

Флэнаган Дэвид

Кроме того что объект

Location

представляет текущий URL-адрес, он еще и управляет этим адресом. Если строку, содержащую URL-адрес, присвоить объекту

Location

или его свойству

href

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

search

, броузер перезагрузит текущий URL-адрес с новой строкой запроса. Если установить свойство

hash

,

броузер не загрузит новый документ, но создаст новую запись в истории посещений. А если свойство

hash

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

Свойства

Свойства объекта

Location

ссылаются на различные фрагменты URL-адреса текущего документа. Для каждого из следующих свойств дается пример фрагмента следующего (фиктивного) URL-адреса:

http://www.oreilly.com:1234/catalog/search.html?q=JavaScript&m=10#results

string hash

Содержит якорную часть URL-адреса, включая начальный символ решетки (#), в нашем случае - «#results». Эта часть URL-адреса документа определяет имя якорного элемента внутри документа.

string host

Часть URL-адреса, содержащая имя хоста и порт, например: «http://www.oreilly.соm:1234».

string hostname

Часть URL-адреса, содержащая имя хоста, например: «http://www.oreilly.com».

string href

Полный текст URL-адреса документа, в отличие от других свойств объекта

Location

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

Location

устанавливает это свойство, и при использовании объекта

Location

в строковом контексте возвращается значение этого свойства.

string pathname

Путь в URL-адресе, например: «/catalog/search.html».

string port

Порт в URL-адресе, например: «1234». Обратите внимание, что значением этого свойства является строка, а не число.

string protocol

Протокол в URL-адресе, включая завершающее двоеточие, например: «http:».

string search

Часть URL-адреса, которая содержит строку запроса, включая начальный вопросительный знак, например: «?q=JavaScript&m=10».

Методы

void assign(string url)

Загружает и отображает содержимое адреса url, как если бы значение url было присвоено свойству

href

.

void reload

Повторно загружает текущий документ.

void replace(string url)

Загружает и отображает содержимое адреса url, замещая текущий документ в истории посещений, вследствие чего щелчок на кнопке Back броузера не вернет его к предыдущему документу.

MediaElement

элемент проигрывателя Node, Element

MediaElement

является общим суперклассом для элементов

<audio>

и

<video>.

Эти два элемента определяют практически идентичные прикладные интерфейсы, описываемые здесь, тем не менее просмотрите справочные статьи

Audio

и

Video

, где приводится описание дополнительных особенностей аудио- и видеопроигрывателей. А также обратитесь к разделу 21.2, где дается введение в эти мультимедийные элементы.

Константы

Константы NETWORK определяют возможные значения свойства networkState, а константы HAVE - возможные значения свойства readyState.

unsigned short NETWORK_EMPTY = 0

Элемент еще не приступил к использованию сети. Это состояние предшествует установке атрибута

src

.

unsigned short NETWORK_IDLE = 1

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

preload

установлено в значение «none», и пока не была запрошена загрузка или проигрывание данных.

unsigned short NETWORK.LOADING = 2

В настоящее время элемент загружает данные из сети.

unsigned short NETW0RK_N0_S0URCE = З

Элемент не использует сеть, потому что не способен отыскать источник с данными для проигрывания.

unsigned short HAVE.NOTHING = 0

Мультимедийные данные или метаданные еще не были загружены.

unsigned short HAVE.HETADATA = 1

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

currentTime

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

currentTime

.

unsigned short HAVE_CURRENT_DATA = 2

Данные для текущей позиции проигрывания

currentTime

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

unsigned short HAVE_FUTURE_DATA = З

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

unsigned short HAVE_ENOUGH_DATA = 4

Загружен объем данных, достаточный, чтобы броузер смог проиграть запись до конца без приостановки.

Свойства

boolean autoplay

Если имеет значение true, проигрыватель автоматически начнет проигрывание, когда будет загружен достаточный объем данных. Соответствует HTML-атрибуту

autoplay

.

readonly TimeRanges buffered