Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

localStorage — almacenamiento local de datos

localStorage ofrece al navegador un almacén de pares clave-valor de cadenas asociado a un origen. Los datos pueden durar más que una sesión, pero el acceso y la persistencia dependen de las políticas del navegador.

Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxis

window.localStorage
localStorage.setItem(key, value)
localStorage.getItem(key)
localStorage.removeItem(key)

window.localStorage devuelve un objeto Storage para el origen de la página. Es una API web definida por el HTML Living Standard, no una característica de ECMAScript. Los motores de navegador actuales la admiten; Node 24 en el repositorio no demuestra que los navegadores la admitan.

setItem(key, value) almacena texto, getItem(key) devuelve texto o null, y removeItem(key) elimina una entrada. clear() elimina todas las entradas de ese espacio de almacenamiento, no solo las de la aplicación.

A diferencia de sessionStorage, los datos pueden durar más que una sesión y compartirse entre ventanas del mismo origen. No es una copia de seguridad: el usuario o el navegador pueden eliminarlos. No des por hecho que hay bloqueo en las operaciones de lectura, modificación y escritura. Los cambios activan un evento storage en otras ventanas que usan ese espacio de almacenamiento, pero no en la ventana que escribe.

El acceso puede generar SecurityError, y la escritura puede generar QuotaExceededError; gestiona ambos errores. Los scripts del mismo origen pueden leer los datos, así que no guardes secretos aquí. Si las operaciones se completan correctamente, el ejemplo escribe un valor con una clave generada al azar, lee ese valor y elimina la entrada sin restaurar ningún valor anterior. En la ejecución mostrada, el acceso a window.localStorage genera un SecurityError antes de que el código llegue a la escritura.

Ejemplos

(() => {
  const key = `cktis-storage-${crypto.getRandomValues(new Uint32Array(4)).join('-')}`;
  try {
    const storage = window.localStorage;
    storage.setItem(key, 42);
    let stored;
    try {
      stored = storage.getItem(key);
    } finally {
      storage.removeItem(key);
    }
    console.log(`Stored as a string: ${stored === '42'}`);
    console.log(`Missing after removal: ${storage.getItem(key) === null}`);
  } catch (error) {
    console.log(`Storage unavailable: ${error.name}`);
  }
})();

Resultado

Storage unavailable: SecurityError

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes