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

CKTIS / JavaScript

Storage: contar entradas y leer nombres de claves

Storage expone pares de claves y valores de tipo cadena mediante localStorage y sessionStorage. Aprende la diferencia entre Storage.length, que cuenta las entradas, y Storage.key(index), que devuelve el nombre de una clave, no su valor.

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

storage.length
storage.key(index)
storage.getItem(key)
storage.setItem(key, value)
storage.removeItem(key)
storage.clear()

Storage es una interfaz de la API Web definida por HTML, no por ECMAScript. Puedes obtener sus objetos mediante window.localStorage o window.sessionStorage. El primero está pensado para almacenar datos más allá de la sesión actual; el segundo está vinculado a la sesión y al origen de una pestaña. Las claves y los valores son cadenas.

Storage.length es de solo lectura: indica el número de pares, no su tamaño en bytes. Al llamar a Storage.key(index), Web IDL convierte primero el argumento al tipo unsigned long. El método usa el valor convertido como índice con base cero y devuelve el nombre de una clave, o null si ese índice es mayor o igual que length. Por ejemplo, storage.key(2 ** 32) usa el índice 0 y devuelve el nombre de una clave si el almacenamiento no está vacío. Para leer el valor, usa getItem(key).

El orden de las claves no está especificado y puede cambiar al modificarlas. No des por supuesto el orden de inserción ni elimines entradas mientras recorres los índices. Para mostrarlas de forma reproducible, reúne los nombres y ordénalos.

El acceso puede generar SecurityError, y la escritura puede generar QuotaExceededError. Gestiona estos errores en las aplicaciones. El ejemplo intenta usar primero window.sessionStorage. Si captura SecurityError o QuotaExceededError, recurre a un almacenamiento de prueba en memoria en lugar de Web Storage y muestra el mismo resultado en la consola. Que Node 24 esté presente en un repositorio no demuestra que se admita esta API Web.

Ejemplos

<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Storage: counting entries and reading key names</title>
</head>
<body>
<h1>Counting storage entries and listing their keys</h1>
<p id="source"></p>
<script>
  function inspectStorage(storage) {
    const names = ['cktis:storage:a', 'cktis:storage:b'].map(base => {
      let name = base;
      let suffix = 0;
      while (storage.getItem(name) !== null) name = `${base}:${++suffix}`;
      return name;
    });
    const written = [];
    try {
      const before = storage.length;
      for (const [index, value] of ['10', '20'].entries()) {
        storage.setItem(names[index], value);
        written.push(names[index]);
      }

      const count = storage.length;
      const keys = [];
      for (let index = 0; index < count; index++) {
        const name = storage.key(index);
        if (names.includes(name)) keys.push(name);
      }
      return [count - before, keys.length, storage.key(count) === null];
    } finally {
      for (const name of written) storage.removeItem(name);
    }
  }

  let lines;
  let source = 'Using browser sessionStorage.';
  try {
    lines = inspectStorage(window.sessionStorage);
  } catch (error) {
    if (error.name !== 'SecurityError' && error.name !== 'QuotaExceededError') throw error;
    source = 'The browser storage test write is unavailable. Using an in-memory fixture for this demonstration.';
    const entries = new Map();
    lines = inspectStorage({
      get length() { return entries.size; },
      key(index) { return Array.from(entries.keys())[index] ?? null; },
      getItem(key) { return entries.has(key) ? entries.get(key) : null; },
      setItem(key, value) { entries.set(key, String(value)); },
      removeItem(key) { entries.delete(key); }
    });
  }
  document.getElementById('source').textContent = source;
  for (const line of lines) console.log(line);
</script>
</body>
</html>

Resultado

2
2
true

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