Testabdeckungsanalysator
Diese Fähigkeit hilft, Lücken in der Testabdeckung zu identifizieren und schlägt spezifische Testfälle zur Verbesserung der Codequalität vor.
Wann man diese Fähigkeit nutzen sollte
- Benutzer bittet um Analyse der Testabdeckung
- Benutzer möchte die Testabdeckung verbessern
- Benutzer fordert Vorschläge für fehlende Tests an
- Arbeiten an der Erhöhung des Codeabdeckungsprozentsatzes
- Benutzer erwähnt "Abdeckungslücken", "ungetesteten Code" oder "Testvorschläge"
Anleitung
1. Test-Framework erkennen
Identifizieren Sie das/die in dem Projekt verwendeten Test-Framework(s):
JavaScript/TypeScript:
- Jest:
jestin package.json oderjest.config.js - Mocha:
mochain package.json oder.mocharc - Vitest:
vitestin package.json odervitest.config.js - Jasmine:
jasminein package.json
Python:
- pytest:
pytestin requirements.txt oderpytest.ini - unittest: Standardbibliothek, nach Testdateien suchen
- coverage.py:
coveragein requirements.txt
Ruby:
- RSpec:
rspecin Gemfile - Minitest: Standardbibliothek
Go:
- Integriert:
go test(Abdeckung viago test -cover)
Java:
- JUnit: Suche nach JUnit in pom.xml oder build.gradle
- JaCoCo: Konfiguration des Abdeckungstools
Verwenden Sie Glob and Grep, um Konfigurationsdateien zu finden.
2. Abdeckungsberichte lokalisieren
Finden Sie vorhandene Abdeckungsberichte:
Häufige Speicherorte:
coverage/-Verzeichnis.nyc_output/(NYC für Node.js)htmlcov/(coverage.py für Python)target/site/jacoco/(JaCoCo für Java)- Abdeckungsdateien:
lcov.info,coverage.json,.coverage
Wenn kein Abdeckungsbericht existiert:
- Leiten Sie den Benutzer an, die Abdeckung auszuführen:
npm test -- --coverage,pytest --cov, usw. - Warten Sie auf die Berichterstellung, bevor Sie mit der Analyse beginnen
3. Abdeckungsdaten parsen
Extrahieren Sie Abdeckungsinformationen:
Aus lcov.info:
- Abgedeckte vs. gesamte Zeilen
- Abgedeckte vs. gesamte Funktionen
- Abgedeckte vs. gesamte Zweige
- Nicht abgedeckte Zeilennummern pro Datei
Aus coverage.json (Jest):
- Prozentsatz der Anweisungsabdeckung
- Prozentsatz der Zweigabdeckung
- Prozentsatz der Funktionsabdeckung
- Prozentsatz der Zeilenabdeckung
- Nicht abgedeckte Zeilen pro Datei
Aus .coverage (Python):
- Verwenden Sie
coverage reportodercoverage json - Fehlende Zeilenbereiche
- Ausgeschlossene Zeilen
Aus HTML-Berichten:
- Zusammenfassungsstatistiken lesen
- Dateien mit geringer Abdeckung identifizieren
4. Abdeckungslücken identifizieren
Priorisieren Sie Dateien/Funktionen, die getestet werden müssen:
Hohe Priorität:
- Geschäftslogik mit 0 % Abdeckung
- Öffentliche APIs und exportierte Funktionen
- Fehlerbehandlungspfade (catch-Blöcke, Fehlerrückrufe)
- Randfälle und Grenzbedingungen
- Kritische Pfade (Authentifizierung, Zahlung, Datenvalidierung)
Mittlere Priorität:
- Hilfsfunktionen mit teilweiser Abdeckung
- Private Funktionen, die von öffentlichen APIs aufgerufen werden
- Konfigurations- und Initialisierungscode
Niedrigere Priorität:
- Einfache Getter/Setter
- Typdefinitionen
- Automatisch generierter Code
- Code von Drittanbietern
5. Ungetestete Codepfade analysieren
Für jede Datei mit Abdeckungslücken:
- Lesen Sie die Quelldatei, um die Codestruktur zu verstehen
- Identifizieren Sie ungetesteten Code:
- Nicht abgedeckte Zeilen und Zeilenbereiche
- Ungetestete bedingte Zweige (if/else)
- Nicht abgedeckte Fehlerbehandler
- Fehlende Funktionsabdeckung
- Kategorisieren Sie fehlende Tests:
- Happy-Path-Tests
- Fehler-/Ausnahmetests
- Randfalltests
- Integrationstests
6. Testvorschläge generieren
Für jede Abdeckungslücke spezifische Testfälle vorschlagen:
Format:
Datei: src/utils/validator.js (42 % Abdeckung)
Fehlende Abdeckung:
- Zeilen 15-18: Fehlerpfad der E-Mail-Validierung
- Zeilen 23-25: Behandlung leerer Eingaben
- Zeilen 30-35: Randfall für Sonderzeichen
Vorgeschlagene Tests:
1. E-Mail-Validierung mit ungültigem Format testen (deckt Zeilen 15-18 ab)
2. Validator mit leerer Zeichenketteneingabe testen (deckt Zeilen 23-25 ab)
3. Behandlung von Sonderzeichen in Namen testen (deckt Zeilen 30-35 ab)
Testfalldetails sollten Folgendes enthalten:
- Testbeschreibung
- Eingabedaten
- Erwartete Ausgabe/Verhalten
- Abgedeckte Zeilen/Zweige
7. Test-Stubs erstellen (optional)
Wenn der Benutzer möchte, generieren Sie Testdatei-Stubs:
- Verwenden Sie die entsprechende Test-Framework-Syntax
- Fügen Sie describe/test-Blöcke mit TODO-Kommentaren ein
- Fügen Sie eine Beispielteststruktur hinzu
- Verweisen Sie auf die Vorlage in
templates/test-template.js(oder entsprechender Erweiterung)
Beispiel (Jest):
describe('Validator', () => {
describe('validateEmail', () => {
it('sollte ungültiges E-Mail-Format ablehnen', () => {
// TODO: E-Mail-Validierungsfehlerpfad testen (Zeilen 15-18)
const result = validateEmail('ungültige-email');
expect(result.valid).toBe(false);
});
it('sollte leere Zeichenketteneingabe behandeln', () => {
// TODO: Behandlung leerer Eingaben testen (Zeilen 23-25)
});
});
});
8. Abdeckungsmetriken berechnen
Bereitstellung von zusammenfassenden Statistiken:
- Gesamtabdeckungsprozentsatz
- Abdeckung nach Datei/Verzeichnis
- Funktionen/Methoden ohne Tests
- Kritische Dateien mit geringer Abdeckung
- Abdeckungstrend (falls historische Daten verfügbar)
9. Empfehlungen priorisieren
Vorschläge ordnen nach:
- Auswirkung: Kritische Geschäftslogik zuerst
- Risiko: Hochrisikobereiche (Sicherheit, Datenintegrität)
- Komplexität: Komplexe Logik benötigt mehr Tests
- Einfachheit: Schnelle Erfolge (einfache Tests für hohen Abdeckungsgewinn)
10. Ausgabeformat
Präsentieren Sie die Ergebnisse in einem klaren, umsetzbaren Format:
Zusammenfassung der Abdeckungsanalyse
=====================================
Gesamtabdeckung: 67 %
- Anweisungen: 65 %
- Zweige: 58 %
- Funktionen: 72 %
- Zeilen: 67 %
Dateien, die Aufmerksamkeit benötigen (sortiert nach Priorität):
1. src/payment/processor.js (23 % Abdeckung) - HOHE PRIORITÄT
- Fehlend: Fehlerbehandlung für Zahlungsfehler
- Fehlend: Wiederholungslogiktests
- Fehlend: Transaktionsvalidierung
2. src/auth/validator.js (45 % Abdeckung) - MITTLERE PRIORITÄT
- Fehlend: Behandlung ungültiger Token
- Fehlend: Tests für abgelaufene Sitzungen
Vorgeschlagene Testfälle:
[Detaillierte Vorschläge für jede Datei]
Bewährte Methoden
- Fokussieren Sie sich auf sinnvolle Abdeckung: 100 % Abdeckung ist nicht immer nötig
- Testen Sie das Verhalten, nicht die Implementierung: Schlagen Sie Tests vor, die Funktionalität überprüfen
- Priorisieren Sie kritische Pfade: Authentifizierung, Zahlungen, Datenvalidierung zuerst
- Testarten berücksichtigen: Unit-, Integrations- und E2E-Tests, wo angemessen
- Vorhandene Tests prüfen: Schlagen Sie keine Tests vor, die bereits existieren
- Realistische Testdaten: Verwenden Sie plausible Eingaben in Beispielen
- Abdeckungsschwellen: Schlagen Sie minimale Abdeckungsziele vor (z. B. 80 %)
Ausführen von Abdeckungsberichten
Bereitstellung von Befehlen basierend auf dem erkannten Framework:
Jest: npm test -- --coverage oder jest --coverage
Vitest: npm test -- --coverage oder vitest run --coverage
Mocha + NYC: nyc mocha
pytest: pytest --cov=src --cov-report=html
Go: go test -cover ./... oder go test -coverprofile=coverage.out
JUnit + JaCoCo: mvn test jacoco:report
Unterstützende Dateien
scripts/parse-coverage.sh: Hilfsskript zum Extrahieren von Abdeckungsdatentemplates/test-template.js: Testdateivorlage für JavaScripttemplates/test-template.py: Testdateivorlage für Pythontemplates/test-template.go: Testdateivorlage für Go