Если в метод 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()' в этой спецификации. |
Неизвестно |
Поддержка браузерами
Характеристика | 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, которая периодически подлежит очистке по требованию ОС, как правило при недостаточном количестве свободного места