Свойства

и объекта являются объектами , которые представляют хранимые на стороне клиента ассоциативные массивы, отображающие строковые ключи в значения. Теоретически объект может хранить любые значения, которые можно копировать с применением алгоритма структурированного копирования (врезка «Структурированные копии» в главе 22). Однако на момент написания данных строк броузеры позволяли сохранять только строковые значения.

Методы объекта

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

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

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

Свойства

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

Методы

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

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

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

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

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

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

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

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

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

Event

Свойства

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

Свойства

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

, это свойство (а также свойства и ) будет иметь значение null.

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

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

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

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