Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

localStorage — lokalna pohrana podataka

localStorage pruža pregledniku pohranu tekstualnih parova ključ–vrijednost povezanih s originom. Podaci mogu ostati pohranjeni i nakon sesije, ali pristup i trajnost ovise o pravilima preglednika.

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

window.localStorage
localStorage.setItem(key, value)
localStorage.getItem(key)
localStorage.removeItem(key)

window.localStorage vraća objekt Storage za origin stranice. Riječ je o web API-ju definiranom u HTML Living Standardu, a ne o značajki ECMAScripta. Današnji preglednički pogoni podržavaju ga; Node 24 u repozitoriju ne dokazuje podršku u preglednicima.

setItem(key, value) pohranjuje tekst, getItem(key) vraća tekst ili null, a removeItem(key) uklanja unos. clear() uklanja sve unose u toj pohrani, a ne samo unose aplikacije.

Za razliku od sessionStorage, podaci mogu ostati pohranjeni i nakon sesije te se dijeliti među prozorima istog origina. To nije sigurnosna kopija: korisnici ili preglednici mogu ih izbrisati. Nemojte pretpostaviti da su operacije čitanja–izmjene–pisanja zaključane. Promjene pokreću događaj storage u drugim prozorima koji koriste tu pohranu, ali ne i u prozoru koji zapisuje.

Sam pristup može izazvati SecurityError, a zapisivanje može izazvati QuotaExceededError; obradite obje pogreške. Skripte istog origina mogu čitati podatke, zato ovdje nemojte pohranjivati tajne. Ako operacije uspiju, primjer zapisuje vrijednost pod nasumično generiranim ključem, čita je i uklanja unos bez vraćanja bilo koje prethodne vrijednosti. U prikazanom izvršavanju pristup objektu window.localStorage izaziva pogrešku SecurityError prije nego što kôd dođe do zapisivanja.

Primjeri

(() => {
  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

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori