CKTIS / JavaScript
Storage : compter les entrées et lire les noms des clés
Storage expose des paires clé-valeur sous forme de chaînes via localStorage et sessionStorage. Découvrez la différence entre Storage.length, qui compte les entrées, et Storage.key(index), qui renvoie un nom de clé plutôt que sa valeur.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
storage.length
storage.key(index)
storage.getItem(key)
storage.setItem(key, value)
storage.removeItem(key)
storage.clear()Storage est une interface de l’API Web définie par HTML, et non par ECMAScript. Ses objets sont accessibles via window.localStorage ou window.sessionStorage. Le premier est destiné au stockage au-delà de la session en cours ; le second est lié à la session et à l’origine d’un onglet. Les clés et les valeurs sont des chaînes.
Storage.length est en lecture seule : cette propriété indique le nombre de paires, pas leur taille en octets. Lors d’un appel à Storage.key(index), Web IDL convertit d’abord l’argument en unsigned long. La méthode utilise la valeur convertie comme index à partir de zéro et renvoie un nom de clé, ou null si cet index est supérieur ou égal à length. Par exemple, storage.key(2 ** 32) utilise l’index 0 et renvoie un nom de clé si le stockage n’est pas vide. Pour lire la valeur, utilisez getItem(key).
L’ordre des clés n’est pas spécifié et peut changer lors de modifications. Ne supposez pas que les clés suivent l’ordre d’insertion et ne supprimez pas d’entrées pendant une itération par index. Pour un affichage reproductible, rassemblez les noms et triez-les.
L’accès peut déclencher SecurityError, et l’écriture peut déclencher QuotaExceededError. Gérez ces erreurs dans les applications. L’exemple essaie d’abord d’utiliser window.sessionStorage. S’il intercepte SecurityError ou QuotaExceededError, il utilise un stockage de test en mémoire plutôt que Web Storage et affiche le même résultat dans la console. La présence de Node 24 dans un dépôt ne prouve pas la prise en charge de cette API Web.
Exemples
<!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>Résultat
2 2 true
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.