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

Storage

Storage

хранилище пар имя/значение на стороне клиента

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

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

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

Свойства

readonly unsigned long length

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

Методы

void clear()

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

any getltem(string key)

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

string key(unsigned long n)

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

void removeItem(string key)

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

void setItem(string key, any value)

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

Оглавление книги