We're looking for a user researcher to understand the needs of developers and designers. Is this you or someone you know? Check out the post: https://mzl.la/2IGzdXS

Если методу 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!

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,