CKTIS / JavaScript
Storage.setItem — guardar y reemplazar un valor
Storage.setItem guarda texto bajo una clave en localStorage o sessionStorage y reemplaza el valor anterior. La escritura puede fallar, así que hay que tener en cuenta las excepciones y las restricciones de acceso al almacenamiento.
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.setItem(key, value)Llama a Storage.setItem sobre un objeto localStorage o sessionStorage: storage.setItem(key, value). El método crea una entrada o reemplaza el valor de una clave existente y devuelve undefined. Esta API pertenece al estándar HTML, no a una edición concreta de ECMAScript. Los motores de navegador modernos la admiten; que Node 24 esté presente en un repositorio no demuestra que una API del navegador esté disponible.
Las claves y los valores se convierten en cadenas. Para guardar un objeto, serialízalo explícitamente como una cadena. Al leer el valor guardado, el almacenamiento devuelve una cadena que la aplicación debe decodificar según el formato utilizado al escribirla. Si escribes JSON con JSON.stringify, usa JSON.parse para decodificar esa cadena. localStorage conserva datos de un origen entre sesiones, mientras que sessionStorage también se separa por contexto de navegación de nivel superior, normalmente una pestaña. Los datos se pueden eliminar.
Una escritura fallida puede lanzar QuotaExceededError; el propio acceso al almacenamiento puede lanzar SecurityError. Usa try/catch tanto para el acceso como para la escritura si la aplicación debe funcionar sin almacenamiento. Escribir el mismo texto no cambia nada. La notificación storage se dirige a otros documentos que puedan recibirla, no a la ventana que realiza la escritura.
Ejemplos
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Storage.setItem: writing and replacing text</title>
</head>
<body>
<h1>Replacing a storage value</h1>
<p id="source"></p>
<script>
function writeValues(storage) {
let key = 'cktis:setItem';
while (storage.getItem(key) !== null) key += ':';
try {
storage.setItem(key, 'first');
const before = storage.getItem(key);
storage.setItem(key, 'second');
return [before, storage.getItem(key)];
} finally {
storage.removeItem(key);
}
}
let lines;
let source = 'Using browser sessionStorage.';
try {
lines = writeValues(window.sessionStorage);
} catch (error) {
if (error.name !== 'SecurityError' && error.name !== 'QuotaExceededError') throw error;
source = 'Browser storage is unavailable. Using an in-memory fixture, not Web Storage.';
const entries = new Map();
lines = writeValues({
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
first second
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.