Número de casos de test JUnit

Actualizado el 15 de noviembre de 2026

Sigla JTC (JTC(rec) en la variante recursiva del paquete)
Aspecto «Tests»
Se mide en paquete, módulo, proyecto
Tipo de valor recuento (entero, mínimo 0)
Dirección informativa: ni alto ni bajo es mejor
Stau Metro NumTestCasesPackage, NumTestCasesRecursivePackage, NumTestCasesModule, NumTestCasesProject

En pocas palabras

Cuenta las clases que el framework de tests reconocería como clases de test. Se parece al número de ficheros de tests del proyecto, pero contado por lo que contienen las clases y no por dónde están.

Ojo. Aquí «caso de test» es la clase, siguiendo el nombre TestCase de JUnit 3. En la terminología general de pruebas, un caso de test es un escenario concreto con sus entradas y resultados esperados, que se parece más a un método de test: ese recuento es el «JTM».

Qué mide

Cuántas unidades de agrupación de tests tiene el código. Sirve para ver la estructura de la suite (muchas clases pequeñas o pocas grandes) cuando se combina con el «número de métodos de test», y para detectar qué parte del código de test no son clases de test: comparado con el «número de clases de test» (Ct), la diferencia son clases auxiliares, fixtures y bases.

Cómo se calcula

JTC=#{clases que el framework de tests reconoce como clases de test}JTC = \#\{\text{clases que el framework de tests reconoce como clases de test}\}

Qué es una clase de test lo decide cada framework. En JUnit 3, una subclase de junit.framework.TestCase. JUnit 5 define una clase de test como «cualquier clase de nivel superior, miembro estático o clase @Nested que contiene al menos un método de test», y añade que no puede ser abstracta.

Ejemplo

import org.junit.jupiter.api.Test;

abstract class Base { @Test void a() { } }   // tiene un método de test, pero es abstracta
class T extends Base { }                     // hereda el método de test de Base
class Plain { void a() { } }                 // no tiene tests

Con la definición de JUnit 5, solo T es una clase de test: Base es abstracta y JUnit no la ejecuta por sí sola. JTC = 1. Stau Metro, que no mira si la clase es abstracta, da JTC = 2 (Base y T).

Cómo interpretarla

Sin valor bueno ni malo y sin umbrales. Un 0 en un módulo con código de producción importante merece atención. Un JTC mucho menor que Ct indica que el código de test tiene muchas clases que no son tests, lo que puede ser normal (utilidades, datos de prueba) o reflejar que un framework no se reconoce.

Relación con otras métricas

En las herramientas

Stau Metro (NumTestCasesPackage, NumTestCasesRecursivePackage, NumTestCasesModule, NumTestCasesProject). Una clase cuenta si entre todos sus métodos, propios o heredados, hay alguno anotado con una de las anotaciones de test de JUnit 4, JUnit 5 o TestNG (las de «JTM»), o si es subclase de junit.framework.TestCase.

  • Se recorren todas las clases del ámbito, no solo las de raíces de test: una clase de producción con un método @Test también cuenta.
  • Cuentan las clases abstractas con tests (como Base en el ejemplo), las anidadas y las que solo heredan sus tests. El código no mira si la clase es abstracta, a diferencia de la definición de JUnit 5.
  • Las clases anónimas y locales se recorren como cualquier otra; una subclase anónima de una clase con tests hereda sus métodos y también cuenta. Lo mismo vale para una interfaz con un método default anotado con @Test.
  • La anotación se busca solo tal cual en el método: una anotación propia meta-anotada con @Test no se reconoce.
  • Solo Java. Un paquete o un módulo sin clases Java no tiene fila; el proyecto siempre tiene valor.

Referencias