CKTIS / JavaScript
Storage.length e Storage.key(): contare le voci e leggere i nomi delle chiavi
`length` conta le voci memorizzate, mentre `key(index)` restituisce il nome di una chiave in base alla posizione. L’ordine non è garantito.
Versione: Current web platform; runtime support varies
Sintassi
// 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 indica due membri di un’istanza di Storage. La proprietà di sola lettura storage.length conta le coppie chiave-valore presenti in quel momento; non indica né la dimensione in byte né la quota. Il metodo storage.key(index) restituisce il nome della chiave come stringa, non il suo valore. Le posizioni partono da zero: passa un intero non negativo nell’intervallo di unsigned long (da 0 a 2 ** 32 - 1). Se l’indice convertito è maggiore o uguale al valore corrente di length, il metodo restituisce null.
Per leggere il valore, passa il nome a storage.getItem(name). Anche questo metodo può restituire null, ma in quel caso significa che la chiave non esiste. Controlla il risultato di key() con name !== null, perché anche una stringa vuota può essere un nome di chiave valido.
L’ordine delle chiavi dipende dall’implementazione e può cambiare dopo una modifica. Non dare per scontato l’ordine di inserimento e non salvare un indice come identificatore della chiave. Se l’ordine di visualizzazione è importante, raccogli i nomi e ordinali esplicitamente. Salvare length non crea un’istantanea: le modifiche durante l’iterazione possono far saltare alcune chiavi o farle visitare due volte.
Web Storage è definito dallo standard HTML e non fa parte di ECMAScript 2024. window.localStorage è associato a un’origine e può persistere al riavvio del browser. window.sessionStorage è separato anche per scheda o finestra di primo livello: sopravvive ai ricaricamenti, ma è legato alla sessione della pagina. Non darne per scontata la disponibilità in ogni ambiente di esecuzione. L’accesso a uno dei due oggetti può generare un SecurityError per un’origine opaca o per una regola del browser. Una scrittura può generare un QuotaExceededError, per esempio se la quota è esaurita.
Esempi
(() => {
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" },
);
}
})();Risultato
0 2 [["lang","en"],["theme","dark"]] null
Esegui il codice nella console del browser su una pagina HTTP(S), in una scheda di prova con `sessionStorage` vuoto e accessibile, senza altro codice che lo modifichi. L’ordinamento rende l’output indipendente dall’ordine delle chiavi del browser. `key(count)` restituisce `null` e `finally` rimuove solo le due voci usate dall’esempio. Per Node.js 24, salva il codice come `main.js` ed esegui `node main.js`; se necessario, l’esempio abilita l’API Web Storage integrata in un processo figlio.
Lezioni correlate
- JavaScript · Lezione 42 · Avanzato · Versione: 4