Storage.getItem()

El método getItem() de la interfaz Storage devuelve el valor de la clave cuyo nombre se le pasa por parámetro.

Sintaxis

var aValue = storage.getItem(keyName);

Parámetros

keyName: Una DOMString que contiene el nombre de la clave cuyo valor se quiere obtener.

Devuelve

Una DOMString que contiene el valor de la clave. Si la clave no existe, devuelve null.

Ejemplo

La siguiente función toma 3 elementos del almacenamiento local (local storage) y los utiliza para establecer estilos personalizados en una página.

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);
}

Nota: Para ver esto utilizado en un ejemplo real, vea nuestra Demo de Web Storage.

Especificaciones

Especificación	Estado	Comentarios
Web Storage (Second edition) The definition of 'getItem()' in that specification.	Recommendation

Característica	Chrome	Firefox (Gecko)	Internet Explorer	Opera	Safari (WebKit)
localStorage	4	3.5	8	10.50	4
sessionStorage	5	2	8	10.50	4

Característica	Android	Firefox Mobile (Gecko)	IE Phone	Opera Mobile	Safari Mobile
Basic support	2.1	?	8	11	iOS 3.2

Todos los navegadores tienen diferentes niveles de capacidad tanto para localStorage como para sessionStorage. Aquí hay un resumen detallado de la capacidad de almacenamiento para diversos navegadores.

Nota: desde iOS 5.1, Safari Mobile almacena los datos de localStorage en la carpeta de cache, que está sujeta a borrados ocasionales a petición del sistema operativo, típicamente cuando queda poco espacio.

Vea también

Utilizando la API de Web Storage