CKTIS / JavaScript
Storage.getItem — leer un valor de Web Storage
Storage.getItem(key) lee texto de forma síncrona desde localStorage o sessionStorage. Devuelve null cuando la clave no existe; una cadena vacía es un valor existente, no una entrada ausente.
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.getItem(key)Storage.getItem es un método de instancia de Storage que utilizan localStorage y sessionStorage. Acepta una clave de texto y devuelve el texto almacenado, o null si la entrada no existe. La lectura es síncrona y no elimina la entrada.
Distingue entre null, "" y "null". Comprueba la ausencia con value === null, no con !value, que también coincide con una cadena vacía. Los números y objetos almacenados no recuperan automáticamente sus tipos.
Esta es una API web definida por el HTML Living Standard, no una característica de una edición concreta de ECMAScript. Los navegadores modernos la admiten ampliamente; la versión de Node del repositorio no demuestra la compatibilidad con navegadores. El propio acceso a window.localStorage o window.sessionStorage puede generar un SecurityError debido a un origen opaco o a la política del navegador.
El ejemplo distingue una cadena vacía, la cadena "42" y una entrada ausente. Elige una clave que no está en uso y elimina la entrada temporal para comprobar que la lectura devuelve null. El bloque finally repite la eliminación para limpiar la entrada incluso si se produce un error, sin borrar todo el almacenamiento.
Ejemplos
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Storage.getItem: empty and missing values</title>
</head>
<body>
<h1>Reading a storage value</h1>
<p id="source"></p>
<script>
function readValues(storage) {
let key = 'cktis:getItem';
while (storage.getItem(key) !== null) key += ':';
try {
storage.setItem(key, '');
const empty = storage.getItem(key);
storage.setItem(key, '42');
const text = storage.getItem(key);
storage.removeItem(key);
return [JSON.stringify(empty), JSON.stringify(text), storage.getItem(key) === null];
} finally {
storage.removeItem(key);
}
}
let lines;
let source = 'Using browser sessionStorage.';
try {
lines = readValues(window.sessionStorage);
} catch (error) {
if (error.name !== 'SecurityError' && error.name !== 'QuotaExceededError') throw error;
source = error.name === 'QuotaExceededError'
? 'Could not write the demo value to sessionStorage. Existing entries may still be readable. Using an in-memory fixture, not Web Storage.'
: 'Browser storage is unavailable. Using an in-memory fixture, not Web Storage.';
const entries = new Map();
lines = readValues({
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
"" "42" 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.