Arnés de pruebas — las lecciones dejan de ser prosa y pasan a ser código
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ón | Utilidad |
|---|---|
FocusScope de Radix entre diálogo y Select desborda la pila en jsdom | anularFocoProgramatico() |
Radix activa la pestaña en mouseDown y desmonta el contenido inactivo | abrirPestana() |
Abrir un Select y elegir opción del portal | combo() / elegirEnCombo() |
Acceso a formularios y anclajes data-tour | campo() / elementosConAncla() |
| Textos y cabeceras duplicados entre bloques y tablas | elementoConAncla() + within(...) |
El aviso se publica una microtarea después del await del API | esperarToast() |
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
elementoConAnclasustituye a los treskpi()/tarjeta()escritos a mano (cartera, calificaciones y tablero).esperarToastreemplaza 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).abrirPestanareemplaza 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
Selectdentro (el caso que desbordaba la pila) se abre y se elige una opción; - una pestaña cambia y desmonta la anterior;
elementoConAncladevuelve el primer nodo y falla nombrando el ancla ausente;esperarToastaguarda 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.tsxyveterinaria-personal.test.tsx— consumenelementoConAnclayesperarToast.ccf-almacen-web/src/components/__tests__/veterinaria-*-tour.test.tsx— usanabrirPestanaen lugar de su copia local.
