Saltar al contenido
JavaScript en el navegador

fetch y HTTP

Lección 7 de 1413 min4 ejercicios

Casi toda página moderna habla con un servidor: carga productos, envía un comentario, guarda una preferencia. fetch es la forma estándar de hacer esas peticiones HTTP desde JavaScript, en el navegador y también en Node.js, Deno y Bun. Es simple de usar, pero tiene un par de detalles que confunden a todo el mundo la primera vez.

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() (o text, blob…), el cuerpo, una sola vez.
  • fetch no se rechaza con un 404 o un 500: comprueba res.ok.
  • Para enviar: method, headers y body (JSON.stringify o un FormData).
  • CORS lo decide el servidor: el navegador solo lo aplica.
  • signal para cancelar; res.body es un stream que se lee por partes.

¡A practicar!

Tu progreso se guarda en este navegador.

Autoevaluación: Pedir y recibir

Elige una respuesta en cada pregunta.

  1. Si el servidor responde con un error 404, ¿qué hace la promesa de fetch?

  2. ¿Por qué res.json() devuelve una promesa?

  3. ¿Cómo se envían datos JSON con fetch?

  4. ¿Qué es CORS?

Ordena la salida: Una respuesta por dentro

Una respuesta creada a mano, leída por partes. Ordena lo que aparecería en la consola.

const r = new Response('{"ok":true}', {  status: 201,  headers: { "Content-Type": "application/json" },}); console.log(r.status, r.ok);console.log(r.headers.get("content-type"));console.log((await r.json()).ok);console.log(r.bodyUsed ? "cuerpo ya leído" : "sin leer");

Consola, de arriba abajo

  1. true
  2. 201 true
  3. cuerpo ya leído
  4. application/json

Detective: Un 404 que pasa desapercibido

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:29

Paso 1: toca la línea de código que causa el error.

Laboratorio: Cargar un usuario

Escribe cargarUsuario(id) con fetch, tratando los errores HTTP. La página trae un servidor simulado.

app.jsse ejecuta mientras escribes

La página index.html

Consola del navegador

(escribe tu código: se ejecuta solo)

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)

    domina-js · JavaScript en español, gratis y paso a paso.