JavaScript Web Storage API

Описание API

API веб-хранилища предоставляет механизмы, с помощью которых браузеры могут хранить пары "ключ-значение" гораздо более интуитивно понятным способом, чем использование файлов cookie (небольшой фрагмент данных, отправленный веб-сервером и хранимый на компьютере пользователя).

В настоящее время существуют следующие два механизма хранилищ:

  • sessionStorage - поддерживает отдельную область хранения для каждого заданного источника, доступную на время сеанса страницы (пока существует сеанс вкладки, включая перезагрузку и восстановление страницы).
  • localStorage - делает то же самое, но сохраняется даже при закрытии и повторном открытии браузера.

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

Для localStorage и sessionStorage для каждого источника (сочетания схемы, хоста и порта) используется отдельный объект хранения — они функционируют и управляются отдельно друг от друга.

Интерфейсы Web Storage API

Интерфейс / объект — Web Storage API
Интерфейс / объект Описание
Storage Интерфейс Storage предоставляет доступ к локальному объекту хранения, или объекту хранения текущего сеанса для определенного домена (создавшего объект хранения источника). Он позволяет, например, добавлять, изменять или удалять элементы хранимых данных.
Window Интерфейс Window представляет из себя окно, или фрейм в браузере, содержащий документ DOM. API веб-хранилища расширяет объект Window двумя новыми свойствами — Window.sessionStorage и Window.localStorage, которые предоставляют доступ к локальному объекту хранения, или объекту хранения текущего сеанса для определенного домена (создавшего объект хранения источника), а также обработчик события Window.onstorage, который срабатывает, когда веб-хранилище данных обновляется.
StorageEvent Событие storage срабатывает на объекте Window документа при изменении объекта хранилища (Storage).

Приватный просмотр (режим инкогнито)

В приватном режиме веб-хранилище обычно изолировано от обычного профиля и очищается после завершения приватного сеанса. Доступ и квоты зависят от политики браузера.

Не рассчитывайте на обязательную доступность хранилища: доступ к свойству может вызвать SecurityError, а запись — QuotaExceededError. Обрабатывайте ошибки через try/catch.

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

Изменения localStorage порождают storage в других документах того же источника, но не в документе, выполнившем запись. Для sessionStorage получатели дополнительно ограничены той же вкладкой. Хранилища синхронные; ключи и значения — строки.

Спецификация

HTML Standard: Web storage.