Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Storage.removeItem — rimuovere una voce

Il metodo removeItem(key) rimuove una specifica coppia chiave-valore da localStorage o sessionStorage. Restituisce undefined; se la chiave manca, non si verifica alcun errore.

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

Sintassi

storage.removeItem(key)

Storage.removeItem è un metodo sincrono di Web Storage, definito dall’HTML Standard e non da ECMAScript. Chiamalo su localStorage o sessionStorage, passando la chiave come stringa. Tutti i principali motori dei browser supportano il metodo, ma non tutti i motori implementano Web Storage. La presenza di Node 24 in un repository non dimostra il supporto nei browser.

removeItem(key) rimuove solo la voce specificata e restituisce undefined, anche se la chiave non esiste. Dopo la rimozione, getItem(key) restituisce null. Al contrario, clear() rimuove tutte le voci dall’area di archiviazione selezionata.

Una rimozione effettiva accoda un evento storage per gli altri documenti che condividono l’area di archiviazione, ma non per la finestra che esegue l’operazione; newValue è null. Se la chiave manca, non viene generato alcun evento.

L’accesso a window.localStorage o window.sessionStorage può generare un’eccezione SecurityError, per esempio a causa di una policy del browser. L’esempio prova prima a usare window.sessionStorage. Se il tentativo genera un’eccezione SecurityError o QuotaExceededError, usa un oggetto di test che conserva i dati in memoria in una Map, anziché in Web Storage. In entrambi i casi, l’esempio sceglie una chiave non utilizzata, vi associa una voce temporanea e poi la rimuove.

Esempi

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

Risultato

true
true
true

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti