Веб-хранилище , иногда называемое хранилищем DOM ( хранилище объектной модели документа ), представляет собой стандартный API JavaScript , предоставляемый веб-браузерами . Он позволяет веб-сайтам хранить постоянные данные на устройствах пользователей аналогично файлам cookie , но с гораздо большей емкостью [1] и без передачи информации в HTTP-заголовках . [2] Существует два основных типа веб-хранилищ: локальное хранилище и хранилище сеансов, которые ведут себя аналогично постоянным файлам cookie и сеансовым файлам cookie соответственно. Веб-хранилище стандартизировано Консорциумом World Wide Web (W3C) [3] и WHATWG , [4] и поддерживается всеми основными браузерами.
Веб-хранилище отличается от файлов cookie в некоторых ключевых аспектах.
Файлы cookie предназначены для связи с серверами; они автоматически добавляются ко всем запросам и доступны как на стороне сервера, так и на стороне клиента. Веб-хранилище подпадает исключительно под действие сценариев на стороне клиента . Данные веб-хранилища не передаются автоматически на сервер при каждом HTTP-запросе, и веб-сервер не может напрямую записывать данные в веб-хранилище. Однако любого из этих эффектов можно достичь с помощью явных сценариев на стороне клиента, позволяющих точно настроить желаемое взаимодействие с сервером.
Размер файлов cookie ограничен 4 килобайтами. Веб-хранилище обеспечивает гораздо большую емкость:
Веб-хранилище предлагает две разные области хранения — локальное хранилище и хранилище сеансов, которые различаются по объему и сроку службы. Данные, размещаемые в локальном хранилище, относятся к каждому источнику — комбинации протокола, имени хоста и номера порта, как определено в политике одного и того же источника . Данные доступны всем скриптам, загруженным со страниц того же источника, на котором ранее хранились данные, и сохраняются после закрытия браузера. Таким образом, веб-хранилище не страдает от проблем слабой целостности и слабой конфиденциальности файлов cookie, описанных в разделах 8.5 и 8.6 RFC 6265. Хранилище сеансов предназначено как для каждого источника, так и для каждого экземпляра (для каждого окна или для каждой вкладки) и ограничено временем существования экземпляра. Хранилище сеансов предназначено для того, чтобы отдельные экземпляры одного и того же веб-приложения могли запускаться в разных окнах, не мешая друг другу, — вариант использования, который плохо поддерживается файлами cookie. [9]
Веб-хранилище обеспечивает лучший программный интерфейс, чем файлы cookie, поскольку оно предоставляет модель данных ассоциативного массива , в которой ключи и значения являются строками .
Браузеры, поддерживающие веб-хранилище, имеют глобальные объекты sessionStorage
и localStorage
объявляются на уровне окна. В этих браузерах можно использовать следующий код JavaScript для запуска поведения веб-хранилища:
// Сохраняем значение в браузере на время сеанса sessionStorage . setItem ( 'ключ' , 'значение' ); // Получить значение (удаляется при закрытии и повторном открытии браузера) ... alert ( sessionStorage . getItem ( 'key' ));// Сохраняем значение в браузере после окончания сеанса localStorage . setItem ( 'ключ' , 'значение' ); // Получение значения (сохраняется даже после закрытия и повторного открытия браузера) alert ( localStorage . getItem ( 'key' ));
Через Storage API можно хранить только строки. [10] Попытка сохранить другой тип данных приведет к автоматическому преобразованию в строку в большинстве браузеров. Однако преобразование в JSON позволяет эффективно хранить объекты JavaScript.
// Сохраняем объект вместо строки localStorage . setItem ( 'ключ' , { имя : 'значение' }); предупреждение ( typeof localStorage . getItem ( 'ключ' )); // нить // Сохраняем целое число вместо строки localStorage . setItem ( 'ключ' , 1 ); предупреждение ( typeof localStorage . getItem ( 'ключ' )); // нить // Сохраняем объект, используя JSON localStorage . setItem ( 'ключ' , JSON . stringify ({ имя : 'значение' })); предупреждение ( JSON . parse ( localStorage . getItem ( 'key' )). name ); // ценить
Проект W3C называется «Веб-хранилище». «Хранилище DOM» также было широко используемым названием, хотя его становится все меньше; например, веб-статьи «DOM Storage» на сайтах разработчиков Mozilla и Microsoft были заменены статьями «Web Storage». [11] [12] [13] [14]
«DOM» в хранилище DOM не относится буквально к объектной модели документа . Согласно W3C, «термин DOM используется для обозначения набора API, доступного для сценариев в веб-приложениях, и не обязательно подразумевает существование реального объекта Document...» [15]
Хранение объектов веб-хранилища включено по умолчанию в текущих версиях всех поддерживающих веб-браузеров, при этом поставщики браузеров предоставляют пользователям способы включения или отключения веб-хранилища или очистки «кеша» веб-хранилища. [16] Аналогичные элементы управления веб-хранилищем также доступны через сторонние расширения браузера . Каждый браузер хранит объекты веб-хранилища по-разному:
webappsstore.sqlite
, который находится в папке профиля пользователя. [17]\AppData\Local\Google\Chrome\User Data\Default\Local Storage
" в Windows и " ~/Library/Application Support/Google/Chrome/Default/Local Storage
" в macOS .\AppData\Roaming\Opera\Opera\sessions\autosave.win
» или « \AppData\Local\Opera\Opera\pstorage\
» в зависимости от версии Opera.\AppData\LocalLow\Microsoft\Internet Explorer\DOMStorage
— " ".LocalStorage
" внутри скрытой safari
папки " ". [18]Хотя localStorage часто используется для хранения постоянных пар ключ-значение, появились и другие API, позволяющие реализовать различные варианты использования, такие как итеративное индексирование [19] , и с различными шаблонами производительности: