Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Storage.clear() — usuwanie wszystkich wpisów

Storage.clear() synchronicznie usuwa wszystkie pary klucz–wartość z wybranego obszaru Web Storage. Nie przyjmuje argumentów i zwraca undefined. Uważaj: usuwa również wpisy niezwiązane z Twoim kodem.

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

storage.clear()

Storage.clear działa na obiekcie Storage: localStorage.clear() czyści lokalny obszar danego originu, a sessionStorage.clear() — obszar sesyjny danego originu i karty. Nie czyści obu naraz. To API standardu HTML, nie ECMAScript.

Metoda jest synchroniczna, nie przyjmuje argumentów i zwraca undefined. Pusty obszar pozostaje pusty. Aby usunąć pojedynczy wpis, użyj removeItem(key); clear() nie filtruje kluczy według prefiksu.

Usunięcie wpisów kolejkuje zdarzenie storage dla innych uprawnionych dokumentów współdzielących obszar, nie dokumentu wywołującego. Pola key, oldValue i newValue mają wtedy wartość null. Pusty obszar nie powoduje zdarzenia.

Dostęp do window.localStorage lub window.sessionStorage może zgłosić SecurityError, np. przez politykę przeglądarki. W przykładzie sandbox nadaje ramce iframe nieprzezroczysty origin. Wyrażenie typeof Storage.prototype.clear zwraca "function", ale odczyt window.sessionStorage zgłasza SecurityError, zanim kod wywoła clear(). Żadne wpisy nie są usuwane. Działające wywołanie sessionStorage.clear() testuj tylko w osobnej karcie i na testowym originie: usuwa wszystkie wpisy z danego obszaru sesyjnego, także te zapisane wcześniej.

Przykłady

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Storage.clear() and storage access</title>
</head>
<body>
  <script>
    const frame = document.createElement('iframe');
    frame.title = 'Isolated Storage.clear test';
    frame.setAttribute('sandbox', 'allow-scripts');
    frame.srcdoc = `<!doctype html>
<html lang="en">
<head><meta charset="utf-8"><title>Storage clear test</title></head>
<body>
  <p role="status"></p>
  <script>
    const methodType = typeof Storage.prototype.clear;
    const methodStatus = 'typeof Storage.prototype.clear: ' + methodType;
    let resultStatus;
    try {
      const storage = window.sessionStorage;
      storage.setItem('demo:color', 'blue');
      storage.setItem('demo:count', '2');
      const result = storage.clear();
      resultStatus = 'Remaining entries: ' + storage.length + '; return value: ' + String(result);
    } catch (error) {
      resultStatus = 'Clear not completed: ' + error.name;
    }
    document.querySelector('[role="status"]').textContent = methodStatus + '. ' + resultStatus;
    console.log(methodStatus);
    console.log(resultStatus);
  <\/script>
</body>
</html>`;
    document.body.append(frame);
  </script>
</body>
</html>

Wynik

typeof Storage.prototype.clear: function
Clear not completed: SecurityError

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła