Vericode
Entrar

JavaScript Tema 11

Almacenamiento y JSON

Funciona en el IDE online de web. Todo lo de esta sección funciona en el IDE online de web: pulsa Pruébalo en cualquier ejemplo y verás la página al lado del código, con la consola debajo. Sin instalar nada.

Al recargar la página, las variables se pierden: la lista de tareas que hiciste en el tema de eventos desaparece. El navegador tiene sitios donde guardar datos para que sigan ahí, y JSON es el formato en que se guardan y se intercambian.

JSON#

JSON (JavaScript Object Notation) es una forma de escribir datos como texto, con la misma pinta que los objetos y arrays de JavaScript. Es el formato en que se hablan casi todas las aplicaciones web:

Salida
{
    "nombre": "Ana",
    "edad": 17,
    "ciclos": ["DAM", "DAW"],
    "beca": false,
    "tutor": null
}

Se parece a un objeto de JavaScript, con unas reglas más estrictas: los nombres, siempre entre comillas dobles; los textos, también con dobles; sin comas al final, sin comentarios y sin funciones.

De JavaScript a JSONDe JSON a JavaScript
JSON.stringify(objeto)JSON.parse(texto)
JavaScript
const alumno = { nombre: "Ana", edad: 17, ciclos: ["DAM", "DAW"] };

const texto = JSON.stringify(alumno);
console.log(texto);              // {"nombre":"Ana","edad":17,"ciclos":["DAM","DAW"]}
console.log(typeof texto);       // "string"

const deVuelta = JSON.parse(texto);
console.log(deVuelta.ciclos[1]); // "DAW"

console.log(JSON.stringify(alumno, null, 2));   // con sangría, para leerlo

localStorage#

localStorage guarda textos con un nombre en el navegador, y siguen ahí aunque se cierre: hasta que la página los borre o el usuario borre los datos del navegador.

JavaScript
localStorage.setItem("nombre", "Ana");
console.log(localStorage.getItem("nombre"));   // "Ana"
console.log(localStorage.getItem("nada"));     // null: no existe
localStorage.removeItem("nombre");
MétodoHace
setItem(clave, texto)Guarda
getItem(clave)Lee; null si no existe
removeItem(clave)Borra uno
clear()Borra todos los de esta web

Solo guarda texto. Para guardar un array o un objeto, se pasa a JSON al guardar, y de JSON al leer:

JavaScript
const tareas = ["Estudiar", "Hacer la cena"];
localStorage.setItem("tareas", JSON.stringify(tareas));

const leidas = JSON.parse(localStorage.getItem("tareas")) ?? [];
console.log(leidas);

El ?? [] da un array vacío si no había nada guardado (JSON.parse(null) da null).

Un contador que no se olvida#

HTML
<p>Has visitado esta página <strong id="visitas">0</strong> veces.</p>
<button id="borrar">Empezar de cero</button>
JavaScript
const visitas = Number(localStorage.getItem("visitas") ?? 0) + 1;
localStorage.setItem("visitas", visitas);
document.querySelector("#visitas").textContent = visitas;

document.querySelector("#borrar").addEventListener("click", () => {
    localStorage.removeItem("visitas");
    document.querySelector("#visitas").textContent = 0;
});

Recarga la página (en el IDE online, con el botón de recargar de la página) y el número sube.

sessionStorage y las cookies#

DuraPara
localStorageHasta que se borrePreferencias, el tema oscuro, un borrador
sessionStorageHasta que se cierra la pestañaDatos de un solo uso: el paso de un formulario largo
CookiesLo que diga la cookieLo que tiene que saber también el servidor: viajan con cada petición. Se usan para la sesión

sessionStorage tiene los mismos métodos que localStorage. Las cookies se leen y escriben con document.cookie, de una forma bastante más incómoda: al escribir se pone una cookie, con su caducidad, y al leer salen todas juntas en un texto:

JavaScript
document.cookie = "tema=oscuro; max-age=3600";     // dura una hora
document.cookie = "idioma=es; max-age=31536000";   // un año
console.log(document.cookie);                       // "tema=oscuro; idioma=es"

document.cookie = "tema=; max-age=0";               // borrarla: que caduque ya
console.log(document.cookie);                       // "idioma=es"

function leerCookie(nombre) {
    const par = document.cookie.split("; ").find((c) => c.startsWith(nombre + "="));
    return par ? par.split("=")[1] : null;
}
console.log(leerCookie("idioma"));                  // "es"

Hoy se usan sobre todo desde el servidor, para la sesión; para guardar datos en el navegador, localStorage es más cómodo.

Nota

En el IDE online la página va aislada, por seguridad: no puede leer nada de Vericode. Tiene un localStorage y unas cookies propios, que el IDE guarda en tu navegador, y un sessionStorage que dura hasta que se recarga. En tu ordenador, con Live Server, funciona todo de verdad.

Atención

Lo que se guarda en el navegador lo puede leer y cambiar el usuario (F12 → Aplicación). Nunca guardes ahí contraseñas, ni te fíes de lo que haya.

Errores frecuentes#

Mensaje o síntomaQué significaCómo se arregla
Al leer sale [object Object]Se ha guardado un objeto sin pasarlo a JSONsetItem("x", JSON.stringify(objeto))
Uncaught SyntaxError: Unexpected token … in JSONJSON.parse recibe algo que no es JSONComprueba qué se guardó; en JSON, comillas dobles y sin comas al final
El número leído se junta en vez de sumarsegetItem devuelve textoNumber(localStorage.getItem("visitas"))
JSON.parse(...) da null y luego fallaNo había nada guardadoDa un valor por defecto: ?? []