Pruebas¶
Pruebas unitarias¶
Las pruebas unitarias cubren el análisis del entorno, la generación de configuración del puente, el manejo de argumentos de lanzamiento y las herramientas locales de introspección de Cloak.
Las pruebas de bloqueo de perfiles persistentes cubren la recuperación tras finalizar el propietario, los propietarios activos o de estado incierto, los cambios del archivo de bloqueo y la limpieza tras escrituras parciales.
Pruebas de integración¶
Las pruebas de integración usan un proceso hijo MCP upstream falso y verifican que el puente combine las herramientas locales y reenvíe las llamadas upstream sin cambios.
npm run check incluye comprobaciones estáticas, pruebas unitarias/de integración y del CLI empaquetado con upstream MCP simulado, sin Chromium. En los PR, las pruebas unitarias/de integración y del CLI se ejecutan una vez por combinación de plataforma y Node.js: 22, 24, 26 en Linux x64/arm64, macOS x64/arm64 y Windows x64. Linux x64 recoge la cobertura para Codecov en esa misma ejecución. Las comprobaciones estáticas y la verificación del paquete se ejecutan una vez en Linux x64/Node.js 22.
Las pruebas del CLI empaquetado verifican el reinicio tras una terminación forzada, el rechazo de un servidor competidor mientras el propietario sigue activo y la limpieza cuando el cliente cierra stdin.
La matriz de CI, el inventario de resultados esperados y la documentación leen las versiones de Node.js de .github/workflows/ci.yml. Actualiza ese archivo cuando cambien las ramas de versiones probadas.
Pruebas con navegador real y distribuciones¶
npm run test:e2e
npm run test:e2e:playwright-console
npm run test:e2e:cdp
npm run test:e2e:npm-package
npm run test:e2e:docker
npm run test:e2e:cdp:docker
test:e2e combina pruebas de CLI con fake upstream y pruebas de consola con Playwright Chromium real. test:e2e:playwright-console verifica los métodos de consola en sesiones nuevas. test:e2e:cdp verifica el acceso administrado mediante Chrome DevTools Protocol (CDP) con Free CloakBrowser y Playwright Chromium controlado.
test:e2e:npm-package empaqueta e instala el paquete en un proyecto temporal. La prueba del contrato de reenvío usa fake upstream; los escenarios de navegador usan CloakBrowser real y páginas locales para verificar herramientas estándar, estado persistente y ambos presets de humanización. Otra prueba verifica descargas concurrentes en una caché vacía y stdout sin texto adicional. Verificar el paquete por sí solo no valida el navegador.
La matriz de navegador del PR comprueba la consola de Playwright y CDP gestionado con Node.js 26 en las mismas cinco plataformas, más Linux x64/Node.js 22 para CDP. Una matriz paralela de Node.js 24 ejecuta las suites del paquete npm, proxy/GeoIP, extensiones y ciclo de vida en las cinco plataformas, incluidos ambos preajustes de humanización. La aceptación de Docker y CDP cubre ambos motores en linux/amd64 y linux/arm64.
required-ci exige que todas las suites y el informe agregado completo pasen antes de fusionar. El mismo flujo CI también se ejecuta semanalmente y de forma manual. Release construye y publica artefactos de la revisión probada.
Informes de pruebas¶
Cada celda de la matriz CI sube resultados saneados y adjuntos de diagnóstico. El trabajo de agregación los combina en un informe HTML de Allure, conservando las etiquetas de suite y entorno. La falta de productores esperados y las pruebas fallidas hacen fallar la agregación; los resultados originales y el informe HTML quedan disponibles como artefactos de Actions.
Los PR elegibles pueden publicar un enlace al informe mediante el repositorio independiente configurado. La publicación requiere entrega habilitada, evidencia validada de la ejecución y verificación correcta de Pages. El sitio de documentación se despliega por separado. Los informes públicos solo contienen diagnósticos permitidos y saneados de fixtures controlados.
npm run test:report -- --suite unit --run-id local
npm run test:report:generate -- --input artifacts/test-results --output artifacts/test-report/local
npm run test:report:open -- --report artifacts/test-report/local
Usa el directorio de salida real del recolector como entrada del generador. Consulta Contribuir para los formatos, adjuntos y entrega por CI.
Verificación del paquete¶
Esto compila el paquete, ejecuta npm pack, comprueba la lista de archivos del tarball, instala el tarball en un proyecto temporal y verifica --version y --help de la CLI.
La verificación del paquete también valida server.json contra el esquema publicado de servidor MCP.
El ensamblado de la versión usa npm run package:pack para construir el archivo y validar sus metadatos y archivos incluidos. La instalación y la ejecución del CLI se verifican antes de fusionar mediante package:verify.
Prueba smoke de Docker¶
La prueba smoke verifica que la imagen creada arranque e imprima la ayuda de la CLI. CI ejecuta pruebas smoke de las imágenes Docker para linux/amd64 y linux/arm64.
Paridad con upstream¶
npm run bridge:compare
npm run bridge:compare -- cloakbrowser-mcp:dev --report bridge-parity-report.json
El script de paridad inicia la imagen Docker oficial de Playwright MCP y la imagen del puente CloakBrowser, compara los nombres de herramientas upstream, ejercita la superficie predeterminada de herramientas de navegador en una misma página fixture y verifica las herramientas locales de introspección de Cloak.
CI carga el informe JSON de paridad desde los jobs de Docker. La paridad del navegador se comprueba en linux/amd64; ambas arquitecturas ejecutan pruebas básicas, análisis de vulnerabilidades, pruebas de distribución y CDP. La paridad cubre la versión fijada de Docker MCP; la suite npm verifica npm MCP por separado.
Comprobaciones de seguridad¶
CI también ejecuta CodeQL, Dependency Review, OpenSSF Scorecard, zizmor y Trivy. Estas herramientas son gratuitas para repositorios públicos y no requieren cuentas externas.