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

CKTIS / JavaScript

Storage.setItem — shranjevanje in zamenjava vrednosti

Storage.setItem shrani besedilo pod ključ v localStorage ali sessionStorage in pri tem zamenja prejšnjo vrednost. Zapis lahko spodleti, zato upoštevajte izjeme in omejitve dostopa do shrambe.

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

Pokličite Storage.setItem na objektu localStorage ali sessionStorage: storage.setItem(key, value). Metoda ustvari vnos ali zamenja vrednost obstoječega ključa in vrne undefined. Ta API je del standarda HTML, ne pa značilnost določene izdaje ECMAScript. Sodobni brskalniški pogoni ga podpirajo; prisotnost Node 24 v repozitoriju ne dokazuje razpoložljivosti brskalniškega API-ja.

Ključi in vrednosti se pretvorijo v nize. Če želite shraniti objekt, ga izrecno serializirajte v niz. Pri branju shranjene vrednosti shramba vrne niz, ki ga mora aplikacija dekodirati glede na zapis, uporabljen pri shranjevanju. Če podatke zapišete v obliki JSON z JSON.stringify, za dekodiranje tega niza uporabite JSON.parse. localStorage hrani podatke za origin med sejami, sessionStorage pa je dodatno ločen glede na kontekst brskanja najvišje ravni, običajno po zavihkih. Podatke je mogoče izbrisati.

Neuspešen zapis lahko sproži QuotaExceededError; že dostop do shrambe lahko sproži SecurityError. Če mora aplikacija delovati tudi brez shrambe, dostop in zapis obdajte z try/catch. Zapis enakega besedila ničesar ne spremeni. Obvestilo storage je namenjeno drugim ustreznim dokumentom, ne oknu, ki zapis izvede.

Primeri

<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Storage.setItem: writing and replacing text</title>
</head>
<body>
<h1>Replacing a storage value</h1>
<p id="source"></p>
<script>
  function writeValues(storage) {
    let key = 'cktis:setItem';
    while (storage.getItem(key) !== null) key += ':';

    try {
      storage.setItem(key, 'first');
      const before = storage.getItem(key);
      storage.setItem(key, 'second');
      return [before, storage.getItem(key)];
    } finally {
      storage.removeItem(key);
    }
  }

  let lines;
  let source = 'Using browser sessionStorage.';
  try {
    lines = writeValues(window.sessionStorage);
  } catch (error) {
    if (error.name !== 'SecurityError' && error.name !== 'QuotaExceededError') throw error;
    source = 'Browser storage is unavailable. Using an in-memory fixture, not Web Storage.';
    const entries = new Map();
    lines = writeValues({
      getItem(key) { return entries.has(key) ? entries.get(key) : null; },
      setItem(key, value) { entries.set(key, String(value)); },
      removeItem(key) { entries.delete(key); }
    });
  }
  document.getElementById('source').textContent = source;
  for (const line of lines) console.log(line);
</script>
</body>
</html>

Rezultat

first
second

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

Viri