Окно: свойство localStorage

Чтение-только свойство localStorage интерфейса window позволяет получить доступ к объекту Storage для Document в текущем источнике; сохранённые данные сохраняются между сессиями браузера.

localStorage аналогичен sessionStorage, за исключением того, что данные localStorage не имеют срока истечения, а данные sessionStorage удаляются при завершении сессии страницы — то есть, когда страница закрывается. (Данные localStorage для документа, загруженного в сессии «приватного просмотра» или «инкогнито», удаляются при закрытии последней «приватной» вкладки.)

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

SecurityError

Выбрасывается в следующих случаях:

• Источник не является корректной кортежем схема/хост/порт. Это может произойти, если источник использует схемы file: или data:, например.
• Запрос нарушает политику. Например, пользователь настроил браузер на запрет сохранения данных страницы.

Обратите внимание, что если пользователь блокирует куки, браузеры, вероятно, интерпретируют это как указание на запрет сохранения данных страницы.

Ключи и значения, хранящиеся в localStorage, всегда представлены в формате UTF-16, в котором на каждый символ используется два байта. Как и для объектов, целочисленные ключи автоматически преобразуются в строки.

Данные localStorage специфичны для протокола документа. В частности, для сайта, загруженного по протоколу HTTP (например, http://example.com), localStorage возвращает другой объект, чем localStorage для соответствующего сайта, загруженного по протоколу HTTPS (например, https://example.com).

Для документов, загруженных из file: URL (то есть, файлов, открытых в браузере непосредственно из локальной файловой системы пользователя, а не с веб-сервера), требования к поведению localStorage не определены и могут различаться в разных браузерах.

Во всех современных браузерах localStorage, кажется, возвращает разные объекты для каждого file: URL. Другими словами, каждый file: URL, похоже, имеет собственную уникальную область локального хранилища. Однако в этом нет гарантий, поэтому не стоит на это полагаться, так как, как упоминалось выше, требования к file: URL остаются не определёнными. Поэтому браузеры могут в любой момент изменить обработку file: URL для localStorage. На самом деле некоторые браузеры изменяли свою обработку с течением времени.

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

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

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

const cat = localStorage.getItem("myCat");

Синтаксис для удаления элемента localStorage выглядит следующим образом:

localStorage.removeItem("myCat");

Синтаксис для удаления всех элементов localStorage выглядит следующим образом:

localStorage.clear();

• Использование API хранилища веб-данных
• Window.sessionStorage