CKTIS / JavaScript
Gestión de errores y excepciones
La gestión de errores permite responder a las excepciones sin mezclarlas con el resultado normal de una función. Aprende throw, try, catch y finally, y distingue las excepciones síncronas de los rechazos de Promise.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
throw new Error(message);
try {
operation();
} catch (error) {
handle(error);
} finally {
cleanup();
}Una excepción interrumpe la ruta de ejecución actual. throw puede lanzar cualquier valor, pero utiliza objetos Error o sus subtipos: tienen las propiedades name y message. TypeError describe un tipo inadecuado o una operación no válida, mientras que RangeError describe un valor fuera del rango permitido. new Error(message) solo crea un objeto; no lanza una excepción.
try rodea operaciones que pueden lanzar una excepción; catch (error) recibe el valor lanzado, también si procede de una función llamada de forma síncrona. La ejecución no continúa en la instrucción interrumpida. Gestiona solo los errores a los que puedas responder de forma útil; vuelve a lanzar los demás con throw error. Un error de sintaxis que impide analizar el mismo script no puede ser capturado por el catch de ese script.
finally se ejecuta cuando el control sale de try o catch, incluso mediante return o una excepción. Úsalo para la limpieza. Evita incluir return y throw, porque pueden sustituir un resultado o una excepción anteriores. Una instrucción try requiere catch, finally o ambos.
Un try síncrono no captura un rechazo posterior de Promise solo porque la promesa se haya creado dentro de su bloque. Usa await en un try dentro de una función async, o añade .catch(handler). El ejemplo usa mecanismos básicos de excepciones disponibles desde ECMAScript 3; Promise procede de ECMAScript 2015 y async/await, de ECMAScript 2017. No requiere Web APIs, aparte de console.log, proporcionado por el entorno; una versión de Node.js por sí sola no demuestra la compatibilidad con navegadores.
Ejemplos
function requirePositive(value) {
if (!(value > 0)) {
throw new RangeError("value must be positive");
}
return value;
}
try {
console.log(requirePositive(-1));
} catch (error) {
if (!(error instanceof RangeError)) {
throw error;
}
console.log(error.name + ": " + error.message);
} finally {
console.log("finished");
}Resultado
RangeError: value must be positive finished
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.