CKTIS / JavaScript
Storage.length et Storage.key() : compter les entrées et lire les noms des clés
`length` compte les entrées stockées et `key(index)` renvoie un nom de clé selon sa position. L’ordre de ces positions n’est pas garanti.
Version : Current web platform; runtime support varies
Syntaxe
// 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 désigne deux membres d’une instance de Storage. La propriété en lecture seule storage.length compte les paires clé-valeur présentes à cet instant ; elle n’indique ni la taille en octets ni le quota. La méthode storage.key(index) renvoie le nom de la clé sous forme de chaîne, et non sa valeur. Les positions commencent à zéro : passez un entier non négatif dans l’intervalle de unsigned long (de 0 à 2 ** 32 - 1). Si l’indice converti est supérieur ou égal à la valeur actuelle de length, la méthode renvoie null.
Pour lire la valeur, passez le nom à storage.getItem(name). Cette méthode peut aussi renvoyer null, mais cela signifie alors que la clé est absente. Testez le résultat de key() avec name !== null, car la chaîne vide peut être un nom de clé valide.
L’ordre des clés dépend de l’implémentation et peut changer après une modification. Ne supposez pas qu’il s’agit de l’ordre d’insertion et ne conservez pas un indice comme identifiant de clé. Si l’ordre d’affichage compte, recueillez les noms et triez-les explicitement. Mémoriser length ne crée pas d’instantané : si le stockage change pendant le parcours, certaines clés peuvent être sautées ou lues deux fois.
Web Storage est défini par le standard HTML et ne fait pas partie d’ECMAScript 2024. window.localStorage est propre à une origine et peut persister après un redémarrage du navigateur. window.sessionStorage est aussi séparé par onglet ou fenêtre de premier niveau : il survit au rechargement, mais reste lié à la session de la page. Ne présumez pas de sa disponibilité dans tous les environnements d’exécution. L’accès à l’un ou l’autre objet peut lever SecurityError en cas d’origine opaque ou de restriction du navigateur. Une écriture peut lever QuotaExceededError, par exemple si le quota est épuisé.
Exemples
(() => {
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" },
);
}
})();Résultat
0 2 [["lang","en"],["theme","dark"]] null
Exécutez le code dans la console du navigateur sur une page HTTP(S), dans un onglet de test où `sessionStorage` est vide et accessible, sans autre code qui le modifie. Le tri rend la sortie indépendante de l’ordre des clés du navigateur. `key(count)` renvoie `null` et `finally` supprime uniquement les deux entrées utilisées par l’exemple. Pour Node.js 24, enregistrez le code dans `main.js` et exécutez `node main.js` ; si nécessaire, l’exemple active l’API Web Storage intégrée dans un processus enfant.
Leçons associées
- JavaScript · Leçon 42 · Avancé · Version : 4