Window.localStorage

Свойство localStorage позволяет получить доступ к Storage объекту. localStorage аналогично свойству sessionStorage (en-US). Разница только в том, что свойство sessionStorage хранит данные в течение сеанса (до закрытия браузера), в отличие от данных, находящихся в свойстве localStorage, которые не имеют ограничений по времени хранения и могут быть удалены только с помощью JavaScript.

Следует отметить, что данные, сохранённые как в localStorage, так и в sessionStorage, являться специфичными для протокола страницы.

Ключи и значения всегда строки (так же, как и объекты, целочисленные ключи автоматически будут преобразованы в строки).

Синтаксис

js
myStorage = window.localStorage;

Значение

Объект Storage, который используется для доступа к текущему локальному хранилищу.

Исключения

SecurityError

Запрос к хранилищу нарушает разрешение политик, либо источник для хранения не является корректной комбинацией схема/хост/порт (такое может произойти, если источником для хранения является file: или data: схемы, например). Как ещё один пример появления ошибки, пользователь через конфигурацию браузера запретил хранение данных для некоторых источников.

Пример

Следующий код показывает пример доступа к локальному объекту Storage для текущего домена и добавляет данные в него с помощью Storage.setItem().

js
localStorage.setItem("myCat", "Tom");

Считывать данные из localStorage для определённого ключа, можно следующим образом:

js
let cat = localStorage.getItem("myCat");

Удалять данные можно так:

js
localStorage.removeItem("myCat"); // вернёт undefined

Для удаления всех записей, то есть полной очистки localStorage, используйте:

js
localStorage.clear();

Примечание: Пожалуйста, обратитесь к статье Using the Web Storage API для более подробных примеров.

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

Specification
HTML Standard
# dom-localstorage-dev

Совместимость с браузерами

BCD tables only load in the browser

Все браузеры имеют различный уровень объёма для localStorage и sessionStorage. Здесь подробное описание объёма хранилищ для разных браузеров.

Смотрите также