CKTIS / JavaScript
Storage.length i Storage.key(): brojanje stavki i čitanje naziva ključeva
`length` daje broj pohranjenih stavki, a `key(index)` vraća naziv ključa prema njegovu položaju. Redoslijed ključeva nije zajamčen.
Verzija: Current web platform; runtime support varies
Sintaksa
// 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 označava dva člana instance Storage. Svojstvo storage.length samo je za čitanje i daje trenutačan broj parova ključ–vrijednost, a ne veličinu u bajtovima ili kvotu. Metoda storage.key(index) vraća naziv ključa kao niz znakova, a ne njegovu vrijednost. Položaji počinju od nule: proslijedi nenegativan cijeli broj u rasponu tipa unsigned long (od 0 do 2 ** 32 - 1). Ako je pretvoreni indeks veći od trenutačnog length ili mu je jednak, metoda vraća null.
Za čitanje vrijednosti proslijedi naziv metodi storage.getItem(name). I ta metoda može vratiti null, ali tada to znači da ključ ne postoji. Rezultat metode key() provjeri izrazom name !== null, jer i prazan niz znakova može biti valjan naziv ključa.
Redoslijed ključeva ovisi o implementaciji i može se promijeniti nakon izmjene sadržaja. Ne pretpostavljaj redoslijed umetanja i ne spremaj indeks kao identifikator ključa. Ako je redoslijed prikaza važan, prikupi nazive i izričito ih sortiraj. Spremanje vrijednosti length ne stvara snimku stanja: promjene tijekom prolaska mogu uzrokovati preskakanje ključeva ili njihov dvostruki obilazak.
Web Storage definiran je HTML standardom i nije dio ECMAScripta 2024. window.localStorage vezan je uz podrijetlo (origin) i može se očuvati nakon ponovnog pokretanja preglednika. window.sessionStorage dodatno je odvojen po karticama ili prozorima najviše razine: podaci se zadržavaju pri ponovnom učitavanju, ali su vezani uz sesiju stranice. Ne pretpostavljaj dostupnost u svakom izvršnom okruženju. Dohvat bilo kojeg objekta pohrane može izazvati SecurityError zbog neprozirnog podrijetla ili pravila preglednika. Pri upisu može nastati QuotaExceededError, primjerice kada je kvota iscrpljena.
Primjeri
(() => {
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" },
);
}
})();Rezultat
0 2 [["lang","en"],["theme","dark"]] null
Pokreni kôd u konzoli preglednika na stranici HTTP(S), u testnoj kartici s praznim i dostupnim `sessionStorage` koji ne mijenja drugi kôd. Sortiranje daje ispis neovisan o redoslijedu ključeva u pregledniku. `key(count)` vraća `null`, a `finally` uklanja samo dvije stavke koje primjer koristi. Za Node.js 24 spremi kôd kao `main.js` i pokreni `node main.js`; primjer po potrebi omogućuje ugrađeni Web Storage u podređenom procesu.
Povezane lekcije
- JavaScript · Lekcija 42 · Napredno · Verzija: 4