English | 简体中文 | 繁體中文 | Русский язык | Français | Español | Português | Deutsch | 日本語 | 한국어 | Italiano | بالعربية

Метод Storage setItem()

Объект хранилища JavaScript

setItem()Метод устанавливает значение для указанного ключа в данном объекте хранения, если ключ уже существует, то обновляет его значение.

Метод setItem() относится к объекту хранения и может бытьlocalStorageОбъект илиsessionStorrageОбъект.

Грамматика:

localStorage.setItem(key, value)
sessionStorage.setItem(key, value)
localStorage.setItem('color', 'green');
localStorage.setItem('image', 'parrot.png');
localStorage.setItem('url', 'https://ru.oldtoolbag.com');
Тестировать, посмотрите‹/›

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

Числа в таблице указывают на первую версию браузера, которая полностью поддерживает метод setItem():

Метод
setItem()43.511.549

Значение параметра

ПараметрыОписание
keyСтрока, содержащая имя ключа, которое нужно создать/обновить
valueСтрока, содержащая значение ключа, которое нужно предоставить для создания/обновления

Технические детали

Возвратное значение:Строка, представляющая вставляемое значение
Версия DOM:API сетевого хранения

Более примеров

Установите значение指定的 элемента сессии хранения:

sessionStorage.setItem('time', Date.now());
sessionStorage.setItem('age', 22);
Тестировать, посмотрите‹/›

Вы также можете использовать точку для установки значений:

localStorage.color = "green";
localStorage.image = "parrot.png";
localStorage.url = "https://ru.oldtoolbag.com";
Тестировать, посмотрите‹/›

Следующие функции создают три данных в локальном хранилище, а затем используют их для установки пользовательских стилей на странице:

function populateStorage() {
  localStorage.setItem('bgcolor', document.getElementById('bgcolor').value);
  localStorage.setItem('font', document.getElementById('font').value);
  localStorage.setItem('image', document.getElementById('image').value);
}
Тестировать, посмотрите‹/›

См. также

Учебник HTML:API веб-хранилища

Справочник по окну (Window):Свойство window.localStorage

Справочник по окну (Window):Свойство window.sessionStorage

Объект хранилища JavaScript