Vericode
Entrar

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:

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

EstadoQuiere decir
PendienteTodavía no ha terminado
CumplidaHa terminado bien, y tiene su resultado
RechazadaHa fallado, y tiene el error

Con .then() se dice qué hacer cuando se cumpla, y con .catch(), si falla:

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

JavaScript
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.

HTML
<h1>Usuarios</h1>
<button id="cargar">Cargar usuarios</button>
<p id="estado"></p>
<ul id="usuarios"></ul>
JavaScript
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:

PasoCódigoQué hace
1. Pedirawait fetch(dirección)Manda la petición y espera la respuesta
2. Comprobarrespuesta.oktrue si el servidor dice que todo bien (código 200–299); false con un 404, un 500…
3. Leerawait respuesta.json()Lee el cuerpo y lo convierte de JSON a objetos
4. PintarEl DOMComo en el tema del DOM
Si fallacatchSin 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:

JavaScript
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étodoPara
GET (el de siempre)Leer
POSTCrear algo nuevo
PUT / PATCHCambiar algo
DELETEBorrar

Errores frecuentes#

Mensaje o síntomaQué significaCómo se arregla
Sale Promise { <pending> } en vez de los datosFalta el awaitconst datos = await respuesta.json();
SyntaxError: await is only valid in async functionsawait fuera de una función asyncMarca la función con async
Failed to fetchSin 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 JSONLa dirección devuelve una página HTML (un error 404), no JSONComprueba respuesta.ok antes de leer, y la dirección
El código de después del fetch usa los datos y están vacíosSe ejecuta antes de que lleguenLo que usa los datos, después del await (o dentro del .then)