Zum Inhalt

Tests

Unit-Tests

npm run test:unit

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

npm run test:integration

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

npm run package:verify

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

npm run docker:build
npm run docker:smoke

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

npm run audit:prod
npm run server:validate

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.