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

CKTIS / JavaScript

Almacenamiento del navegador

El almacenamiento del navegador reúne mecanismos del entorno del navegador para conservar datos en el cliente. Aprende la diferencia entre localStorage y sessionStorage y dónde está el límite entre el lenguaje ECMAScript y las API web.

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

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

El almacenamiento del navegador (browser storage) es una función del entorno, no sintaxis de ECMAScript. La especificación ECMAScript describe el lenguaje y su interacción con el entorno anfitrión; no define localStorage ni sessionStorage. Que Node 24 esté presente en un repositorio no demuestra que estas interfaces estén disponibles en el navegador de destino.

localStorage conserva pares clave-valor entre sesiones, mientras que sessionStorage está vinculado a la sesión de una página en una pestaña concreta. Ambas interfaces son síncronas y almacenan cadenas de texto. getItem(key) devuelve null cuando la clave no existe. Los objetos se pueden guardar con JSON.stringify y leer con JSON.parse.

El acceso depende del origen de la página y de las políticas del navegador. Los datos pueden eliminarse, y el acceso o la escritura pueden provocar una excepción. No consideres este almacenamiento la única copia de los datos ni un lugar para guardar secretos. La sección Web Storage del estándar HTML de WHATWG define localStorage y sessionStorage y sus métodos. No es una referencia sobre compatibilidad con los navegadores ni garantiza que estas interfaces estén disponibles en el navegador de destino.

Ejemplos

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Browser storage example</title>
</head>
<body>
  <p>localStorage can persist across visits. sessionStorage is scoped to the page session in a tab. Both are browser APIs, not part of ECMAScript.</p>
  <ul aria-label="Storage check results">
    <li id="localStorage"></li>
    <li id="sessionStorage"></li>
  </ul>
  <script>
    const fixture = JSON.stringify({ theme: 'dark' });

    function checkStorage(name) {
      const result = document.getElementById(name);
      try {
        const store = window[name];
        // A fresh temporary key avoids reusing application keys. This sequence is not atomic:
        // another same-origin tab can change localStorage between calls.
        const key = `cktis:storage:example:${crypto.getRandomValues(new Uint32Array(4)).join('-')}`;
        if (store.getItem(key) !== null) {
          throw new Error('Temporary storage key already exists');
        }
        store.setItem(key, fixture);
        let saved;
        try {
          saved = store.getItem(key);
        } finally {
          store.removeItem(key);
        }
        if (saved !== fixture || store.getItem(key) !== null) {
          throw new Error('Round trip or cleanup failed');
        }
        result.textContent = `${name}: read back theme=${JSON.parse(saved).theme}; temporary key removed.`;
      } catch (error) {
        if (!(error instanceof DOMException) || !['SecurityError', 'QuotaExceededError'].includes(error.name)) {
          throw error;
        }
        result.textContent = `${name}: temporary write unavailable (${error.name}).`;
      }
      console.log(result.textContent);
    }

    checkStorage('localStorage');
    checkStorage('sessionStorage');
  </script>
</body>
</html>

Resultado

A successful check reports that it read back theme=dark and removed the temporary key. If the check catches a DOMException named SecurityError or QuotaExceededError, it reports that the temporary write is unavailable and includes the error name. Other errors, including a temporary-key collision or a detected round-trip or cleanup failure, are rethrown without a report for that storage area. If the localStorage check rethrows, the sessionStorage check does not run.

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