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

CKTIS / JavaScript

Storage.getItem — branje vrednosti iz Web Storage

Storage.getItem(key) sinhrono prebere besedilo iz localStorage ali sessionStorage. Če ključ ne obstaja, vrne null; prazen niz je obstoječa vrednost, ne manjkajoč vnos.

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.getItem(key)

Storage.getItem je instančna metoda vmesnika Storage, ki jo uporabljata localStorage in sessionStorage. Sprejme besedilni ključ in vrne shranjeno besedilo ali null, če vnos ne obstaja. Branje je sinhrono in vnosa ne odstrani.

Razlikujte med null, "" in "null". Odsotnost preverite z value === null, ne z !value, saj ta pogoj velja tudi za prazen niz. Shranjene številke in objekti samodejno ne dobijo nazaj svojih prvotnih tipov.

To je spletni API, opredeljen v HTML Living Standard, ne pa funkcija določene izdaje ECMAScripta. Sodobni brskalniki ga široko podpirajo; različica Node v repozitoriju ne dokazuje podpore v brskalnikih. Že dostop do window.localStorage ali window.sessionStorage lahko zaradi neprozornega izvora ali pravil brskalnika sproži SecurityError.

Primer razlikuje med praznim nizom, nizom "42" in manjkajočim vnosom. Izbere neuporabljen ključ in odstrani začasni vnos, da preveri, ali branje vrne null. Blok finally ponovi odstranitev, da začasni vnos tudi ob napaki ne ostane v shrambi, ne da bi izpraznil celotno shrambo.

Primeri

<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Storage.getItem: empty and missing values</title>
</head>
<body>
<h1>Reading a storage value</h1>
<p id="source"></p>
<script>
  function readValues(storage) {
    let key = 'cktis:getItem';
    while (storage.getItem(key) !== null) key += ':';

    try {
      storage.setItem(key, '');
      const empty = storage.getItem(key);
      storage.setItem(key, '42');
      const text = storage.getItem(key);
      storage.removeItem(key);
      return [JSON.stringify(empty), JSON.stringify(text), storage.getItem(key) === null];
    } finally {
      storage.removeItem(key);
    }
  }

  let lines;
  let source = 'Using browser sessionStorage.';
  try {
    lines = readValues(window.sessionStorage);
  } catch (error) {
    if (error.name !== 'SecurityError' && error.name !== 'QuotaExceededError') throw error;
    source = error.name === 'QuotaExceededError'
      ? 'Could not write the demo value to sessionStorage. Existing entries may still be readable. Using an in-memory fixture, not Web Storage.'
      : 'Browser storage is unavailable. Using an in-memory fixture, not Web Storage.';
    const entries = new Map();
    lines = readValues({
      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

""
"42"
true

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

Viri