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

CKTIS / JavaScript

Storage.removeItem — odstránenie jednej položky

Metóda removeItem(key) odstráni konkrétnu dvojicu kľúča a hodnoty z localStorage alebo sessionStorage. Vráti undefined; chýbajúci kľúč nespôsobí chybu.

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

Storage.removeItem je synchrónna metóda Web Storage definovaná v HTML Standard, nie v ECMAScript. Volajte ju na localStorage alebo sessionStorage a odovzdajte kľúč ako reťazec. Podporujú ju všetky hlavné jadrá prehliadačov, no nie každé jadro implementuje Web Storage. Prítomnosť Node 24 v repozitári nedokazuje podporu v prehliadačoch.

removeItem(key) odstráni iba určenú položku a vráti undefined, aj keď kľúč neexistuje. Po odstránení vracia getItem(key) hodnotu null. Naproti tomu clear() odstráni všetky položky z vybraného úložiska.

Pri skutočnom odstránení sa zaradí udalosť storage pre ostatné dokumenty zdieľajúce dané úložisko, nie však pre okno, ktoré operáciu vykonáva; newValue má hodnotu null. Chýbajúci kľúč nevyvolá žiadnu udalosť.

Prístup k window.localStorage alebo window.sessionStorage môže vyvolať výnimku SecurityError, napríklad v dôsledku pravidiel prehliadača. Príklad sa najprv pokúsi použiť window.sessionStorage. Ak tento pokus vyvolá výnimku SecurityError alebo QuotaExceededError, namiesto Web Storage použije testovací objekt, ktorý uchováva údaje v pamäti pomocou Map. V oboch prípadoch príklad vyberie nepoužitý kľúč, uloží pod ním dočasnú položku a potom ju odstráni.

Príklady

<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Storage.removeItem: removing one entry</title>
</head>
<body>
<h1>Removing a storage entry</h1>
<p id="source"></p>
<script>
  function checkRemoval(storage) {
    let key = 'cktis:removeItem';
    while (storage.getItem(key) !== null) key += ':';

    try {
      storage.setItem(key, 'draft');
      const removed = storage.removeItem(key);
      const missing = storage.getItem(key) === null;
      const removedAgain = storage.removeItem(key);
      return [removed === undefined, missing, removedAgain === undefined && storage.getItem(key) === null];
    } finally {
      storage.removeItem(key);
    }
  }

  let lines;
  let source = 'Using browser sessionStorage.';
  try {
    lines = checkRemoval(window.sessionStorage);
  } catch (error) {
    if (error.name !== 'SecurityError' && error.name !== 'QuotaExceededError') throw error;
    source = 'Could not access browser sessionStorage or write the test entry. Using an in-memory fixture, not Web Storage.';
    const entries = new Map();
    lines = checkRemoval({
      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

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