База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

localStorage — локално съхранение на данни

localStorage предоставя на браузъра хранилище за текстови двойки ключ–стойност, свързани с origin. Данните могат да се запазят и след края на сесията, но достъпът и съхранението зависят от правилата на браузъра.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

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

window.localStorage връща обект Storage за origin на страницата. Това е Web API, дефиниран в HTML Living Standard, а не функция на ECMAScript. Съвременните браузърни машини го поддържат; Node 24 в хранилището не доказва поддръжка в браузърите.

setItem(key, value) записва текст, getItem(key) връща текст или null, а removeItem(key) изтрива запис. clear() изтрива всички записи в това хранилище, а не само записите на приложението.

За разлика от sessionStorage, данните могат да се запазят и след края на сесията и да се споделят между прозорци от един и същ origin. Това не е резервно копие: потребителите или браузърите могат да изтрият данните. Не приемайте, че операциите четене–промяна–запис са заключени. Промените задействат събитие storage в други прозорци, които използват това хранилище, но не и в прозореца, който записва.

Самият достъп може да предизвика SecurityError, а записването може да предизвика QuotaExceededError; обработвайте и двете грешки. Скриптове от същия origin могат да четат данните, затова не съхранявайте тайни тук. Ако операциите са успешни, примерът записва стойност с произволно генериран ключ, прочита я и изтрива записа, без да възстановява предишна стойност. При показаното изпълнение достъпът до window.localStorage предизвиква грешка SecurityError, преди кодът да стигне до записването.

Примери

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

Резултат

Storage unavailable: SecurityError

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници