Если методу 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, обычно это происходит, когда мало доступного места.