KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Storage.clear() — alle items verwijderen

Storage.clear() verwijdert synchroon alle sleutel-waardeparen uit het geselecteerde Web Storage-gebied. De methode heeft geen argumenten en geeft undefined terug. Let op: ook items die niets met je code te maken hebben, worden verwijderd.

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

Syntax

storage.clear()

Storage.clear werkt op een Storage-object: localStorage.clear() leegt het lokale gebied van de betreffende origin, terwijl sessionStorage.clear() het sessiegebied van die origin en dat tabblad leegt. De methode leegt niet beide tegelijk. Dit is een API uit de HTML-standaard, niet uit ECMAScript.

De methode is synchroon, heeft geen argumenten en geeft undefined terug. Een leeg gebied blijft leeg. Gebruik removeItem(key) om één item te verwijderen; clear() filtert sleutels niet op prefix.

Door items te verwijderen wordt een storage-event in de wachtrij geplaatst voor andere daarvoor in aanmerking komende documenten die het gebied delen, maar niet voor het aanroepende document. De velden key, oldValue en newValue zijn dan null. Een leeg gebied veroorzaakt geen event.

Toegang tot window.localStorage of window.sessionStorage kan een SecurityError veroorzaken, bijvoorbeeld door browserbeleid. In het voorbeeld krijgt het iframe door de sandbox een ondoorzichtige origin. typeof Storage.prototype.clear geeft "function" terug, maar het uitlezen van window.sessionStorage veroorzaakt een SecurityError voordat de code clear() aanroept. Er worden geen items verwijderd. Test een geslaagde aanroep van sessionStorage.clear() alleen in een apart testtabblad en op een test-origin: die aanroep verwijdert alle items uit het sessieopslaggebied, ook de items die er al stonden.

Voorbeelden

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

Resultaat

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

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen