Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Storage.clear() — odstranitev vseh vnosov

Storage.clear() sinhrono odstrani vse pare ključ–vrednost iz izbranega območja Web Storage. Ne sprejme argumentov in vrne undefined. Pozor: izbriše tudi vnose, ki niso povezani z vašo kodo.

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

Sintaksa

storage.clear()

Storage.clear deluje na objektu Storage: localStorage.clear() izprazni lokalno območje zadevnega izvora, sessionStorage.clear() pa izprazni sejno območje tega izvora in zavihka. Ne izprazni obeh hkrati. To je API standarda HTML, ne ECMAScript.

Metoda je sinhrona, ne sprejme argumentov in vrne undefined. Prazno območje ostane prazno. Za odstranitev posameznega vnosa uporabite removeItem(key); clear() ključev ne filtrira po predponi.

Odstranitev vnosov uvrsti dogodek storage v čakalno vrsto za druge upravičene dokumente, ki si delijo območje, ne pa za dokument, ki je metodo poklical. Polja key, oldValue in newValue imajo vrednost null. Prazno območje ne sproži dogodka.

Dostop do window.localStorage ali window.sessionStorage lahko sproži SecurityError, na primer zaradi pravil brskalnika. V primeru ima iframe zaradi izolacije z atributom sandbox neprosojen izvor. Izraz typeof Storage.prototype.clear vrne "function", vendar branje window.sessionStorage sproži SecurityError, še preden koda pokliče clear(). Noben vnos se ne izbriše. Uspešen klic sessionStorage.clear() preizkusite le v ločenem testnem zavihku in na testnem izvoru: klic izbriše vse vnose v sejni shrambi, tudi tiste, ki so že bili v njej.

Primeri

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

Rezultat

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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri