Las promesas llegaron con ES6 para resolver uno de los problemas más frustrantes del desarrollo asíncrono en JavaScript: el callback hell. Ese código anidado, ilegible y difícil de mantener queda atrás cuando comprendes cómo funcionan las promesas, sus estados y la forma correcta de consumirlas.
¿Qué es una promesa y por qué cambia todo?
Una promesa es un objeto que representa el resultado eventual de una operación asíncrona [0:08]. No es el resultado en sí, sino la garantía de que ese resultado va a llegar o de que algo va a fallar. Una analogía útil: cuando pides comida a domicilio, la app te entrega un número de seguimiento. Ese número no es la comida, es la promesa de que te va a llegar.
Para crear una promesa se utiliza la palabra clave new Promise, que recibe dos argumentos: resolve y reject [0:45].
Al ejecutar console.log(miPromesa) de forma inmediata, el resultado muestra una promesa en estado pending [1:10]. Esto sucede porque el setTimeout aún no ha terminado y la promesa todavía no se ha resuelto ni rechazado.
¿Cuáles son los tres estados de una promesa?
Toda promesa solo puede existir en uno de tres estados y solo transiciona en una dirección [1:18]:
Pending: estado inicial, la operación aún no terminó.
Fulfilled: la promesa se resolvió con éxito mediante resolve.
Rejected: la promesa falló y se ejecutó reject.
Una vez que una promesa pasa a fulfilled o rejected, no puede cambiar de estado. Es inmutable [1:40]. Esta es una diferencia fundamental con los callbacks, donde nada impide llamar al callback dos veces.
Cuando hayError es true, se ejecuta .catch() e imprime "Algo salió mal" [2:40].
Cuando hayError es false, se ejecuta .then() e imprime "Hola, María" [2:50].
¿Cómo se aplican las promesas en una API real?
Un caso práctico es consumir una API con fetch, que retorna una promesa de forma nativa [3:00].
javascript
fetch('https://api-colombia.com/api/v1/Department')
.then((respuesta) => respuesta.json())
.then((departamentos) => {
console.log(departamentos[0].name);
departamentos.forEach((dep) => {
console.log(${dep.name} - Población: ${dep.population});
});
})
.catch((error) => console.log('Error consultando la API de Colombia', error));
El primer .then() convierte la respuesta a JSON. El segundo .then() accede a los datos y recorre cada departamento imprimiendo su nombre y población [3:20]. El resultado muestra que el primer departamento es Arauca, seguido de todos los demás con su respectiva población.
¿Qué ocurre cuando un error no se maneja correctamente?
Si se intenta acceder a un índice inexistente, como departamentos[35], se obtiene un TypeError porque no se pueden leer propiedades de undefined [3:55]. El bloque .catch() captura ese error y lo muestra con el mensaje personalizado.
Entender que una promesa nace en pending y termina en fulfilled o rejected sin posibilidad de retroceder es la base para trabajar con código asíncrono limpio y predecible. ¿Ya has tenido problemas con promesas encadenadas? Comparte tu experiencia en los comentarios.
