Storage.setItem()

Если методу setItem() интерфейса Storage передать ключ и значение, то в хранилище будет добавлено соответствующее ключу значение, либо, если запись уже есть в хранилище, то значение по ключу будет обновлено.

Синтаксис

storage.setItem(название Ключа, значение Ключа);

Параметры

название Ключа: Является строкой DOMString содержащей название ключа, значение которого будет добавлено/обновлено.
значение Ключа: Является строкой DOMString содержащей значение ключа, которое будет добавлено/обновлено.

Возвращаемые значения

Метод не возвращает значений.

Пример

Следующая функция создаёт три элемента с данными в хранилище.

function populateStorage() {
  localStorage.setItem('bgcolor', 'red');
  localStorage.setItem('font', 'Helvetica');
  localStorage.setItem('image', 'myCat.png');
}

Примечание: Чтобы вживую посмотреть на работу функции, посетите страницу демонстрации Web Storage.

Характеристики

Характеристика	Статус	Комментарий
Unknown Определение 'setItem()' в этой спецификации.	Неизвестно

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

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help! (en-US)

Настольные
Мобильные

Feature	Chrome	Firefox (Gecko)	Internet Explorer	Opera	Safari (WebKit)
localStorage	4	3.5	8	10.50	4
sessionStorage	5	2	8	10.50	4

Feature	Android	Firefox Mobile (Gecko)	IE Phone	Opera Mobile	Safari Mobile
Basic support	2.1	?	8	11	iOS 3.2

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

Примечание: начиная с версии iOS 5.1, Safari Mobile хранит данные localStorage в папке с кешем, которая может быть очищена случайно по требованию OS, обычно это происходит, когда мало доступного места.

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

Использование Web Storage API