CKTIS / JavaScript
localStorage — miestne ukladanie údajov
localStorage poskytuje prehliadaču úložisko textových párov kľúč–hodnota priradené k originu. Údaje môžu pretrvať dlhšie než jednu reláciu, ale prístup a uchovávanie závisia od pravidiel prehliadača.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
window.localStorage
localStorage.setItem(key, value)
localStorage.getItem(key)
localStorage.removeItem(key)window.localStorage vracia objekt Storage pre origin stránky. Ide o Web API definované v HTML Living Standard, nie o funkciu ECMAScriptu. Súčasné jadrá prehliadačov toto API podporujú; Node 24 v repozitári nedokladá podporu v prehliadačoch.
setItem(key, value) uloží text, getItem(key) vráti text alebo null a removeItem(key) odstráni položku. clear() odstráni všetky položky v danom úložisku, nielen položky aplikácie.
Na rozdiel od sessionStorage môžu údaje pretrvať dlhšie než jednu reláciu a zdieľať sa medzi oknami rovnakého originu. Nejde o zálohu: používatelia alebo prehliadače môžu údaje odstrániť. Nepredpokladajte, že operácie čítania–zmeny–zápisu sú uzamykané. Zmeny vyvolajú udalosť storage v iných oknách, ktoré používajú toto úložisko, nie však v okne, ktoré zapisuje.
Samotný prístup môže vyvolať SecurityError a zápis môže vyvolať QuotaExceededError; ošetrite obe chyby. Skripty rovnakého originu môžu údaje čítať, preto tu neukladajte tajné údaje. Ak operácie prebehnú úspešne, príklad zapíše hodnotu pod náhodne vygenerovaným kľúčom, prečíta ju a odstráni položku bez obnovenia akejkoľvek predchádzajúcej hodnoty. Pri zobrazenom spustení vyvolá prístup k window.localStorage chybu SecurityError skôr, ako sa kód dostane k zápisu.
Prí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ýsledok
Storage unavailable: SecurityError
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.