Saltar al contenido principal

Arnés de pruebas — utilidades de Radix y taxonomía del blog al día

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

Dos ajustes que salieron de escribir las suites de veterinaria: los detalles del entorno de Radix dejan de repetirse en cada archivo de pruebas, y la taxonomía del blog vuelve a pasar su verificador, que llevaba doce avisos acumulados.

1. Utilidades de prueba compartidas​

Nuevo módulo ccf-almacen-web/src/test-utils/radix.ts, usado ya por las suites de Agenda y de Clientes y mascotas:

UtilidadQué resuelve
anularFocoProgramatico()El ciclo de FocusScope entre diálogo y Select en jsdom (dos copias del paquete que se reenfocan mutuamente hasta desbordar la pila)
abrirPestana(nombre)Radix activa la pestaña en mouseDown; dispara el gesto y espera a data-state="active"
elegirEnCombo(modal, indice, nombre) y combo(...)Abrir un Select y elegir una opción del portal
campo(id) y elementosConAncla(ancla)Acceso a los formularios y a los anclajes data-tour

Antes, el bloqueo del foco programático vivía copiado en cada suite, con el mismo comentario. Ahora el motivo está escrito una sola vez y la próxima pantalla del módulo lo hereda sin redescubrirlo.

Estas utilidades no sustituyen a las pruebas de accesibilidad: la navegación por teclado necesita foco real y se valida con Playwright (ADR-009).

2. Taxonomía del blog​

npm run verificar:etiquetas volvía con 12 problemas: posts que usaban etiquetas no declaradas o variantes de una ya existente (POS frente a pos, menú frente a menu, panel lateral frente a panel-lateral).

  • Seis etiquetas nuevas declaradas en blog/tags.yml: REQ-DOC-02, TEC-010, TEC-016, estadisticas, offline, panel-lateral, pwa, service-worker y v2-3, con su label en la grafía correcta y su permalink.
  • Tres posts corregidos para usar la clave existente: 2026-11-06-almacenes-formulario-completo (POS → pos), 2026-11-11-menu-solicitudes-listado (menú → menu, panel lateral → panel-lateral) y 2026-11-11-tooltip-solicitudes-se-cierra (panel lateral → panel-lateral), además de 2026-11-11-sala-de-continuidad (PWA → pwa).
  • Resultado: Taxonomía del blog correcta: 247 etiquetas en uso, 249 declaradas, 2 autores. Solo quedan dos declaradas sin uso (docusaurus, tecnologia), que el verificador informa y no consideran error.

Cómo verificarlo​

cd ccf-almacen-web
npx jest src/components/__tests__/veterinaria-agenda.test.tsx src/components/__tests__/veterinaria-pacientes.test.tsx
# Tests: 94 passed, 94 total

cd ../ccf-almacen-wiki
npm run verificar:etiquetas
# Taxonomía del blog correcta

npx tsc --noEmit y npx eslint siguen limpios en el web.

Archivos clave​

  • ccf-almacen-web/src/test-utils/radix.ts — utilidades nuevas.
  • ccf-almacen-web/src/components/__tests__/veterinaria-agenda.test.tsx y veterinaria-pacientes.test.tsx — usan las utilidades (sin los bloques copiados).
  • ccf-almacen-wiki/blog/tags.yml — etiquetas declaradas.
  • ccf-almacen-wiki/blog/2026-11-06-almacenes-formulario-completo.md, 2026-11-11-menu-solicitudes-listado.md, 2026-11-11-tooltip-solicitudes-se-cierra.md, 2026-11-11-sala-de-continuidad.md — claves corregidas.