Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

Storage.getItem — čítanie hodnoty z Web Storage

Storage.getItem(key) synchrónne číta text z localStorage alebo sessionStorage. Ak kľúč neexistuje, vráti null; prázdny reťazec je existujúca hodnota, nie chýbajúca položka.

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

Syntax

storage.getItem(key)

Storage.getItem je inštančná metóda rozhrania Storage, ktorú používajú localStorage a sessionStorage. Prijíma textový kľúč a vracia uložený text alebo null, ak položka neexistuje. Čítanie je synchrónne a položku neodstráni.

Rozlišujte medzi null, "" a "null". Neprítomnosť hodnoty kontrolujte pomocou value === null, nie pomocou !value, ktoré platí aj pre prázdny reťazec. Uloženým číslam a objektom sa ich pôvodné typy automaticky neobnovia.

Ide o Web API definované v HTML Living Standard, nie o funkciu konkrétnej edície ECMAScriptu. Moderné prehliadače ho široko podporujú; verzia Node v repozitári nedokladá podporu v prehliadačoch. Už samotný prístup k window.localStorage alebo window.sessionStorage môže pre nepriehľadný pôvod alebo pravidlá prehliadača vyvolať SecurityError.

Príklad rozlišuje prázdny reťazec, reťazec "42" a chýbajúcu položku. Vyberie nepoužitý kľúč a odstráni dočasnú položku, aby overil, že čítanie vráti null. Blok finally zopakuje odstránenie, aby dočasná položka nezostala v úložisku ani pri chybe, bez vymazania celého úložiska.

Príklady

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

Výsledok

""
"42"
true

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje