Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje