CKTIS / JavaScript
Storage.length en Storage.key(): items tellen en sleutelnamen opvragen
`length` telt de opgeslagen items en `key(index)` geeft op basis van een positie de sleutelnaam terug. De volgorde is niet gegarandeerd.
Versie: 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 verwijst naar twee onderdelen van een Storage-object. De alleen-lezen eigenschap storage.length telt de sleutel-waardeparen die op dat moment zijn opgeslagen. Het is geen grootte in bytes en ook geen opslaglimiet. De methode storage.key(index) geeft de sleutelnaam als tekenreeks terug, niet de waarde. Posities beginnen bij nul: geef een niet-negatief geheel getal binnen het bereik van unsigned long (0 tot en met 2 ** 32 - 1) mee. Is de geconverteerde index groter dan of gelijk aan de huidige length, dan geeft de methode null terug.
Geef de naam door aan storage.getItem(name) om de waarde op te vragen. Ook deze methode kan null teruggeven, maar dan betekent het dat de sleutel ontbreekt. Controleer het resultaat van key() met name !== null, want ook een lege tekenreeks kan een geldige sleutelnaam zijn.
De volgorde van sleutels is afhankelijk van de implementatie en kan na een wijziging veranderen. Ga niet uit van de invoegvolgorde en bewaar geen index als sleutel-ID. Is de weergavevolgorde belangrijk, verzamel de namen dan en sorteer ze expliciet. Door length op te slaan maak je geen momentopname: wijzigingen tijdens het doorlopen kunnen ertoe leiden dat je sleutels overslaat of twee keer tegenkomt.
Web Storage is gedefinieerd in de HTML-standaard en maakt geen deel uit van ECMAScript 2024. window.localStorage is gekoppeld aan een origin en kan een herstart van de browser overleven. window.sessionStorage is ook gescheiden per tabblad of venster op het hoogste niveau: de gegevens blijven behouden bij herladen, maar zijn gebonden aan de paginasessie. Ga er niet van uit dat de API in elke runtime beschikbaar is. Het opvragen van een opslagobject kan bij een ondoorzichtige origin of door browserbeleid SecurityError opleveren. Bij schrijven kan QuotaExceededError optreden, bijvoorbeeld als de opslaglimiet is bereikt.
Voorbeelden
(() => {
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" },
);
}
})();Resultaat
0 2 [["lang","en"],["theme","dark"]] null
Voer dit uit in de browserconsole op een HTTP(S)-pagina in een testtabblad met lege, toegankelijke `sessionStorage` die niet door andere code wordt gewijzigd. Door te sorteren is de uitvoer onafhankelijk van de sleutelvolgorde van de browser. `key(count)` geeft `null` terug en `finally` verwijdert alleen de twee items die het voorbeeld gebruikt. Sla de code voor Node.js 24 op als `main.js` en voer `node main.js` uit. Zo nodig schakelt het voorbeeld de ingebouwde Web Storage in een onderliggend proces in.
Gerelateerde lessen
- JavaScript · Les 42 · Gevorderd · Versie: 4