Window.localStorage
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
Свойство localStorage
позволяет получить доступ к Storage
объекту. localStorage
аналогично свойству sessionStorage
. Разница только в том, что свойство sessionStorage
хранит данные в течение сеанса (до закрытия браузера), в отличие от данных, находящихся в свойстве localStorage
, которые не имеют ограничений по времени хранения и могут быть удалены только с помощью JavaScript.
Следует отметить, что данные, сохранённые как в localStorage
, так и в sessionStorage
, являться специфичными для протокола страницы.
Ключи и значения всегда строки (так же, как и объекты, целочисленные ключи автоматически будут преобразованы в строки).
Синтаксис
myStorage = window.localStorage;
Значение
Объект Storage
, который используется для доступа к текущему локальному хранилищу.
Исключения
SecurityError
-
Запрос к хранилищу нарушает разрешение политик, либо источник для хранения не является корректной комбинацией схема/хост/порт (такое может произойти, если источником для хранения является
file:
илиdata:
схемы, например). Как ещё один пример появления ошибки, пользователь через конфигурацию браузера запретил хранение данных для некоторых источников.
Пример
Следующий код показывает пример доступа к локальному объекту Storage
для текущего домена и добавляет данные в него с помощью Storage.setItem()
.
localStorage.setItem("myCat", "Tom");
Считывать данные из localStorage для определённого ключа, можно следующим образом:
let cat = localStorage.getItem("myCat");
Удалять данные можно так:
localStorage.removeItem("myCat"); // вернёт undefined
Для удаления всех записей, то есть полной очистки localStorage
, используйте:
localStorage.clear();
Примечание: Пожалуйста, обратитесь к статье Using the Web Storage API для более подробных примеров.
Спецификации
Specification |
---|
HTML Standard # dom-localstorage-dev |
Совместимость с браузерами
BCD tables only load in the browser
Все браузеры имеют различный уровень объёма для localStorage
и sessionStorage
. Здесь подробное описание объёма хранилищ для разных браузеров.
Смотрите также
- Использование Web Storage API
- Локальное хранилище с Window.localStorage
Window.sessionStorage