CKTIS / JavaScript
Storage.length a Storage.key(): počet položiek a čítanie názvov kľúčov
`length` udáva počet uložených položiek a `key(index)` vracia názov kľúča podľa jeho pozície. Poradie kľúčov nie je zaručené.
Verzia: Current web platform; runtime support varies
Syntax
// 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 prvky inštancie Storage. Vlastnosť storage.length je len na čítanie a udáva aktuálny počet dvojíc kľúč–hodnota, nie veľkosť v bajtoch ani kvótu. Metóda storage.key(index) vracia názov kľúča ako reťazec, nie jeho hodnotu. Pozície sa začínajú od nuly: zadajte nezáporné celé číslo v rozsahu unsigned long (od 0 do 2 ** 32 - 1). Ak je skonvertovaný index väčší alebo rovný aktuálnej hodnote length, metóda vráti null.
Ak chcete prečítať hodnotu, odovzdajte názov metóde storage.getItem(name). Aj tá môže vrátiť null, ale v tomto prípade to znamená, že daný kľúč neexistuje. Výsledok key() overte pomocou name !== null, pretože aj prázdny reťazec môže byť platným názvom kľúča.
Poradie kľúčov závisí od implementácie a po zmene obsahu sa môže zmeniť. Nespoliehajte sa na poradie vkladania a neukladajte index ako identifikátor kľúča. Ak záleží na poradí zobrazenia, zozbierajte názvy a explicitne ich zoraďte. Uložením length nevznikne snímka úložiska: zmeny počas prechádzania môžu spôsobiť, že niektoré kľúče preskočíte alebo ich navštívite dvakrát.
Rozhranie Web Storage definuje štandard HTML, nie ECMAScript 2024. window.localStorage je viazané na pôvod (origin) a môže pretrvať reštart prehliadača. window.sessionStorage je navyše oddelené podľa kariet alebo okien najvyššej úrovne: pretrvá opätovné načítanie stránky, no je viazané na reláciu stránky. Nepredpokladajte dostupnosť v každom prostredí. Získanie ktoréhokoľvek objektu úložiska môže vyvolať SecurityError pri nepriehľadnom pôvode alebo v dôsledku pravidiel prehliadača. Zápis môže vyvolať QuotaExceededError, napríklad pri vyčerpaní kvóty.
Príklady
(() => {
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" },
);
}
})();Výsledok
0 2 [["lang","en"],["theme","dark"]] null
Spustite kód v konzole prehliadača na stránke HTTP(S) v testovacej karte s prázdnym a dostupným `sessionStorage`, ktoré nemení žiadny iný kód. Zoradením sa výstup stane nezávislým od poradia kľúčov v prehliadači. `key(count)` vráti `null` a `finally` odstráni iba dve položky použité v príklade. Pre Node.js 24 uložte kód ako `main.js` a spustite `node main.js`. V prípade potreby príklad povolí vstavané rozhranie Web Storage v podriadenom procese.
Súvisiace lekcie
- JavaScript · Lekcia 42 · Pokročilá · Verzia: 4