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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.