Saltar al contenido principal

Arnés de pruebas — las lecciones dejan de ser prosa y pasan a ser código

· 3 min de lectura
Yovany Suárez Silva
Software Engineer - FullStack Developer

Al escribir las nueve suites del módulo de veterinaria quedaron siete lecciones apuntadas en los changelogs. Este ajuste las convierte en código compartido y aplicado: un solo módulo de utilidades, un helper por lección, las suites de tour migradas y una suite que verifica el propio arnés.

1. Un helper por lección​

ccf-almacen-web/src/test-utils/radix.ts es ahora la fuente única. Su cabecera enumera las siete reglas y cada una tiene su utilidad:

LecciónUtilidad
FocusScope de Radix entre diálogo y Select desborda la pila en jsdomanularFocoProgramatico()
Radix activa la pestaña en mouseDown y desmonta el contenido inactivoabrirPestana()
Abrir un Select y elegir opción del portalcombo() / elegirEnCombo()
Acceso a formularios y anclajes data-tourcampo() / elementosConAncla()
Textos y cabeceras duplicados entre bloques y tablaselementoConAncla() + within(...)
El aviso se publica una microtarea después del await del APIesperarToast()
Los helpers no pueden vivir bajo __tests__/El módulo está en src/test-utils/

getByText (solo nodos de texto directos) y los nombres accesibles repetidos (anclar la expresión, /^Luna/) no se resuelven con una función, así que quedan escritos como regla en la cabecera del módulo.

2. Aplicado en el trabajo existente​

  • elementoConAncla sustituye a los tres kpi()/tarjeta() escritos a mano (cartera, calificaciones y tablero).
  • esperarToast reemplaza las aserciones que podían ver cero llamadas por llegar antes que el aviso: cartera (abono y cobro de servicio), documentos (envío y reintentos), personal (alta, edición, contraseña y baja) y calificaciones (publicar y retirar la respuesta).
  • abrirPestana reemplaza las cuatro copias locales del gesto de pestaña: las tres suites de tour (cartera, catálogo, sanidad) y la de pacientes, que lo hacía en línea.

3. El arnés tiene su propia suite​

ccf-almacen-web/src/components/__tests__/test-utils-radix.test.tsx (7 casos) ejercita las utilidades con los componentes reales:

  • un diálogo con Select dentro (el caso que desbordaba la pila) se abre y se elige una opción;
  • una pestaña cambia y desmonta la anterior;
  • elementoConAncla devuelve el primer nodo y falla nombrando el ancla ausente;
  • esperarToast aguarda el aviso de la microtarea siguiente y acepta expresión regular.

Si Radix cambia de comportamiento o alguien toca el módulo, falla aquí una vez, no en las nueve pantallas.

Cómo verificarlo​

cd ccf-almacen-web
npx jest src/components/__tests__/test-utils-radix.test.tsx
# Tests: 7 passed, 7 total
npx jest src/components/__tests__/veterinaria src/components/__tests__/test-utils-radix.test.tsx
# 26 suites, 458 pruebas en verde
npx jest --listTests | grep "src/test-utils/" # no debe devolver nada: el helper no es una suite

npx tsc --noEmit y npx eslint siguen limpios.

Archivos clave​

  • ccf-almacen-web/src/test-utils/radix.ts — utilidades y las siete reglas.
  • ccf-almacen-web/src/components/__tests__/test-utils-radix.test.tsx — red de seguridad del arnés.
  • ccf-almacen-web/src/components/__tests__/veterinaria-cartera.test.tsx, veterinaria-calificaciones.test.tsx, veterinaria-dashboard.test.tsx, veterinaria-documentos.test.tsx y veterinaria-personal.test.tsx — consumen elementoConAncla y esperarToast.
  • ccf-almacen-web/src/components/__tests__/veterinaria-*-tour.test.tsx — usan abrirPestana en lugar de su copia local.