Número de excepciones capturadas

Actualizado el 15 de noviembre de 2026

Sigla CAUGHT
Aspecto «Complejidad»
Se mide en método
Tipo de valor puntuación (entero, mínimo 0): un número que sirve para comparar métodos, no para sumar
Dirección informativa: ni alto ni bajo es mejor
Stau Metro NumExceptionsCaught

En pocas palabras

Cuenta cuántos tipos distintos de excepción atrapa un método con catch. Si captura el mismo tipo en tres sitios, cuenta una vez. Dice cuánta variedad de fallos prevé el método y resuelve por sí mismo.

Qué mide

La parte del tratamiento de errores que se queda dentro del método, en variedad y no en cantidad de bloques. Un método que captura cinco tipos distintos tiene más caminos de error que entender que uno que captura uno solo, aunque tenga el mismo número de catch.

Es una puntuación y no un recuento corriente: sumarla entre métodos no tiene sentido (dos métodos que capturan IOException no suman dos tipos), y por eso Stau Metro no muestra su total en los resultados, solo la media, el mínimo y el máximo.

Cómo se calcula

Se recogen los tipos de todas las cláusulas catch del método, cada uno por su nombre completo, y se cuentan los distintos. Un catch con varias alternativas (catch (A | B e)) aporta cada una de sus alternativas.

Ejemplo

void load(Path path) {
    try {
        read(path);
    } catch (FileNotFoundException e) {              // FileNotFoundException
        log(e);
    } catch (IOException | UncheckedIOException e) { // IOException, UncheckedIOException
        log(e);
    }
    try {
        close();
    } catch (IOException e) {                        // ya contado
        log(e);
    }
}

Total: 3 tipos distintos (FileNotFoundException, IOException, UncheckedIOException), aunque hay tres cláusulas catch y cuatro tipos escritos.

Cómo interpretarla

No tiene umbrales. Un valor alto puede indicar un método que mezcla demasiadas responsabilidades (lee, convierte y escribe, y se ocupa de los fallos de cada paso), o capturas muy finas que podrían agruparse en una excepción propia. Un valor 0 es normal: lo habitual es que un método deje subir las excepciones a quien sabe qué hacer con ellas. Léela junto a «las excepciones lanzadas» para ver el equilibrio entre lo que el método declara y lo que resuelve.

Relación con otras métricas

En las herramientas

Stau Metro (NumExceptionsCaught, a nivel de método). Cuenta los tipos distintos, identificados por su nombre completo, de los parámetros de todos los catch del método, cada alternativa de un catch múltiple por separado: catch (A | B e) aporta 2 si ninguno de los dos tipos se había contado ya. Los catch de lambdas y de clases anónimas o locales declaradas dentro del método se suman a él. No se calcula para los métodos abstractos. Es una puntuación: no se muestra su total en los resultados.

CK (herramienta de Aniche). Su tryCatchQty se describe como «el número de try/catches»; no distingue, según esa descripción, tipos distintos.

Referencias