JavaScript Web Storage API
Описание API
API веб-хранилища предоставляет механизмы, с помощью которых браузеры могут хранить пары "ключ-значение" гораздо более интуитивно понятным способом, чем использование файлов cookie (небольшой фрагмент данных, отправленный веб-сервером и хранимый на компьютере пользователя).
В настоящее время существуют следующие два механизма хранилищ:
-
sessionStorage- поддерживает отдельную область хранения для каждого заданного источника, доступную на время сеанса страницы (пока существует сеанс вкладки, включая перезагрузку и восстановление страницы). -
localStorage- делает то же самое, но сохраняется даже при закрытии и повторном открытии браузера.
Эти механизмы доступны через свойства объекта Window sessionStorage и
localStorage (точнее говоря, в браузерах объект Window реализует объекты
WindowLocalStorage и WindowSessionStorage, которые содержат свойства
localStorage и sessionStorage). Вызов одного из этих свойств создаст экземпляр объекта
Storage, с помощью которого можно устанавливать, извлекать и удалять элементы данных из хранилища.
Для localStorage и sessionStorage для каждого источника (сочетания схемы, хоста и порта)
используется отдельный объект хранения — они функционируют и управляются отдельно друг от друга.
Интерфейсы 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 получатели дополнительно ограничены той же вкладкой.
Хранилища синхронные; ключи и значения — строки.