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' в этой спецификации.
Живой стандарт

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

Update compatibility data on GitHub
КомпьютерыМобильные
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome для AndroidFirefox для AndroidOpera для AndroidSafari on iOSSamsung Internet
localStorageChrome Полная поддержка 4Edge Полная поддержка 12Firefox Полная поддержка 3.5IE Полная поддержка 8Opera Полная поддержка 10.5Safari Полная поддержка 4WebView Android Полная поддержка ДаChrome Android Полная поддержка ДаFirefox Android Полная поддержка ДаOpera Android Полная поддержка 11Safari iOS Полная поддержка 3.2Samsung Internet Android Полная поддержка Да

Легенда

Полная поддержка  
Полная поддержка

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

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