Referencia rápida

Con la ayuda de la API Web Storage, ahora las aplicaciones web pueden ofrecer un espacio de almacenamiento. Usando un par clave/valor, la información es almacenada en el ordenador del usuario para un rápido acceso o para trabajar desconectado de la red.

Tipo de almacenamiento

Dos mecanismos diferentes son ofrecidos para almacenar datos:

  • sessionStorage: este mecanismo mantiene la información almacenada solo disponible para
    una simple ventana y solo hasta que la ventana es cerrada.
  • localStorage: este mecanismo almacena datos de forma permanente. Estos datos son compartidos por todas las ventanas que están ejecutando la misma aplicación y estarán disponibles a menos que el usuario decida que ya no los necesita.

Métodos

La API incluye una interface común para cada mecanismo que cuenta con nuevos métodos,
propiedades y eventos:

  • setItem(clave, valor): este método crea un nuevo ítem que es almacenado en el espacio de almacenamiento reservado para la aplicación. El ítem está compuesto por un par clave/valor creado a partir de los atributos clave y valor.
  • getItem(clave): este método lee el contenido de un ítem identificado por la clave especificada por el atributo clave. El valor de esta clave debe ser el mismo usado cuando el ítem fue creado con el método setItem().
  • key(índice): este método retorna la clave del ítem encontrado en la posición especificada por el atributo índice dentro del espacio de almacenamiento.
  • removeItem(clave): este método elimina un ítem con la clave especificada por el atributo
    clave. El valor de esta clave debe ser el mismo usado cuando el ítem fue creado por el
    método setItem().
  • clear(): este método elimina todos los ítems en el espacio de almacenamiento reservado para la aplicación.

Propiedades

  • length: esta propiedad retorna el número de ítems disponibles en el espacio de almacenamiento reservado para la aplicación.

Eventos

  • storage: este evento es disparado cada vez que un cambio se produce en el espacio de almacenamiento reservado para la aplicación.