CKTIS / JavaScript
Storage.removeItem — eliminar una entrada
El método removeItem(key) elimina un par clave-valor concreto de localStorage o sessionStorage. Devuelve undefined; si la clave no existe, no se produce ningún error.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
storage.removeItem(key)Storage.removeItem es un método síncrono de Web Storage definido por el HTML Standard, no por ECMAScript. Llámalo en localStorage o sessionStorage y pasa la clave como una cadena. Todos los principales motores de navegador admiten este método, pero no todos los motores implementan Web Storage. Que Node 24 esté presente en un repositorio no demuestra que los navegadores admitan el método.
removeItem(key) elimina únicamente la entrada indicada y devuelve undefined, incluso si la clave no existe. Después de eliminarla, getItem(key) devuelve null. En cambio, clear() elimina todas las entradas del área de almacenamiento seleccionada.
Una eliminación efectiva encola un evento storage para los demás documentos que comparten el área de almacenamiento, pero no para la ventana que realiza la operación; newValue es null. Si la clave no existe, no se genera ningún evento.
El acceso a window.localStorage o window.sessionStorage puede lanzar una excepción SecurityError, por ejemplo, debido a una política del navegador. El ejemplo intenta usar primero window.sessionStorage. Si el intento provoca una excepción SecurityError o QuotaExceededError, usa un objeto de prueba que guarda los datos en memoria mediante un Map, en lugar de usar Web Storage. En ambos casos, el ejemplo elige una clave sin usar, guarda una entrada temporal con esa clave y luego la elimina.
Ejemplos
<!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>Resultado
true true true
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.