CKTIS / JavaScript
localStorage — místní ukládání dat
localStorage poskytuje prohlížeči úložiště textových párů klíč–hodnota přiřazené k originu. Data mohou přetrvat déle než jednu relaci, ale přístup a uchování dat závisí na zásadách prohlížeče.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
window.localStorage
localStorage.setItem(key, value)
localStorage.getItem(key)
localStorage.removeItem(key)window.localStorage vrací objekt Storage pro origin stránky. Jde o Web API definované v HTML Living Standard, nikoli o funkci ECMAScriptu. Současná jádra prohlížečů toto API podporují; Node 24 v repozitáři nedokládá podporu v prohlížečích.
setItem(key, value) uloží text, getItem(key) vrátí text nebo null a removeItem(key) odstraní položku. clear() odstraní všechny položky v daném úložišti, nejen položky aplikace.
Na rozdíl od sessionStorage mohou data přetrvat déle než jednu relaci a sdílet se mezi okny stejného originu. Nejde o zálohu: uživatelé nebo prohlížeče mohou data odstranit. Nepředpokládejte, že operace čtení–změna–zápis jsou zamykány. Změny vyvolají událost storage v jiných oknech používajících toto úložiště, nikoli v okně, které zapisuje.
Samotný přístup může vyvolat SecurityError a zápis může vyvolat QuotaExceededError; ošetřete obě chyby. Skripty stejného originu mohou data číst, proto zde neukládejte tajné údaje. Pokud operace proběhnou úspěšně, příklad zapíše hodnotu pod náhodně vygenerovaným klíčem, přečte ji a odstraní položku, aniž by obnovoval jakoukoli předchozí hodnotu. Při zobrazeném spuštění vyvolá přístup k window.localStorage chybu SecurityError dříve, než kód dospěje k zápisu.
Příklady
(() => {
const key = `cktis-storage-${crypto.getRandomValues(new Uint32Array(4)).join('-')}`;
try {
const storage = window.localStorage;
storage.setItem(key, 42);
let stored;
try {
stored = storage.getItem(key);
} finally {
storage.removeItem(key);
}
console.log(`Stored as a string: ${stored === '42'}`);
console.log(`Missing after removal: ${storage.getItem(key) === null}`);
} catch (error) {
console.log(`Storage unavailable: ${error.name}`);
}
})();Výsledek
Storage unavailable: SecurityError
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.