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, являться специфичными для протокола страницы.

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

Синтаксис

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
# dom-localstorage-dev

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

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
localStorage

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
See implementation notes.

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

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