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

При изменении содержимого объекта

<b>Storage</b>
любые другие объекты
<b>Window</b>
, имеющие доступ к той же области хранилища (т. е. отображающие документы с тем же происхождением), будут извещены об изменениях с помощью объекта события
<b>StorageEvent</b>
.

Свойства

<b>readonly unsigned long length</b>

Количество хранящихся пар ключ/значение.

Методы

<b>void clear()</b>

Удаляет все хранящиеся пары ключ/значение.

<b>any getltem(string key)</b>

Возвращает значение, связанное с ключом key. (В текущих, на момент написания этих строк, реализациях всегда возвращалась строка.) Этот метод вызывается неявно при индексировании объекта

<b>Storage</b>
, с целью получить значение свойства с именем в аргументе key.

<b>string key(unsigned long n)</b>

Возвращает ключ с индексом л, хранящийся в данном объекте

<b>Storage</b>
, или null, если n больше или равно
<b>length</b>
. Обратите внимание, что порядок следования ключей может изменяться при добавлении и удалении пар ключ/значение.

<b>void removeItem(string key)</b>

Удаляет из объекта

<b>Storage</b>
ключ key и связанное с ним значение. Этот метод вызывается неявно при использовании оператора
<b>delete</b>
, с целью удалить свойство с именем в аргументе key.

<b>void setItem(string key, any value)</b>

Добавляет ключ key и значение value в данный объект

<b>Storage</b>
, замещая значение, прежде связанное с этим ключом key. Этот метод вызывается неявно при присваивании значения свойству объекта
<b>Storage</b>
с именем в аргументе key. То есть вместо явного вызова метода
<b>setItem()</b>
можно использовать обычную операцию присваивания значения свойству.

StorageEvent

Event

Свойства

<b>localStorage и sessionStorage</b>
объекта
<b>Window</b>
ссылаются на объекты
<b>Storage</b>
, представляющие хранилища на стороне клиента (раздел 20.1). Если имеется несколько окон, вкладок или фреймов, отображающих документы с общим происхождением, все они будут иметь доступ к одному и тому же хранилищу. Если сценарий в одном окне изменит содержимое хранилища, во всех других объектах
<b>Window</b>
, имеющих доступ к этому хранилищу, будет сгенерировано событие «storage». (Обратите внимание, что это событие не генерируется в окне, в котором были выполнены изменения.) События «storage» генерируются в объекте
<b>Window</b>
и не всплывают. Для них не предусматривается действий по умолчанию, которые можно было бы отменить. Обработчикам события «storage» передается объект события
<b>StorageEvent</b>
, свойства которого описывают изменения, внесенные в хранилище.

Свойства

<b>readonly string key</b>

Это свойство хранит ключ, который был установлен или удален. Если все хранилище было очищено вызовом метода

<b>Storage.clear()</b>
, это свойство (а также свойства
<b>newValue</b>
и
<b>oldValue</b>
) будет иметь значение null.

<b>readonly any newValue</b>

Новое значение ключа key. Будет иметь значение null при удалении ключа. На момент написания этих строк броузеры позволяли сохранять только строковые значения.

<b>readonly any oldValue</b>

Старое значение изменившегося ключа key. Будет иметь значение null при добавлении нового ключа. На момент написания этих строк броузеры позволяли сохранять только строковые значения.

<b>readonly Storage storageArea</b>

Это свойство будет содержать то же значение, что и свойство

<b>localStorage</b>
или
<b>sessionStorage</b>
объекта
<b>Window</b>
, принявшего это событие, и указывает, содержимое какого хранилища изменилось.

<b>readonly string url</b>

URL-адрес документа, сценарий которого внес изменения в хранилище.

Style

HTML-элемент <style> (Node, Element)

Объект

<b>Style</b>
представляет HTML-тег
<b>&lt;style&gt;.</b>

Свойства

<b>boolean disabled</b>

Установка этого свойства в значение true отключит таблицу стилей, связанную с данным элементом <style>, а установка в значение false снова включит ее.

<b>string media</b>

Это свойство соответствует HTML-атрибуту

<b>media</b>
и определяет устройства, при отображении в которых должна применяться указанная таблица стилей.

<b>boolean scoped</b>

Имеет значение true, если в элементе

<b>&lt;style&gt;</b>
присутствует HTML-атрибут
<b>scoped</b>
, и false - в противном случае. На момент написания этих строк броузеры не поддерживали контекстные (scoped) таблицы стилей.

<b>readonly CSSStyleSheet sheet</b>

Объект

<b>CSSStyleSheet</b>
, определяемый данным элементом
<b>&lt;style&gt;</b>
.

<b>string title</b>

Все HTML-элементы имеют атрибут

<b>title</b>
. С помощью этого атрибута или свойства элемента
<b>&lt;style&gt;</b>
можно дать пользователю возможность выбрать альтернативную таблицу стилей по названию, и указанное значение свойства
<b>title</b>
может отображаться в интерфейсе броузера в некотором оформлении.

<b>string type</b>

Соответствует HTML-атрибуту

<b>type</b>
. По умолчанию имеет значение «text/css*, и обычно нет необходимости указывать другое значение этого атрибута.