CKTIS / JavaScript
Storage.length y Storage.key(): contar entradas y leer nombres de claves
`length` cuenta las entradas almacenadas y `key(index)` devuelve un nombre de clave por posición. El navegador no garantiza el orden.
Versión: Current web platform; runtime support varies
Sintaxis
// Web Storage is defined by the HTML Living Standard, not ECMAScript 2024.
storage.length // number (read-only)
storage.key(index) // string | null; zero-based index
storage.getItem(name) // string | null; lookup by key nameStorage.length/key se refiere a dos miembros de una instancia de Storage. La propiedad de solo lectura storage.length cuenta los pares clave–valor almacenados en ese momento; no indica el tamaño en bytes ni la cuota. El método storage.key(index) devuelve el nombre de la clave como cadena, no su valor. Las posiciones empiezan en cero: pasa un entero no negativo dentro del rango de unsigned long (de 0 a 2 ** 32 - 1). Si el índice convertido es mayor o igual que el length actual, el método devuelve null.
Para leer el valor, pasa el nombre a storage.getItem(name). Este método también puede devolver null, pero en ese caso significa que la clave no existe. Comprueba el resultado de key() con name !== null, porque la cadena vacía puede ser un nombre de clave válido.
El orden de las claves depende de la implementación y puede cambiar tras una modificación. No des por hecho que sea el orden de inserción ni guardes un índice como identificador de clave. Si importa el orden de presentación, recoge los nombres y ordénalos explícitamente. Guardar length no crea una instantánea: si el almacenamiento cambia durante el recorrido, es posible omitir claves o recorrerlas dos veces.
Web Storage se define en el estándar HTML y no forma parte de ECMAScript 2024. window.localStorage está asociado a un origen y puede persistir tras reiniciar el navegador. window.sessionStorage se separa además por pestaña o ventana de nivel superior: sobrevive a las recargas, pero está ligado a la sesión de la página. No presupongas su disponibilidad en todos los entornos de ejecución. Obtener cualquiera de los dos objetos puede lanzar SecurityError por un origen opaco o por una política del navegador. Una escritura puede lanzar QuotaExceededError, por ejemplo si se agota la cuota.
Ejemplos
(() => {
function demonstrate(storage) {
if (storage.length !== 0) {
throw new Error("Use an empty sessionStorage area.");
}
try {
console.log(storage.length);
storage.setItem("theme", "dark");
storage.setItem("lang", "en");
const count = storage.length;
const names = [];
for (let index = 0; index < count; index++) {
const name = storage.key(index);
if (name !== null) names.push(name);
}
console.log(count);
console.log(JSON.stringify(names.sort().map(name => [name, storage.getItem(name)])));
console.log(storage.key(count));
} finally {
storage.removeItem("theme");
storage.removeItem("lang");
}
}
const storage = globalThis.sessionStorage;
if (storage !== undefined) {
demonstrate(storage);
} else {
// If Node.js 24 has not exposed Web Storage, enable it in a fresh process.
const { execFileSync } = require("node:child_process");
execFileSync(
process.execPath,
["--experimental-webstorage", "-e", `(${demonstrate.toString()})(globalThis.sessionStorage);`],
{ stdio: "inherit" },
);
}
})();Resultado
0 2 [["lang","en"],["theme","dark"]] null
Ejecuta el código en la consola del navegador en una página HTTP(S), en una pestaña de prueba con `sessionStorage` vacío y accesible, sin otro código que lo modifique. Ordenar los nombres hace que la salida no dependa del orden del navegador. `key(count)` devuelve `null` y `finally` elimina solo las dos entradas que usa el ejemplo. Para Node.js 24, guarda el código como `main.js` y ejecuta `node main.js`; si hace falta, el ejemplo activa la API Web Storage integrada en un proceso hijo.
Lecciones relacionadas
- JavaScript · Lección 42 · Avanzado · Versión: 4