Los errores que ya conoces
Un error en JavaScript es un objeto con tres datos principales: name (el tipo), message (qué pasó) y stack (dónde pasó). Ya te cruzaste con los tipos más comunes:
| Tipo | Cuándo aparece | Ejemplo |
|---|---|---|
SyntaxError |
El código está mal escrito; no llega a ejecutarse | console.log("hola |
ReferenceError |
Usas un nombre que no existe | console.log(nombreQueNoExiste) |
TypeError |
Usas un valor de una forma que su tipo no permite | null.x, "a".toFixed() |
RangeError |
Un número está fuera del rango permitido | new Array(-1), recursión infinita |
Cuando un error no se atrapa, el programa se detiene en esa línea y la consola lo muestra en rojo.
try, catch y finally
Para que un error no detenga el programa, envuelve el código que puede fallar en un try y decide qué hacer en el catch:
try {
const lista = null;
console.log(lista.length); // TypeError
} catch (error) {
console.log("Algo salió mal:", error.message);
console.log("Tipo:", error.name);
} finally {
console.log("Esto se ejecuta siempre");
}
console.log("El programa sigue");
try: el código que puede fallar.catch (error): se ejecuta solo si hubo un error, que llega en la variable. Si no lo necesitas, puedes omitirla:catch { … }.finally: se ejecuta siempre, con o sin error. Ideal para limpiar.
throw: lanzar tus propios errores
Con throw señalas que algo está mal en tus reglas, aunque para JavaScript sea válido:
function crearUsuario(edad) {
if (edad < 0) {
throw new RangeError("La edad no puede ser negativa");
}
return { edad };
}
try {
crearUsuario(-5);
} catch (error) {
console.log(`${error.name}: ${error.message}`);
}
Lanza siempre un objeto Error (o uno de sus tipos), nunca un texto suelto: solo el objeto guarda el stack trace que te dice dónde ocurrió.
Cuando tu aplicación crezca, vas a crear tus propios tipos de error con clases, como class ValidacionError extends Error {}, para distinguirlos en el catch. Lo verás en la sección de Clases.
Encadenar errores con cause (ES2022)
Muchas veces atrapas un error técnico y quieres lanzar uno más claro para tu programa, sin perder el original. Para eso está la opción cause:
function leerPerfil(texto) {
try {
return JSON.parse(texto);
} catch (error) {
throw new Error("No se pudo leer el perfil", { cause: error });
}
}
try {
leerPerfil("{esto no es JSON}");
} catch (error) {
console.log(error.message); // el mensaje claro
console.log(error.cause.name); // el error original: SyntaxError
}
Varios errores a la vez: AggregateError (ES2021)
AggregateError agrupa varios errores en uno solo, en su propiedad errors. Lo vas a encontrar sobre todo con Promise.any, en la sección de Asincronía, cuando fallan todas las opciones:
const error = new AggregateError(
[new Error("Servidor A caído"), new Error("Servidor B caído")],
"Ningún servidor respondió"
);
console.log(error.message);
console.log(error.errors.length);
console.log(error.errors[0].message);
¿Es un error? Error.isError (ES2026)
Para comprobar si un valor es un error se usaba valor instanceof Error, pero falla con errores que vienen de otro contexto, como un <iframe> o un worker. Error.isError(valor) (ES2026) lo comprueba de forma fiable:
const e = new TypeError("algo");
if (typeof Error.isError === "function") {
console.log(Error.isError(e)); // true
console.log(Error.isError("algo")); // false: un texto no es un error
} else {
console.log("Tu navegador todavía no tiene Error.isError");
}
Buenas prácticas
- Atrapa solo lo que puedes resolver. Si no sabes qué hacer con un error, deja que suba o vuelve a lanzarlo.
- Nunca dejes un
catchvacío: el problema sigue ahí, pero ya no te enteras. Como mínimo,console.error(error). - Usa
throwpara tus reglas (datos inválidos, estados imposibles) y deja que quien llama decida. - Lee el error completo: tipo, mensaje y la línea del stack trace. Casi siempre dicen exactamente qué pasó.
Resumen
- Un error es un objeto con
name,messageystack. Los tipos comunes sonSyntaxError,ReferenceError,TypeErroryRangeError. tryejecuta,catchatrapa el error yfinallyse ejecuta siempre.throw new Error("…")lanza tus propios errores. Lanza siempre objetosError.cause(ES2022) encadena un error nuevo con el original.AggregateError(ES2021) agrupa varios errores;Error.isError(ES2026) detecta errores de forma fiable.
¡A practicar!
Tu progreso se guarda en este navegador.
Autoevaluación: Lanzar y atrapar
Resuelto
Elige una respuesta en cada pregunta.
¿Cuándo se ejecuta el bloque
finally?¿Por qué conviene
throw new Error("…")en lugar dethrow "…"?¿Para qué sirve
new Error("…", { cause: error })(ES2022)?¿Qué tiene de malo un
catch (error) { }vacío?
Ordena la salida: El recorrido de un error
Resuelto
Sigue el camino del error y ordena lo que aparecería en la consola.
1try {2 console.log("A");3 null.x;4 console.log("B");5} catch (e) {6 console.log(e.name);7} finally {8 console.log("C");9}10console.log("D");Consola, de arriba abajo
- C
- D
- A
- TypeError
Se imprime A. Leer una propiedad de null lanza un TypeError, así que B se salta. El catch imprime el nombre del error, finally imprime C, y como el error se atrapó, el programa sigue con D.
Detective: Un JSON que no es JSON
Resuelto
Este programa intenta leer unos datos en formato JSON y se rompe. Encuentra la línea donde salta el error y elige el arreglo correcto. Cuidado: dos de las opciones son peligrosas.
Consola
Leyendo datos...
datos.js:3
const datos = JSON.parse(texto);
^
SyntaxError: Expected property name or '}' in JSON at position 1 (line 1 column 2)Paso 1: toca la línea de código que causa el error.
Paso 2: ¿cómo lo arreglas?
Laboratorio: Saldo insuficiente
Resuelto
Completa la función para que lance un Error si no hay saldo suficiente, y llámala dentro de un try/catch que muestre el mensaje.
$ node programa.js
Lo que debe cumplir
- Imprime
Saldo insuficiente(pendiente) retirar(100, 30)sigue devolviendo70(pendiente)retirar(10, 50)lanza unError(no un texto suelto) (pendiente)- Usa
tryycatch(pendiente)
Una solución
1function retirar(saldo, monto) {2 if (monto > saldo) {3 throw new Error("Saldo insuficiente");4 }5 return saldo - monto;6}7 8try {9 retirar(100, 250);10} catch (error) {11 console.log(error.message);12}La función no decide qué hacer con el problema: solo lo señala lanzando un error. Quien la llama decide cómo manejarlo. Así la misma función sirve en una web (mostrando un aviso) o en un servidor (respondiendo con un error), sin cambiar nada.