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