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