CKTIS / JavaScript
Browseropslag
Browseropslag omvat voorzieningen van de browseromgeving om gegevens aan de clientzijde te bewaren. Leer het verschil tussen localStorage en sessionStorage en waar de grens ligt tussen de ECMAScript-taal en Web-API’s.
Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
localStorage.setItem(key, value);
localStorage.getItem(key);
localStorage.removeItem(key);Browseropslag (browser storage) is een voorziening van de omgeving, geen ECMAScript-syntaxis. De ECMAScript-specificatie beschrijft de taal en de interactie met de hostomgeving; ze definieert localStorage of sessionStorage niet. Dat Node 24 in een repository aanwezig is, bewijst niet dat deze interfaces beschikbaar zijn in de doelbrowser.
localStorage bewaart sleutel-waardeparen tussen sessies, terwijl sessionStorage gekoppeld is aan een paginasessie in een bepaald tabblad. Beide interfaces werken synchroon en slaan tekenreeksen op. getItem(key) geeft null terug als de sleutel ontbreekt. Objecten kunnen worden opgeslagen met JSON.stringify en uitgelezen met JSON.parse.
Toegang hangt af van de oorsprong van de pagina en het browserbeleid. Gegevens kunnen worden verwijderd en toegang of schrijven kan een uitzondering veroorzaken. Beschouw deze opslag niet als de enige kopie van gegevens of als een plek voor geheimen. De sectie Web Storage van de WHATWG HTML-standaard definieert localStorage en sessionStorage en hun methoden. Die sectie is geen naslagwerk over browsercompatibiliteit en garandeert niet dat deze interfaces beschikbaar zijn in de doelbrowser.
Voorbeelden
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Browser storage example</title>
</head>
<body>
<p>localStorage can persist across visits. sessionStorage is scoped to the page session in a tab. Both are browser APIs, not part of ECMAScript.</p>
<ul aria-label="Storage check results">
<li id="localStorage"></li>
<li id="sessionStorage"></li>
</ul>
<script>
const fixture = JSON.stringify({ theme: 'dark' });
function checkStorage(name) {
const result = document.getElementById(name);
try {
const store = window[name];
// A fresh temporary key avoids reusing application keys. This sequence is not atomic:
// another same-origin tab can change localStorage between calls.
const key = `cktis:storage:example:${crypto.getRandomValues(new Uint32Array(4)).join('-')}`;
if (store.getItem(key) !== null) {
throw new Error('Temporary storage key already exists');
}
store.setItem(key, fixture);
let saved;
try {
saved = store.getItem(key);
} finally {
store.removeItem(key);
}
if (saved !== fixture || store.getItem(key) !== null) {
throw new Error('Round trip or cleanup failed');
}
result.textContent = `${name}: read back theme=${JSON.parse(saved).theme}; temporary key removed.`;
} catch (error) {
if (!(error instanceof DOMException) || !['SecurityError', 'QuotaExceededError'].includes(error.name)) {
throw error;
}
result.textContent = `${name}: temporary write unavailable (${error.name}).`;
}
console.log(result.textContent);
}
checkStorage('localStorage');
checkStorage('sessionStorage');
</script>
</body>
</html>Resultaat
A successful check reports that it read back theme=dark and removed the temporary key. If the check catches a DOMException named SecurityError or QuotaExceededError, it reports that the temporary write is unavailable and includes the error name. Other errors, including a temporary-key collision or a detected round-trip or cleanup failure, are rethrown without a report for that storage area. If the localStorage check rethrows, the sessionStorage check does not run.
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.