Número de sentencias assert

Actualizado el 15 de noviembre de 2026

Sigla ASSERT
Aspecto «Complejidad»
Se mide en método
Tipo de valor recuento (entero, mínimo 0)
Dirección informativa: ni alto ni bajo es mejor
Stau Metro NumAsserts

En pocas palabras

Cuenta las sentencias assert que hay dentro de un método. Un assert es una comprobación que el programador deja escrita para afirmar algo que cree cierto en ese punto («esta lista no está vacía»). Un valor alto indica un método que documenta y vigila muchas de sus suposiciones.

Qué mide

El grado en que un método se apoya en la sentencia assert del lenguaje para comprobar sus precondiciones, sus invariantes o sus resultados intermedios. No dice nada sobre la calidad del método: un método sin ningún assert no es peor por ello.

Ojo. La especificación del lenguaje deja a la plataforma decidir si las aserciones están activas, y el lanzador java las desactiva por defecto: solo se ejecutan si se arranca con -ea. Además, assert no tiene nada que ver con las aserciones de los tests (assertEquals y similares), que cuenta «el número de aserciones de test JUnit».

Cómo se calcula

Se cuenta 1 por cada sentencia assert del cuerpo del método, tenga o no mensaje. La sentencia se define en la especificación del lenguaje (JLS, sección 14.10, The assert Statement).

Cómo interpretarla

No tiene umbrales. Úsala para localizar qué métodos y qué módulos aplican la programación por contrato con assert, y compárala con el tamaño del método («sentencias»): cuatro assert en un método de cuarenta líneas no significan lo mismo que cuatro en uno de seis.

Relación con otras métricas

En las herramientas

Stau Metro (NumAsserts, a nivel de método). Cuenta las sentencias assert del cuerpo del método, incluidas las que estén dentro de lambdas y de clases anónimas o locales declaradas en él, que se suman al método que las contiene. No se calcula para los métodos abstractos ni para los de una interfaz que no sean default, static o private. Los constructores cuentan como métodos. Se mide también el código de test. Las sentencias assert de un inicializador estático o de un inicializador de campo no pertenecen a ningún método y no se cuentan.

Referencias