CKTIS / JavaScript
Storage: brojanje stavki i čitanje naziva ključeva
Storage omogućuje parove ključeva i vrijednosti u obliku nizova putem localStorage i sessionStorage. Saznajte razliku između Storage.length, koji broji stavke, i Storage.key(index), koji vraća naziv ključa, a ne njegovu vrijednost.
Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
storage.length
storage.key(index)
storage.getItem(key)
storage.setItem(key, value)
storage.removeItem(key)
storage.clear()Storage je sučelje Web API-ja definirano standardom HTML, a ne ECMAScriptom. Njegove objekte možete dohvatiti putem window.localStorage ili window.sessionStorage. Prvi je namijenjen pohrani podataka i nakon trenutačne sesije; drugi je povezan sa sesijom i izvorom kartice. Ključevi i vrijednosti nizovi su znakova.
Storage.length dostupan je samo za čitanje: daje broj parova, a ne njihovu veličinu u bajtovima. Pri pozivu metode Storage.key(index) Web IDL najprije pretvara argument u tip unsigned long. Metoda upotrebljava pretvorenu vrijednost kao indeks koji se broji od nule i vraća naziv ključa ili null ako je taj indeks veći ili jednak vrijednosti length. Primjerice, storage.key(2 ** 32) upotrebljava indeks 0 i vraća naziv ključa ako spremište nije prazno. Vrijednost pročitajte pomoću getItem(key).
Redoslijed ključeva nije određen i može se mijenjati pri izmjenama. Nemojte pretpostavljati redoslijed umetanja niti uklanjati stavke tijekom iteriranja po indeksima. Za ponovljiv prikaz prikupite nazive i sortirajte ih.
Pristup može izazvati SecurityError, a zapisivanje može izazvati QuotaExceededError. U aplikacijama obradite te pogreške. Primjer najprije pokušava koristiti window.sessionStorage. Ako uhvati SecurityError ili QuotaExceededError, koristi testno spremište u memoriji umjesto Web Storagea i ispisuje isti rezultat u konzoli. Prisutnost Node 24 u repozitoriju ne dokazuje podršku za ovaj Web API.
Primjeri
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Storage: counting entries and reading key names</title>
</head>
<body>
<h1>Counting storage entries and listing their keys</h1>
<p id="source"></p>
<script>
function inspectStorage(storage) {
const names = ['cktis:storage:a', 'cktis:storage:b'].map(base => {
let name = base;
let suffix = 0;
while (storage.getItem(name) !== null) name = `${base}:${++suffix}`;
return name;
});
const written = [];
try {
const before = storage.length;
for (const [index, value] of ['10', '20'].entries()) {
storage.setItem(names[index], value);
written.push(names[index]);
}
const count = storage.length;
const keys = [];
for (let index = 0; index < count; index++) {
const name = storage.key(index);
if (names.includes(name)) keys.push(name);
}
return [count - before, keys.length, storage.key(count) === null];
} finally {
for (const name of written) storage.removeItem(name);
}
}
let lines;
let source = 'Using browser sessionStorage.';
try {
lines = inspectStorage(window.sessionStorage);
} catch (error) {
if (error.name !== 'SecurityError' && error.name !== 'QuotaExceededError') throw error;
source = 'The browser storage test write is unavailable. Using an in-memory fixture for this demonstration.';
const entries = new Map();
lines = inspectStorage({
get length() { return entries.size; },
key(index) { return Array.from(entries.keys())[index] ?? null; },
getItem(key) { return entries.has(key) ? entries.get(key) : null; },
setItem(key, value) { entries.set(key, String(value)); },
removeItem(key) { entries.delete(key); }
});
}
document.getElementById('source').textContent = source;
for (const line of lines) console.log(line);
</script>
</body>
</html>Rezultat
2 2 true
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.