This page was translated from English by the community. Learn more and join the MDN Web Docs community.

View in English Always switch to English

Storage.getItem()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨июль 2015 г.⁩.

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

Синтаксис

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

Параметры

название Ключа

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

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

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

Пример

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

js
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.

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

Specification
HTML
# dom-storage-getitem-dev

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

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

Using the Web Storage API