JavaScript Tema 12
Asíncrono: promesas y fetch
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.
Muchas cosas no son instantáneas: pedir datos a un servidor puede tardar un segundo, o no llegar nunca. JavaScript no se queda parado esperando —la página se congelaría—: sigue con lo demás y atiende la respuesta cuando llega. Eso es la programación asíncrona.
Síncrono y asíncrono#
Ya lo viste con setTimeout en Objetos del navegador:
console.log("1. Pido los datos");
setTimeout(() => console.log("3. Llegan los datos"), 1000);
console.log("2. Mientras, sigo con lo mío");El orden en que se escriben no es el orden en que pasan: lo asíncrono se ejecuta después, cuando está listo.
Promesas#
Una promesa (Promise) es un objeto que representa un resultado que llegará más tarde. Está en uno de tres estados:
| Estado | Quiere decir |
|---|---|
| Pendiente | Todavía no ha terminado |
| Cumplida | Ha terminado bien, y tiene su resultado |
| Rechazada | Ha fallado, y tiene el error |
Con .then() se dice qué hacer cuando se cumpla, y con .catch(), si falla:
function tirarDado() {
return new Promise((cumplir, rechazar) => {
setTimeout(() => {
const numero = Math.floor(Math.random() * 6) + 1;
if (numero === 1) rechazar(new Error("Ha salido un 1: pierdes"));
else cumplir(numero);
}, 500);
});
}
tirarDado()
.then((n) => console.log(`Ha salido un ${n}`))
.catch((error) => console.log(error.message));Pulsa Pruébalo varias veces: a veces se cumple y a veces se rechaza.
async y await#
Encadenar .then() se lee mal en cuanto hay varios pasos. await espera a que se cumpla una promesa y da su resultado, como si fuera normal. Solo se puede usar dentro de una función marcada como async, y los errores se atienden con try … catch:
function esperar(ms) {
return new Promise((cumplir) => setTimeout(cumplir, ms));
}
async function prepararDesayuno() {
console.log("Pongo el café");
await esperar(1000);
console.log("El café está listo");
await esperar(500);
console.log("Las tostadas están listas");
return "Desayuno servido";
}
prepararDesayuno().then((mensaje) => console.log(mensaje));
console.log("Mientras, leo el periódico");fetch: pedir datos a un servidor#
fetch(dirección) pide algo a un servidor y devuelve una promesa. Lo que se pide normalmente es JSON, a una API: una dirección que, en vez de una página, devuelve datos.
<h1>Usuarios</h1>
<button id="cargar">Cargar usuarios</button>
<p id="estado"></p>
<ul id="usuarios"></ul>const boton = document.querySelector("#cargar");
const estado = document.querySelector("#estado");
const lista = document.querySelector("#usuarios");
async function cargarUsuarios() {
estado.textContent = "Cargando…";
try {
const respuesta = await fetch("https://jsonplaceholder.typicode.com/users");
if (!respuesta.ok) throw new Error(`El servidor ha respondido ${respuesta.status}`);
const usuarios = await respuesta.json();
lista.textContent = "";
for (const u of usuarios) {
const li = document.createElement("li");
li.textContent = `${u.name} (${u.email})`;
lista.append(li);
}
estado.textContent = `${usuarios.length} usuarios`;
} catch (error) {
estado.textContent = `No se han podido cargar: ${error.message}`;
}
}
boton.addEventListener("click", cargarUsuarios);Los pasos son siempre los mismos:
| Paso | Código | Qué hace |
|---|---|---|
| 1. Pedir | await fetch(dirección) | Manda la petición y espera la respuesta |
| 2. Comprobar | respuesta.ok | true si el servidor dice que todo bien (código 200–299); false con un 404, un 500… |
| 3. Leer | await respuesta.json() | Lee el cuerpo y lo convierte de JSON a objetos |
| 4. Pintar | El DOM | Como en el tema del DOM |
| Si falla | catch | Sin red, servidor caído o JSON roto: hay que decírselo al usuario |
Nota
JSONPlaceholder es una API de prueba, con datos inventados, pensada para practicar. Hay muchas APIs abiertas: el tiempo, los Pokémon, los países… Un navegador solo deja leer los datos de otra web si esa web lo permite (se llama CORS): las APIs públicas lo permiten.
Mandar datos#
fetch también envía: con un segundo dato que dice el método y lo que se manda, en JSON:
async function crearPublicacion() {
try {
const respuesta = await fetch("https://jsonplaceholder.typicode.com/posts", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ title: "Hola", body: "Mi primera publicación", userId: 1 }),
});
const creada = await respuesta.json();
console.log("El servidor la ha guardado con el id", creada.id);
} catch (error) {
console.log("No se ha podido enviar:", error.message);
}
}
crearPublicacion();| Método | Para |
|---|---|
GET (el de siempre) | Leer |
POST | Crear algo nuevo |
PUT / PATCH | Cambiar algo |
DELETE | Borrar |
Errores frecuentes#
| Mensaje o síntoma | Qué significa | Cómo se arregla |
|---|---|---|
Sale Promise { <pending> } en vez de los datos | Falta el await | const datos = await respuesta.json(); |
SyntaxError: await is only valid in async functions | await fuera de una función async | Marca la función con async |
Failed to fetch | Sin red, la dirección está mal, o el servidor no permite que otras webs lean sus datos (CORS) | Comprueba la dirección en el navegador; usa una API que lo permita |
Unexpected token '<' … is not valid JSON | La dirección devuelve una página HTML (un error 404), no JSON | Comprueba respuesta.ok antes de leer, y la dirección |
El código de después del fetch usa los datos y están vacíos | Se ejecuta antes de que lleguen | Lo que usa los datos, después del await (o dentro del .then) |