KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

sessionStorage — sessieopslag van het tabblad

sessionStorage slaat tekenreeksen als sleutel-waardeparen op voor een origin en een tabsessie. Het is geschikt voor tijdelijke toestand, zoals een concept van een formulier, maar toegang tot de opslag of schrijven kan mislukken.

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

window.sessionStorage
sessionStorage.setItem(key, value)
sessionStorage.getItem(key)
sessionStorage.removeItem(key)
sessionStorage.clear()

window.sessionStorage retourneert een Storage-object dat is gekoppeld aan een origin en een tabsessie. Gegevens blijven behouden nadat de pagina opnieuw is geladen. In tegenstelling tot localStorage is het niet bedoeld voor toestand die sessies overbrugt. Afzonderlijke tabbladen hebben afzonderlijke opslag; een nieuw hulpvenster kan aanvankelijk een kopie ontvangen van de gegevens van het venster dat het heeft geopend, maar latere wijzigingen zijn onafhankelijk.

Bewerkingen zijn synchroon. setItem(key, value) slaat tekst op, getItem(key) retourneert tekst of null en removeItem(key) verwijdert een item. clear() verwijdert alle items in die opslag, niet alleen de gegevens van één component — gebruik dit voorzichtig.

Toegang tot sessionStorage kan een SecurityError veroorzaken, bijvoorbeeld door browserbeleid of een ondoorzichtige origin. Schrijven kan een QuotaExceededError veroorzaken. Handel uitzonderingen af en beschouw opslag niet als de enige kopie van belangrijke gegevens of als een plek voor geheimen die slechts voor één script toegankelijk mogen zijn.

Dit is een Web-API die in HTML is gedefinieerd, geen functie van een bepaalde ECMAScript-editie. De standaard geeft aan dat alle huidige browserengines deze ondersteunen; de aanwezigheid van Node 24 in een repository bewijst niet dat deze browser-API wordt ondersteund.

Voorbeelden

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Session storage access and draft values</title>
</head>
<body>
  <script>
    const frame = document.createElement('iframe');
    frame.title = 'Session storage test';
    frame.setAttribute('sandbox', 'allow-scripts');
    frame.srcdoc = `<!doctype html>
<html lang="en">
<head><meta charset="utf-8"><title>Draft storage</title></head>
<body>
  <p role="status"></p>
  <script>
    let message;
    try {
      const storage = window.sessionStorage;
      const key = 'cktis:sessionStorage:draft';
      const previous = storage.getItem(key);
      try {
        storage.setItem(key, 'draft');
        const saved = storage.getItem(key);
        storage.removeItem(key);
        message = 'Saved: ' + saved + '; removed: ' + (storage.getItem(key) === null);
      } finally {
        if (previous === null) storage.removeItem(key);
        else storage.setItem(key, previous);
      }
    } catch (error) {
      message = 'Session storage unavailable: ' + error.name;
    }
    document.querySelector('[role="status"]').textContent = message;
    console.log(message);
  <\/script>
</body>
</html>`;
    document.body.append(frame);
  </script>
</body>
</html>

Resultaat

Session storage unavailable: 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