CKTIS / JavaScript
localStorage — lokalno shranjevanje podatkov
localStorage brskalniku omogoča shrambo besedilnih parov ključ–vrednost, povezanih z originom. Podatki lahko ostanejo shranjeni tudi po koncu seje, vendar sta dostop in trajnost odvisna od pravil brskalnika.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
window.localStorage
localStorage.setItem(key, value)
localStorage.getItem(key)
localStorage.removeItem(key)window.localStorage vrne objekt Storage za origin strani. Gre za spletni API, določen v HTML Living Standard, ne za funkcijo ECMAScript. Današnji brskalniški pogoni ga podpirajo; Node 24 v repozitoriju ne dokazuje podpore v brskalnikih.
setItem(key, value) shrani besedilo, getItem(key) vrne besedilo ali null, removeItem(key) pa odstrani vnos. clear() odstrani vse vnose v tej shrambi, ne samo vnosov aplikacije.
Za razliko od sessionStorage lahko podatki ostanejo shranjeni tudi po koncu seje in se delijo med okni z istim originom. To ni varnostna kopija: uporabniki ali brskalniki lahko podatke izbrišejo. Ne predpostavljajte, da so operacije branja–spreminjanja–zapisovanja zaklenjene. Spremembe sprožijo dogodek storage v drugih oknih, ki uporabljajo to shrambo, ne pa v oknu, ki zapisuje.
Že dostop lahko sproži SecurityError, zapis pa lahko sproži QuotaExceededError; obravnavajte obe napaki. Skripti z istega origina lahko berejo podatke, zato tukaj ne shranjujte skrivnosti. Če operacije uspejo, primer zapiše vrednost pod naključno ustvarjenim ključem, jo prebere in odstrani vnos, ne da bi obnovil kakršno koli prejšnjo vrednost. Pri prikazanem izvajanju dostop do window.localStorage sproži napako SecurityError, še preden koda pride do zapisa.
Primeri
(() => {
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}`);
}
})();Rezultat
Storage unavailable: SecurityError
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.