Window.localStorage

Свойство 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 для более подробных примеров.

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

Спецификация Статус Комментарий
HTML Living Standard
Определение 'localStorage' в этой спецификации.
Живой стандарт

Поддержка браузерами

BCD tables only load in the browser

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

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