Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

sessionStorage — pohrana sesije kartice

sessionStorage pohranjuje tekstualne parove ključ–vrijednost za origin i sesiju kartice. Prikladan je za privremeno stanje, primjerice skicu obrasca, ali pristup pohrani ili zapis mogu ne uspjeti.

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

Sintaksa

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

window.sessionStorage vraća objekt Storage povezan s originom i sesijom kartice. Podaci ostaju sačuvani nakon ponovnog učitavanja stranice. Za razliku od localStorage, nije namijenjen stanju koje traje kroz više sesija. Zasebne kartice imaju zasebne pohrane; novi pomoćni prozor u početku može dobiti kopiju podataka prozora koji ga je otvorio, no kasnije su promjene neovisne.

Operacije su sinkrone. setItem(key, value) pohranjuje tekst, getItem(key) vraća tekst ili null, a removeItem(key) uklanja stavku. clear() uklanja sve stavke iz te pohrane, a ne samo podatke jedne komponente — upotrebljavajte ga oprezno.

Pristup sessionStorage može izazvati SecurityError, primjerice zbog pravila preglednika ili neprozirnog origina. Zapis može izazvati QuotaExceededError. Obradite iznimke i nemojte pohranu smatrati jedinom kopijom važnih podataka ni mjestom za tajne kojima bi trebao moći pristupiti samo jedan skript.

Ovo je web API definiran u HTML-u, a ne značajka određenog izdanja ECMAScripta. Standard navodi podršku u svim trenutačnim pregledničkim engineima; prisutnost Node 24 u repozitoriju ne dokazuje podršku za ovaj API preglednika.

Primjeri

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

Rezultat

Session storage unavailable: SecurityError

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori