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 июль 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 # dom-localstorage-dev |
Совместимость с браузерами
Loading…
Все браузеры имеют различный уровень объёма для localStorage и sessionStorage. Здесь подробное описание объёма хранилищ для разных браузеров.
Смотрите также
- Использование Web Storage API
- Локальное хранилище с Window.localStorage
Window.sessionStorage