Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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 name

Storage.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

Fonti