Storage.getItem()

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

Синтаксис

var aValue = storage.getItem(названиеКлюча);

Параметры

названиеКлюча
Является строкой DOMString, содержащей название ключа, по которому получается значение из хранилища.

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

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

Пример

Следующая функция получает 3 значения из локального хранилища, после этого они используются для установки стилей на странице.

function setStyles() {
  var currentColor = localStorage.getItem('bgcolor');
  var currentFont = localStorage.getItem('font');
  var currentImage = localStorage.getItem('image');

  document.getElementById('bgcolor').value = currentColor;
  document.getElementById('font').value = currentFont;
  document.getElementById('image').value = currentImage;

  htmlElem.style.backgroundColor = '#' + currentColor;
  pElem.style.fontFamily = currentFont;
  imgElem.setAttribute('src', currentImage);
}

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

Спецификации

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

Поддержка браузерами

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!

Характеристика Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
localStorage 4 3.5 8 10.50 4
sessionStorage 5 2 8 10.50 4
Характеристика 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 в папке cache, которая периодически подлежит очистке по требованию ОС, как правило при недостаточном количестве свободного места

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