Tests¶
Unit-Tests¶
Unit-Tests decken das Parsen der Umgebung, die Bridge-Konfigurationserzeugung, die Verarbeitung von Startargumenten und lokale Cloak-Introspection-Tools ab.
Tests für persistente Profilsperren prüfen die Wiederherstellung nach dem Ende des Besitzerprozesses, aktive oder unklare Besitzer, geänderte Sperrdateien und die Bereinigung nach teilweisen Schreibvorgängen.
Integrationstests¶
Integrationstests verwenden einen gefälschten upstream MCP-Kindprozess und prüfen, dass die Bridge lokale Tools zusammenführt und upstream-Aufrufe unverändert weiterleitet.
npm run check umfasst statische Prüfungen, Unit-/Integrationstests und Tests der paketierten CLI mit simuliertem Upstream MCP, ohne Chromium. PR CI führt Unit-/Integrations- und CLI-Tests einmal je Plattform-/Node.js-Kombination aus: Node.js 22, 24, 26 auf Linux x64/arm64, macOS x64/arm64 und Windows x64. Linux x64 erfasst dabei im selben Testlauf die Abdeckung für Codecov. Statische Prüfungen und Paketverifikation laufen einmal auf Linux x64/Node.js 22.
Tests des paketierten CLI prüfen den Neustart nach erzwungenem Beenden, die Ablehnung eines konkurrierenden Servers bei aktivem Besitzer und die Bereinigung, wenn der Client stdin schließt.
Die CI-Matrix, das Inventar der erwarteten Ergebnisse und die Dokumentation lesen die Node.js-Versionen aus .github/workflows/ci.yml. Aktualisieren Sie diese Datei, wenn sich die getesteten Versionszweige ändern.
Tests mit echten Browsern und Distributionen¶
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 kombiniert CLI-Prüfungen mit simuliertem Upstream und Konsolenprüfungen mit echtem Playwright Chromium. test:e2e:playwright-console prüft Konsolenmethoden in frischen Sitzungen. test:e2e:cdp prüft verwalteten Zugriff über das Chrome DevTools Protocol (CDP) mit Free CloakBrowser und kontrolliertem Playwright Chromium.
test:e2e:npm-package packt und installiert das Paket in ein temporäres Projekt. Die Weiterleitungsvertragsprüfung nutzt einen simulierten Upstream; Browserszenarien prüfen Standard-Tools, persistenten Zustand und beide Humanisierungs-Presets mit echtem CloakBrowser und lokalen Seiten. Ein separater Test prüft parallele Downloads in einen leeren Cache und stdout ohne Zusatztext. Paketverifikation allein ist keine Browserabnahme.
Die PR-Browsermatrix prüft Playwright-Konsole und verwaltetes CDP mit Node.js 26 auf denselben fünf Plattformen sowie CDP zusätzlich auf Linux x64/Node.js 22. Eine parallele Node.js-24-Matrix führt die Suiten für npm-Paket, proxy/GeoIP, Erweiterungen und Lebenszyklus auf allen fünf Plattformen aus, einschließlich beider Humanisierungs-Presets. Docker-Distributions- und CDP-Abnahme prüfen beide Engines auf linux/amd64 und linux/arm64.
required-ci verlangt vor dem Merge erfolgreiche Suiten und einen vollständigen aggregierten Bericht. Derselbe CI-Workflow läuft auch wöchentlich und manuell. Release baut und veröffentlicht Artefakte aus der getesteten Revision.
Testberichte¶
Jede CI-Matrixzelle lädt bereinigte Ergebnisse und Diagnoseanhänge hoch. Der Aggregationsjob erstellt einen gemeinsamen Allure-HTML-Bericht und erhält Suite- und Umgebungslabels. Fehlende erwartete Produzenten und fehlgeschlagene Tests lassen die Aggregation scheitern; Rohdaten und HTML bleiben als Actions-Artefakte verfügbar.
Geeignete PR-Läufe können einen Link über das konfigurierte separate Berichtsrepository veröffentlichen. Dafür sind aktivierte Bereitstellung, geprüfte Laufnachweise und eine erfolgreiche Pages-Verifikation nötig. Die Dokumentationswebsite wird separat bereitgestellt. Öffentliche Berichte enthalten nur erlaubte, bereinigte Diagnosen aus kontrollierten Testdaten.
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
Verwenden Sie das tatsächliche Ausgabeverzeichnis des Collectors als Generatoreingabe. Formate, Anhänge und CI-Bereitstellung beschreibt Mitwirken.
Paketverifizierung¶
Dies baut das Paket, führt npm pack aus, prüft die Tarball-Dateiliste, installiert den Tarball in ein temporäres Projekt und verifiziert CLI --version und --help.
Die Paketverifizierung validiert außerdem server.json gegen das veröffentlichte MCP-Server-Schema.
Die Release-Erstellung verwendet npm run package:pack, um das Archiv zu bauen und Metadaten sowie Dateiinventar zu prüfen. Installation und CLI-Ausführung werden vor dem Merge durch package:verify verifiziert.
Docker-Smoke-Test¶
Der Smoke-Test prüft, dass das gebaute Image startet und CLI-Hilfe ausgibt. CI führt Smoke-Tests für Docker-Images auf linux/amd64 und linux/arm64 aus.
Upstream-Parität¶
npm run bridge:compare
npm run bridge:compare -- cloakbrowser-mcp:dev --report bridge-parity-report.json
Das Paritätsskript startet das offizielle Playwright-MCP-Docker-Image und das CloakBrowser-Bridge-Image, vergleicht upstream-Toolnamen, übt die Standard-Browser-Tooloberfläche auf derselben Fixture-Seite aus und prüft lokale Cloak-Introspection-Tools.
CI lädt den JSON-Paritätsbericht aus Docker-Jobs hoch. Browserparität wird auf linux/amd64 geprüft; beide Architekturen führen Basisprüfungen, Schwachstellenscans, Distributions- und CDP-Tests aus. Die Parität deckt die festgelegte Docker-MCP-Version ab; die npm-Suite prüft npm MCP gesondert.
Sicherheitsprüfungen¶
CI führt außerdem CodeQL, Dependency Review, OpenSSF Scorecard, zizmor und Trivy aus. Diese Werkzeuge sind für öffentliche Repositorys kostenlos und erfordern keine externen Konten.