Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

Storage.removeItem — uklanjanje jednog unosa

Metoda removeItem(key) uklanja određeni par ključ-vrijednost iz localStorage ili sessionStorage. Vraća undefined; nepostojeći ključ ne uzrokuje pogrešku.

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

Storage.removeItem sinkrona je metoda Web Storagea definirana u HTML Standardu, a ne u ECMAScriptu. Pozovite je na localStorage ili sessionStorage i proslijedite ključ kao niz znakova. Podržavaju je svi glavni preglednički mehanizmi, ali ne podržava svaki preglednički mehanizam Web Storage. Prisutnost Nodea 24 u repozitoriju ne dokazuje podršku u preglednicima.

removeItem(key) uklanja samo navedeni unos i vraća undefined, čak i ako ključ ne postoji. Nakon uklanjanja getItem(key) vraća null. Nasuprot tome, clear() uklanja sve unose iz odabranog prostora za pohranu.

Stvarnim se uklanjanjem događaj storage stavlja u red čekanja za druge dokumente koji dijele prostor za pohranu, ali ne i za prozor koji izvršava operaciju; newValue je null. Nepostojeći ključ ne pokreće događaj.

Pristup objektu window.localStorage ili window.sessionStorage može izazvati iznimku SecurityError, primjerice zbog pravila preglednika. Primjer najprije pokušava upotrijebiti window.sessionStorage. Ako se pritom pojavi iznimka SecurityError ili QuotaExceededError, umjesto Web Storagea upotrebljava testni objekt koji podatke čuva u memoriji pomoću objekta Map. U oba slučaja primjer odabire ključ koji se ne upotrebljava, pod njim pohranjuje privremeni unos i zatim ga uklanja.

Primjeri

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

Rezultat

true
true
true

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori