Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Storage.clear() — odstranění všech položek

Storage.clear() synchronně odstraní všechny dvojice klíč–hodnota z vybrané oblasti Web Storage. Nepřijímá žádné argumenty a vrací undefined. Pozor: smaže také položky, které nesouvisejí s vaším kódem.

Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

storage.clear()

Storage.clear pracuje s objektem Storage: localStorage.clear() vymaže místní oblast daného originu, zatímco sessionStorage.clear() vymaže oblast relace pro daný origin a kartu. Nevymaže obě oblasti současně. Jde o API standardu HTML, nikoli ECMAScriptu.

Metoda je synchronní, nepřijímá žádné argumenty a vrací undefined. Prázdná oblast zůstane prázdná. Chcete-li odstranit jednu položku, použijte removeItem(key); clear() nefiltruje klíče podle předpony.

Odstranění položek zařadí událost storage do fronty pro jiné způsobilé dokumenty, které oblast sdílejí, nikoli však pro dokument, který metodu zavolal. Její pole key, oldValue a newValue mají hodnotu null. Prázdná oblast žádnou událost nevyvolá.

Přístup k window.localStorage nebo window.sessionStorage může vyvolat SecurityError, například kvůli zásadám prohlížeče. V příkladu má iframe kvůli omezením sandboxu neprůhledný origin. Výraz typeof Storage.prototype.clear vrátí "function", ale čtení window.sessionStorage vyvolá SecurityError dříve, než kód zavolá clear(). Žádné položky se nesmažou. Úspěšné volání sessionStorage.clear() zkoušejte pouze na samostatné testovací kartě a na testovacím originu: smaže všechny položky v úložišti relace, včetně těch dříve uložených.

Příklady

<!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>

Výsledek

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

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje