Testrapporter och filtrering

Testrapporter är viktiga för att förstå projektets hälsa. De ger en tydlig sammanfattning av vilka tester som godkändes, misslyckades eller hoppades över.

Den här informationen hjälper utvecklare att snabbt hitta problem, följa framsteg och säkerställa kodkvaliteten. Utan rapporterna skulle felsökning vara mycket svårare!

När du kör tester med Gradle genereras automatiskt en interaktiv HTML-rapport varje gång du kör testerna. Funktionen är aktiverad som standard när du tillämpar pluginet java eller java-library.

Rapporterna har ett lättöverskådligt gränssnitt där du kan bläddra bland testresultaten, vilket gör analysen enkel.

När du har kört testerna med uppgiften test placerar Gradle den genererade rapporten i en specifik katalog. Leta efter build/reports/tests/test/index.html.

Du kan öppna filen direkt i valfri webbläsare för att se en heltäckande översikt över testkörningen. Kör helt enkelt ./gradlew test för att generera en rapport.

HTML-rapporten innehåller värdefulla detaljer:

• Sammanfattning: Totalt antal tester, fel och överhoppade tester.
• Testklasser: En lista över alla körda testklasser.
• Enskilda tester: Status och varaktighet för varje testmetod.
• Feldetaljer: Stack traces och felmeddelanden för misslyckade tester.

Den här strukturen hjälper dig att gå från en övergripande översikt till specifika problemområden.

Ibland behöver du inte köra alla tester. Du kanske felsöker en viss funktion eller kör om ett misslyckat test.

Med Gradle kan du filtrera vilka tester som körs, vilket sparar tid och låter dig fokusera på rätt saker. Det gör du med kommandoradsalternativet --tests.

För att köra alla tester i en specifik testklass anger du dess fullständigt kvalificerade namn tillsammans med flaggan --tests.

Om du till exempel har en klass med namnet com.example.MyFeatureTest kör du:

Detta kör varje testmetod i den klassen.

Du kan göra urvalet ännu mer detaljerat genom att ange en specifik testmetod i en klass. Lägg till metodnamnet efter det fullständigt kvalificerade klassnamnet.

Om com.example.MyFeatureTest har en metod med namnet testSpecificCase använder du:

Detta är mycket användbart vid fokuserad felsökning.

Gradles alternativ --tests stöder jokertecken (*) för mer flexibel matchning. Då kan du köra grupper av tester som följer ett visst mönster.

• *IntegrationTest: Kör alla klasser vars namn slutar med "IntegrationTest".
• com.example.*: Kör alla tester i paketet com.example och dess underpaket.
• *.testFailure*: Kör alla metoder med namnet `testFailure` (eller liknande) i valfri klass.

Du kan använda flera --tests-alternativ i samma kommando. Gradle kör alla tester som matchar minst ett av de angivna mönstren.

Om du till exempel vill köra tester från två olika klasser använder du:

Det ger dig stor kontroll över testkörningen.

I den här lektionen utforskade vi testrapporternas viktiga roll i Gradle. Du lärde dig att:

• Gradle automatiskt genererar detaljerade HTML-testrapporter.
• Rapporterna finns i build/reports/tests/test/index.html.
• Du kan filtrera testkörningen med alternativet --tests.
• Filter kan rikta sig mot klasser och metoder eller använda jokertecken för större flexibilitet.

Genom att behärska dessa tekniker kan du hantera och felsöka din testsvit effektivt!