Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Storage.setItem — ukládání a nahrazování hodnoty

Storage.setItem ukládá text pod klíčem do localStorage nebo sessionStorage a nahrazuje předchozí hodnotu. Zápis může selhat, proto počítejte s výjimkami a omezeními přístupu k úložišti.

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

Syntaxe

storage.setItem(key, value)

Zavolejte Storage.setItem na objektu localStorage nebo sessionStorage: storage.setItem(key, value). Metoda vytvoří položku nebo nahradí hodnotu existujícího klíče a vrátí undefined. Toto API je součástí standardu HTML, nikoli vlastností konkrétní edice ECMAScriptu. Moderní prohlížečové enginy ho podporují; přítomnost Node 24 v repozitáři nedokazuje dostupnost prohlížečového API.

Klíče a hodnoty se převádějí na řetězce. Chcete-li uložit objekt, explicitně ho serializujte do řetězce. Při čtení uložené hodnoty vrátí úložiště řetězec, který musí aplikace dekódovat podle formátu použitého při zápisu. Pokud data zapisujete ve formátu JSON pomocí JSON.stringify, k dekódování tohoto řetězce použijte JSON.parse. localStorage uchovává data pro origin napříč relacemi, zatímco sessionStorage se navíc odděluje podle kontextu nejvyšší úrovně prohlížení, obvykle podle panelu. Data lze odstranit.

Neúspěšný zápis může vyvolat QuotaExceededError; samotný přístup k úložišti může vyvolat SecurityError. Pokud má aplikace fungovat i bez úložiště, obalte přístup i zápis do try/catch. Zápis stejného textu nic nemění. Oznámení storage se týká jiných způsobilých dokumentů, nikoli okna, které zápis provádí.

Příklady

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

Výsledek

first
second

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje