Please note, this is a STATIC archive of website developer.mozilla.org from November 2016, cach3.com does not collect or store any user information, there is no "phishing" involved.

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.

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

Характеристика Статус Комментарий
Web Storage (Second edition)
Определение 'setItem()' в этой спецификации.
Рекомендация  

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

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

Метки документа и участники

 Внесли вклад в эту страницу: EvgenyI, Frenk1
 Обновлялась последний раз: EvgenyI,