CKTIS / JavaScript
Storage.length in Storage.key(): štetje vnosov in branje imen ključev
`length` pove število shranjenih vnosov, `key(index)` pa vrne ime ključa na danem mestu. Vrstni red ključev ni zagotovljen.
Različica: 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čuje dva člana primerka Storage. Lastnost storage.length je samo za branje in pove trenutno število parov ključ–vrednost, ne pa velikosti v bajtih ali kvote. Metoda storage.key(index) vrne ime ključa kot niz, ne njegove vrednosti. Mesta se štejejo od nič: podaj nenegativno celo število v območju unsigned long (od 0 do 2 ** 32 - 1). Če je pretvorjeni indeks večji od trenutne vrednosti length ali ji je enak, metoda vrne null.
Če želiš prebrati vrednost, podaj ime metodi storage.getItem(name). Tudi ta metoda lahko vrne null, vendar to pomeni, da ključa s tem imenom ni. Rezultat metode key() preveri z name !== null, saj je tudi prazen niz lahko veljavno ime ključa.
Vrstni red ključev je odvisen od izvedbe in se po spremembi vsebine lahko spremeni. Ne predpostavljaj vrstnega reda vstavljanja in ne shranjuj indeksa kot identifikatorja ključa. Če je vrstni red prikaza pomemben, zberi imena in jih izrecno razvrsti. S shranjevanjem vrednosti length ne ustvariš posnetka stanja: ob spremembi med pregledovanjem lahko kak ključ preskočiš ali ga obiščeš dvakrat.
Web Storage določa standard HTML in ni del ECMAScript 2024. window.localStorage je vezan na izvor (origin) in lahko preživi ponovni zagon brskalnika. window.sessionStorage je ločen tudi po zavihkih ali oknih najvišje ravni: preživi ponovno nalaganje, vendar je vezan na sejo strani. Ne predpostavljaj, da je na voljo v vsakem izvajalnem okolju. Pridobivanje katerega koli od obeh objektov lahko sproži SecurityError zaradi neprosojnega izvora ali pravil brskalnika. Pisanje lahko sproži QuotaExceededError, na primer ob izčrpani kvoti.
Primeri
(() => {
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
Zaženi kodo v konzoli brskalnika na strani HTTP(S) v preskusnem zavihku, kjer je `sessionStorage` prazen in dostopen ter ga druga koda ne spreminja. Razvrščanje zagotovi, da izpis ni odvisen od vrstnega reda ključev v brskalniku. `key(count)` vrne `null`, `finally` pa odstrani samo vnosa, ki ju uporabi primer. Za Node.js 24 shrani kodo kot `main.js` in zaženi `node main.js`; primer po potrebi omogoči vgrajeni Web Storage v podrejenem procesu.
Povezane lekcije
- JavaScript · Lekcija 42 · Napredna · Različica: 4