Aller au contenu

Tests

Tests unitaires

npm run test:unit

Les tests unitaires couvrent l'analyse de l'environnement, la génération de configuration du pont, la gestion des arguments de lancement et les outils locaux d'introspection Cloak.

Les tests de verrouillage des profils persistants couvrent la récupération après la fin du processus propriétaire, les propriétaires actifs ou d’état incertain, les fichiers de verrou modifiés et le nettoyage après une écriture partielle.

Tests d'intégration

npm run test:integration

Les tests d'intégration utilisent un processus enfant MCP upstream factice et vérifient que le pont fusionne les outils locaux et transmet les appels upstream sans modification.

npm run check comprend les vérifications statiques, les tests unitaires/d’intégration et les tests du CLI empaqueté avec un upstream MCP simulé, sans Chromium. En PR, les tests unitaires/d’intégration et du CLI s’exécutent une fois par combinaison plateforme/Node.js : 22, 24, 26 sur Linux x64/arm64, macOS x64/arm64 et Windows x64. Linux x64 collecte la couverture pour Codecov lors de cette même exécution. Les vérifications statiques et du paquet s’exécutent une fois sur Linux x64/Node.js 22.

Les tests du CLI empaqueté vérifient le redémarrage après un arrêt forcé, le rejet d’un serveur concurrent tant que le propriétaire est actif et le nettoyage lorsque le client ferme stdin.

La matrice CI, l’inventaire des résultats attendus et la documentation lisent les versions de Node.js depuis .github/workflows/ci.yml. Mettez ce fichier à jour lorsque les branches de versions testées changent.

Tests avec navigateur réel et distributions

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 combine les contrôles CLI avec upstream simulé et les contrôles de console avec Playwright Chromium réel. test:e2e:playwright-console vérifie les méthodes de console dans des sessions neuves. test:e2e:cdp vérifie l’accès géré via Chrome DevTools Protocol (CDP) avec Free CloakBrowser et Playwright Chromium contrôlé.

test:e2e:npm-package empaquette et installe le paquet dans un projet temporaire. Le contrôle du contrat de transfert utilise un upstream simulé ; les scénarios navigateur vérifient les outils standard, l’état persistant et les deux préréglages d’humanisation avec CloakBrowser réel et des pages locales. Un autre test vérifie les téléchargements concurrents dans un cache vide et l’absence de texte supplémentaire dans stdout. La vérification du paquet seule ne constitue pas une validation du navigateur.

La matrice de navigateurs du PR vérifie la console Playwright et CDP géré avec Node.js 26 sur les mêmes cinq plateformes, plus Linux x64/Node.js 22 pour CDP. Une matrice parallèle Node.js 24 exécute les suites du paquet npm, proxy/GeoIP, extensions et cycle de vie sur les cinq plateformes, dont les deux préréglages d’humanisation. L’acceptation Docker et CDP couvre les deux moteurs sur linux/amd64 et linux/arm64.

required-ci exige la réussite de chaque suite et du rapport agrégé complet avant fusion. Le même workflow CI s’exécute aussi chaque semaine et manuellement. Release construit et publie les artefacts de la révision testée.

Rapports de tests

Chaque cellule de la matrice CI téléverse des résultats assainis et des pièces jointes de diagnostic. L’agrégation les combine en un rapport HTML Allure en conservant les étiquettes de suite et d’environnement. L’absence de producteurs attendus et les tests échoués font échouer l’agrégation ; les résultats bruts et le HTML restent disponibles comme artefacts Actions.

Les exécutions PR admissibles peuvent publier un lien via le dépôt de rapports séparé configuré. La publication exige une livraison activée, des preuves d’exécution validées et une vérification Pages réussie. Le site documentaire est déployé séparément. Les rapports publics contiennent uniquement des diagnostics autorisés et assainis issus de données de test contrôlées.

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

Utilisez le répertoire de sortie réel du collecteur comme entrée du générateur. Voir Contribuer pour les formats, les pièces jointes et la livraison CI.

Vérification du paquet

npm run package:verify

Cette commande construit le paquet, exécute npm pack, vérifie la liste des fichiers du tarball, installe le tarball dans un projet temporaire et valide --version et --help de la CLI.

La vérification du paquet valide aussi server.json avec le schéma publié de serveur MCP.

La préparation de la version utilise npm run package:pack pour créer l’archive et valider ses métadonnées et fichiers. L’installation et l’exécution du CLI sont vérifiées avant fusion par package:verify.

Smoke test Docker

npm run docker:build
npm run docker:smoke

Le smoke test vérifie que l'image construite démarre et affiche l'aide de la CLI. CI exécute des smoke tests des images Docker pour linux/amd64 et linux/arm64.

Parité avec upstream

npm run bridge:compare
npm run bridge:compare -- cloakbrowser-mcp:dev --report bridge-parity-report.json

Le script de parité démarre l'image Docker officielle Playwright MCP et l'image du pont CloakBrowser, compare les noms d'outils upstream, exerce la surface d'outils navigateur par défaut sur une même page fixture et vérifie les outils locaux d'introspection Cloak.

CI téléverse le rapport JSON de parité depuis les jobs Docker. La parité du navigateur est vérifiée sur linux/amd64 ; les deux architectures exécutent les vérifications de base, les analyses de vulnérabilités, les tests de distribution et CDP. La parité couvre la version Docker MCP fixée ; la suite npm vérifie npm MCP séparément.

Contrôles de sécurité

npm run audit:prod
npm run server:validate

CI exécute également CodeQL, Dependency Review, OpenSSF Scorecard, zizmor et Trivy. Ces outils sont gratuits pour les dépôts publics et ne nécessitent pas de comptes externes.