CKTIS / JavaScript
localStorage — lokalne przechowywanie danych
localStorage udostępnia przeglądarkowy magazyn tekstowych par klucz–wartość powiązany z originem. Dane mogą przetrwać sesję, ale dostęp i trwałość zależą od polityki przeglądarki.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
window.localStorage
localStorage.setItem(key, value)
localStorage.getItem(key)
localStorage.removeItem(key)window.localStorage zwraca obiekt Storage dla originu strony. To Web API zdefiniowane w HTML Living Standard, a nie funkcja ECMAScript. Obsługują je współczesne silniki przeglądarek; Node 24 w repozytorium nie potwierdza obsługi w przeglądarce.
setItem(key, value) zapisuje tekst, getItem(key) zwraca tekst albo null, a removeItem(key) usuwa wpis. clear() usuwa wszystkie wpisy w danym magazynie, nie tylko wpisy aplikacji.
W przeciwieństwie do sessionStorage, dane mogą przetrwać sesję i być współdzielone między oknami tego samego originu. Nie jest to kopia zapasowa: użytkownik lub przeglądarka mogą je usunąć. Nie zakładaj blokady przy operacji odczyt–zmiana–zapis. Zmiany wywołują zdarzenie storage w innych oknach korzystających z tego magazynu, nie w oknie zapisującym.
Sam dostęp może zgłosić SecurityError, a zapis — QuotaExceededError; obejmij oba obsługą błędów. Skrypty tego samego originu mogą odczytać dane, więc nie przechowuj tu sekretów. Gdy operacje się powiodą, przykład zapisuje wartość pod losowo wygenerowanym kluczem, odczytuje ją i usuwa wpis bez przywracania jakiejkolwiek wcześniejszej wartości. W pokazanym uruchomieniu dostęp do window.localStorage zgłasza SecurityError, zanim kod dojdzie do zapisu.
Przykłady
(() => {
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}`);
}
})();Wynik
Storage unavailable: SecurityError
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.