Una petición
const res = await fetch("/api/productos?categoria=te");
console.log(res.status); // 200
console.log(res.ok); // true si el estado está entre 200 y 299
console.log(res.headers.get("content-type")); // application/json
const productos = await res.json(); // el cuerpo, ya convertido
Hay dos esperas: fetch se cumple cuando llegan el estado y los encabezados, y res.json() cuando termina de llegar el cuerpo. El cuerpo se lee una sola vez, con el método que corresponda: json(), text(), blob(), arrayBuffer() o formData().
Un 404 no es un error
La promesa de fetch solo se rechaza si no hay respuesta: sin conexión, CORS bloqueado, petición cancelada. Un 404 o un 500 son respuestas, y la promesa se cumple. Hay que mirar res.ok:
async function obtenerJSON(url, opciones) {
const res = await fetch(url, opciones);
if (!res.ok) throw new Error(`HTTP ${res.status} en ${url}`);
return res.json();
}
try {
const producto = await obtenerJSON("/api/productos/7");
mostrar(producto);
} catch (e) {
mostrarError(e.message); // red caída o error HTTP: el mismo camino
}
Esta pequeña función es la que casi todo proyecto termina escribiendo.
Enviar datos
// JSON
await fetch("/api/comentarios", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ texto: "¡Gran artículo!", articulo: 42 }),
});
// Un formulario entero, incluidos archivos
await fetch("/api/perfil", {
method: "PUT",
body: new FormData(document.querySelector("#perfil")),
});
Los métodos más usados: GET (leer, el de por defecto), POST (crear), PUT/PATCH (modificar) y DELETE (borrar).
Request y Response
fetch trabaja con dos objetos que también puedes crear tú, por ejemplo en pruebas o en un Service Worker:
const res = new Response(JSON.stringify({ ok: true }), {
status: 201,
headers: { "Content-Type": "application/json" },
});
console.log(res.status, res.ok, res.statusText === "");
console.log(await res.json());
const peticion = new Request("https://api.ejemplo.com/datos", { method: "POST", body: "hola" });
console.log(peticion.method, new URL(peticion.url).hostname);
CORS
Por seguridad, una página solo puede leer las respuestas de su propio origen. Para leer las de otro, ese servidor tiene que permitirlo con encabezados como Access-Control-Allow-Origin. Eso es CORS. Si falla, verás en la consola un error que menciona CORS, y fetch se rechaza.
No se arregla desde el navegador: lo decide el servidor. Las soluciones son configurar el servidor (si es tuyo), usar una API que permita tu origen, o pasar la petición por tu propio servidor.
Cancelar y leer por partes
fetch acepta una señal, como viste en Cancelar con AbortController:
const res = await fetch("/api/informe", { signal: AbortSignal.timeout(5000) });
Y el cuerpo es un stream: puedes procesarlo a medida que llega, por ejemplo para mostrar el progreso de una descarga o las respuestas de un modelo de lenguaje que llegan palabra por palabra:
const res = await fetch("/api/respuesta-larga");
const lector = res.body.pipeThrough(new TextDecoderStream()).getReader();
while (true) {
const { value, done } = await lector.read();
if (done) break;
mostrarParte(value);
}
Resumen
await fetch(url)da la respuesta;await res.json()(otext,blob…), el cuerpo, una sola vez.fetchno se rechaza con un 404 o un 500: compruebares.ok.- Para enviar:
method,headersybody(JSON.stringifyo unFormData). - CORS lo decide el servidor: el navegador solo lo aplica.
signalpara cancelar;res.bodyes un stream que se lee por partes.
¡A practicar!
Tu progreso se guarda en este navegador.
Autoevaluación: Pedir y recibir
Resuelto
Elige una respuesta en cada pregunta.
Si el servidor responde con un error 404, ¿qué hace la promesa de
fetch?¿Por qué
res.json()devuelve una promesa?¿Cómo se envían datos JSON con
fetch?¿Qué es CORS?
Ordena la salida: Una respuesta por dentro
Resuelto
Una respuesta creada a mano, leída por partes. Ordena lo que aparecería en la consola.
1const r = new Response('{"ok":true}', {2 status: 201,3 headers: { "Content-Type": "application/json" },4});5 6console.log(r.status, r.ok);7console.log(r.headers.get("content-type"));8console.log((await r.json()).ok);9console.log(r.bodyUsed ? "cuerpo ya leído" : "sin leer");Consola, de arriba abajo
- true
- 201 true
- cuerpo ya leído
- application/json
ok es true para cualquier estado entre 200 y 299. Los encabezados no distinguen mayúsculas. Y el cuerpo se puede leer una sola vez: después de json(), bodyUsed es true.
Detective: Un 404 que pasa desapercibido
Resuelto
Se pidió un producto que no existe, y el error aparece donde no se lo espera. Encuentra la línea que falta revisar y elige el arreglo.
Consola
Uncaught TypeError: Cannot read properties of undefined (reading 'toUpperCase')
at producto.js:4:29Paso 1: toca la línea de código que causa el error.
Paso 2: ¿cómo lo arreglas?
Laboratorio: Cargar un usuario
Resuelto
Escribe cargarUsuario(id) con fetch, tratando los errores HTTP. La página trae un servidor simulado.
La página index.html
Consola del navegador
Lo que debe cumplir
- La página muestra
Hola, Ana(pendiente) - Devuelve el usuario pedido (pendiente)
- Con un usuario que no existe, lanza
HTTP 404(pendiente)
Una solución
1async function cargarUsuario(id) {2 const res = await fetch(`/api/usuarios/${id}`);3 if (!res.ok) throw new Error(`HTTP ${res.status}`);4 return res.json();5}6 7const usuario = await cargarUsuario(1);8document.querySelector("#estado").textContent = `Hola, ${usuario.nombre}`;Es el envoltorio que casi todo proyecto termina escribiendo alrededor de fetch: comprobar res.ok y convertir los errores HTTP en excepciones. Así, quien llama solo necesita un try/catch, igual para un 404 que para una red caída.