Número de veces invocado en código de test

Actualizado el 15 de noviembre de 2026

Sigla CALLEDt
Aspecto «Tests»
Se mide en método
Tipo de valor recuento (entero, mínimo 0; en el plugin, de tipo «score»)
Dirección informativa: ni alto ni bajo es mejor
Stau Metro NumTimesCalledTest

En pocas palabras

Cuenta cuántos sitios del código de test llaman a un método. Un método con llamadas desde los tests tiene al menos alguien que lo ejercita; uno con cero no lo toca ningún test. Es la parte de «CALLED» que viene de los tests.

Qué mide

Cuánto usan los tests un método concreto. Separa las llamadas que recibe desde los tests de las que recibe desde el código de producción, lo que permite dos preguntas:

  • ¿Qué métodos de producción no llama ningún test? Son candidatos a pruebas que faltan. Es una aproximación estática: no sabe si un test los ejecuta de forma indirecta, a través de otro método.
  • ¿Qué métodos solo se llaman desde tests? Si además «CALLEDp» es 0, el método quizá solo exista para los tests y sea código muerto en producción.

A diferencia de la «cobertura», no se mide ejecutando los tests, sino leyendo el código: cuenta llamadas escritas, no ejecutadas.

Cómo se calcula

CALLEDt(m)=#{puntos de llamada a m situados en un fichero de una raıˊz de test}CALLED_t(m) = \#\{\text{puntos de llamada a } m \text{ situados en un fichero de una raíz de test}\}

Un punto de llamada es un lugar concreto del código que nombra el método para invocarlo: una llamada m(), una referencia Clase::m o, para un constructor, un new. Dos llamadas en la misma línea son dos puntos; una llamada dentro de un bucle es uno, se ejecute las veces que se ejecute.

Ejemplo

// src/main/java
class Calc { int twice(int x) { return x * 2; }  int unused() { return 0; } }
class Report { int total(Calc c) { return c.twice(1) + c.twice(2); } }

// src/test/java
import static org.junit.jupiter.api.Assertions.assertEquals;
import org.junit.jupiter.api.Test;

class CalcTest {
    @Test void doubles() { assertEquals(4, new Calc().twice(2)); }
    @Test void other()   { new Calc().unused(); }
}
Método CALLED CALLEDp CALLEDt
Calc.twice 3 2 1
Calc.unused 1 0 1

unused solo se llama desde un test: si ese test no existiera, sería código muerto.

Cómo interpretarla

Sin valor bueno ni malo y sin umbrales. Un CALLEDt de 0 en un método importante de producción indica que ningún test lo llama directamente. Un valor positivo con CALLEDp en 0 indica un método que solo usan los tests.

Los propios métodos de test suelen tener 0: los invoca el framework por reflexión, no el código.

Relación con otras métricas

En las herramientas

Stau Metro (NumTimesCalledTest). Busca en todo el proyecto las referencias al método, descarta las de comentarios de documentación y las de import, y se queda con las que están en un fichero de una raíz de fuentes de test. También cuentan las llamadas desde ficheros Kotlin. Una referencia desde un fichero sin código (un descriptor XML) no es una llamada.

  • Las llamadas hechas a través de un método de un supertipo del proyecto al que éste sobrescribe se atribuyen al método que sobrescribe; las llamadas a métodos de bibliotecas o del JDK (Object.toString(), Runnable.run()) no. Cada punto de llamada cuenta una vez, aunque llegue al método por varios caminos de la jerarquía.
  • La búsqueda abarca el proyecto entero, no solo el ámbito analizado.
  • Un fichero que no está ni en una raíz de test ni en una de producción suma al total (CALLED) pero no a CALLEDt ni a CALLEDp; así, CALLED puede ser mayor que su suma.
  • Se publica valor para todos los métodos y constructores declarados en el código, abstractos incluidos, salvo los de clases anónimas o locales declaradas dentro de otro método.