The getItem() method of the Storage interface, when passed a key name, will return that key's value, or null if the key does not exist, in the given Storage object.
Storage.getItem()
Syntax
getItem(keyName)
Parameters
-
keyName -
A string containing the name of the key you want to retrieve the value of.
Return value
A string containing the value of the key. If the key does not exist, null is returned.
Examples
The following function retrieves three data items from local storage, then uses them to set custom styles on a page.
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); }
Note: To see this used within a real world example, see our Web Storage Demo.
Specifications
| Specification |
|---|
| HTML Standard # dom-storage-getitem-dev |
Browser compatibility
| Desktop | Mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
getItem |
4
|
12
|
3.5
|
8
|
10.5
|
4
|
≤37
|
18
|
6
|
11
|
3.2
|
1.0
|
See also
© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/Storage/getItem
