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() method
Syntax
js
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.
js
function setStyles() {
const currentColor = localStorage.getItem("bgcolor");
const currentFont = localStorage.getItem("font");
const 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–2023 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