Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła