KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

localStorage — lokale gegevensopslag

localStorage biedt een browseropslag voor tekenreeksen als sleutel-waardeparen, gekoppeld aan een origin. Gegevens kunnen langer dan een sessie bewaard blijven, maar toegang en bewaring hangen af van het browserbeleid.

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.localStorage
localStorage.setItem(key, value)
localStorage.getItem(key)
localStorage.removeItem(key)

window.localStorage geeft een Storage-object voor de origin van de pagina. Het is een Web-API uit de HTML Living Standard, geen functie van ECMAScript. Huidige browserengines ondersteunen deze API; Node 24 in de repository toont niet aan dat browsers deze ondersteunen.

setItem(key, value) slaat tekst op, getItem(key) geeft tekst of null terug en removeItem(key) verwijdert een item. clear() verwijdert alle items in die opslagruimte, niet alleen de items van de applicatie.

In tegenstelling tot sessionStorage kunnen gegevens langer dan een sessie bewaard blijven en worden gedeeld tussen vensters met dezelfde origin. Het is geen back-up: gebruikers of browsers kunnen de gegevens verwijderen. Ga er niet van uit dat lees–wijzig–schrijf-bewerkingen vergrendeld zijn. Wijzigingen veroorzaken een storage-gebeurtenis in andere vensters die dezelfde opslagruimte gebruiken, maar niet in het venster dat schrijft.

De toegang zelf kan SecurityError veroorzaken en schrijven kan QuotaExceededError veroorzaken; handel beide af. Scripts van dezelfde origin kunnen de gegevens lezen, dus bewaar hier geen geheimen. Als de bewerkingen slagen, slaat het voorbeeld een waarde op onder een willekeurig gegenereerde sleutel, leest het die waarde terug en verwijdert het het item zonder een eerdere waarde te herstellen. Bij de getoonde uitvoering veroorzaakt toegang tot window.localStorage een SecurityError voordat de code aan het schrijven toekomt.

Voorbeelden

(() => {
  const key = `cktis-storage-${crypto.getRandomValues(new Uint32Array(4)).join('-')}`;
  try {
    const storage = window.localStorage;
    storage.setItem(key, 42);
    let stored;
    try {
      stored = storage.getItem(key);
    } finally {
      storage.removeItem(key);
    }
    console.log(`Stored as a string: ${stored === '42'}`);
    console.log(`Missing after removal: ${storage.getItem(key) === null}`);
  } catch (error) {
    console.log(`Storage unavailable: ${error.name}`);
  }
})();

Resultaat

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