TestNG Berichterstellung in Selenium: Wie generiert man?

Was sind TestNG Berichte?

TestNG Reports sind die Standard-HTML-Berichte, die generiert werden, sobald die Testfälle mit ausgeführt werden TestNG. Mithilfe dieser Berichte können Sie Informationen zu Testfällen und zum Status eines Projekts ermitteln. TestNG Berichte in Selenium Für jede Testmethode sollten drei Ergebnisse protokolliert werden – bestanden, nicht bestanden und übersprungen –, damit die Daten zu den Testfällen auf einen Blick erfasst werden können.

Die Berichterstellung ist sowohl bei der Durchführung automatisierter Tests als auch bei manuellen Tests sehr wichtig.

• Anhand des Ergebnisses können Sie leicht erkennen, wie viele Testfälle bestanden, fehlgeschlagen und übersprungen wurden.
• Wenn Sie sich den Bericht ansehen, erfahren Sie, wie der Status des Projekts ist.

Selenium WebDriver wird zur Automatisierung der Webanwendung verwendet, generiert aber selbst keine Berichte.

• Das TestNG generiert den Standardbericht.
• Wenn Sie die testng.xml-Datei ausführen und das Projekt aktualisieren, erhalten Sie einen Ordner namens „test-output“, der die Berichtsausgabe enthält. TestNG.
• Klicken Sie mit der rechten Maustaste auf die Datei emailable-report.html und wählen Sie die Option „Mit Webbrowser öffnen“.

Hinweis: Das hier beschriebene Verhalten bleibt unverändert in TestNG 7.x. Releases von TestNG Ab Version 7.6 ist JDK 11 oder höher erforderlich. Bei älteren Projekten muss daher möglicherweise die JDK-Version erhöht werden, bevor die Berichte erstellt werden können.

Arten von TestNG Berichte im Ordner „test-output“

Bevor man eine einzelne Datei öffnet, ist es hilfreich zu wissen, was der Test-Ausgabeordner tatsächlich enthält. TestNG Er schreibt bei jedem Durchlauf mehrere Artefakte, und jedes einzelne beantwortet eine andere Frage.

Die beiden HTML-Dateien sind diejenigen, die dieses Tutorial als nächstes öffnet, daher beginnt die folgende Anleitung mit emailable-report.html.

So erstellen Sie Berichte in Selenium

Methode 1: emailable-report.html

1. Klicken Sie auf die Option „emailable-report.html“.
2. Klicken Sie auf die Option Webbrowser

Der folgende Screenshot zeigt, wie die Datei emailable-report.html aus dem Ordner test-output geöffnet wird.

Die Ausgabe meldet TestNG Wenn beide Klassen bestanden werden, sieht die Berichterstattung wie folgt aus:

Stellen Sie sich das Szenario vor, in dem Sie den Testfall, d. h. die Klasse DemoB, absichtlich scheitern lassen. Konvertieren Sie dann beide Klassen in die Suite-Datei testng.xml und führen Sie sie aus. Dann sieht das Ergebnis so aus. Es zeigt das fehlgeschlagene Testfälle.

Dies ist das Ergebnis für die DemoB-Klasse:

Ähnlich sieht das Ergebnis für die Klasse DemoA so aus:

Methode 2: index.html

1. Klicken Sie im Projektverzeichnis mit der rechten Maustaste auf index.html.
2. Wählen Sie die Option „Mit Webbrowser öffnen“. Das Ergebnis wird in der folgenden Reihenfolge angezeigt.

Der folgende Screenshot zeigt, wie die Datei index.html aus dem Projektverzeichnis geöffnet wird.

Das Ergebnis sieht dann so aus:

Methode 3: Reporterklasse

Zusammen mit diesen TestNG Mithilfe generierter Berichtsmethoden können Sie die Datei „object.properties“ verwenden, um die vom System generierten Protokolle sowie die vom Benutzer generierten Protokolle zu speichern. Eine der einfachsten Möglichkeiten zum Speichern von Protokollinformationen beim Testen ist jedoch die Verwendung von Reporterklasse.

Reporter.einloggen Selenium ist eine Klasse, die in vorhanden ist TestNG für Selenium Berichterstattung. Es bietet vier verschiedene Methoden zum Speichern von Protokollinformationen:

1. Reporter.log(String s);
2. Reporter.log(String s, Boolean logToStandardOut);
3. Reporter.log(String s, int level);
4. Reporter.log(String s, int level, Boolean logToStandardOut);

Das zweite Argument bestimmt, ob die Meldung zusätzlich zum Bericht auch in der Konsole angezeigt wird, und das Argument „level“ steuert den Ausführlichkeitsgrad der Meldung.

Beispiel:

Erstellen Sie zwei Klassen wie DemoA und DemoB und schreiben Sie den folgenden Code in die Klassen.

Für Klasse DemoA;

• Das Code Die Erklärung für DemoA erfolgte bereits oben. Hier verwenden Sie Protokollmethode der Reporter-Klasse. (Um eine eigene Reporting-Klasse zu implementieren, muss die Klasse die Schnittstelle org.testng.IReporter implementieren.)
• Die Protokollmethode ist eine statische Methode der Reporter-Klasse. Sie greifen also über die Reporter-Klasse auf diese Methode zu.
• Die Protokollmethode wird zum Speichern von Protokollinformationen verwendet, die in das Programm geschrieben werden. Anhand der Protokollinformationen können Sie leicht erkennen, wo genau die Ausführung des Programms gestoppt wird.

Der folgende Screenshot zeigt die Reporter.log-Aufrufe innerhalb der DemoA-Klasse.

Für Klasse DemoB:

• Erstellen Sie nun die Datei testng.xml, indem Sie diese beiden Klassen auswählen und
• Wählen Sie Ausführen als und
• Klicken Sie auf „In Testng konvertieren“.
• Führen Sie dann diese Datei testng.xml aus, indem Sie „Ausführen als“ auswählen und die Testng-Suite auswählen.
• Aktualisieren Sie dann das Projekt und öffnen Sie den Testausgabeordner.

1. Öffnen Sie im Ordner „test-output“ die Datei „emailable-report.html“. Sie sieht folgendermaßen aus:

   

   Ebenso verfügen Sie über eine Ausgabe für das Demo-B-Projekt.

2. Öffnen Sie im Ordner „test-output“ die Datei „index.html“. Sie sieht folgendermaßen aus:

   

Klicken Sie auf Reporterausgabe. Es werden Protokollierungsinformationen geöffnet, unabhängig davon, was in den Testmethoden angegeben ist.

Klicken Sie auf die Zeiten. Es wird angezeigt, wie viel Zeit es gedauert hat, die in der Klasse vorhandene Testmethode auszuführen TestNG Reporting-Tools.

So passen Sie an TestNG Berichte mit ITestListener und IReporter

Die drei oben genannten Methoden verwenden jeweils beliebiges TestNG Wird standardmäßig erstellt. Wenn ein Team ein anderes Layout, zusätzliche Felder oder eine Live-Fortschrittsanzeige benötigt, TestNG Es werden zwei Erweiterungspunkte bereitgestellt, anstatt Sie aufzufordern, den Standardbericht zu patchen.

• ITestListener Sie werden in Echtzeit benachrichtigt, sobald ein Test startet, erfolgreich ist, fehlschlägt oder übersprungen wird. Nutzen Sie diese Funktion, wenn die Informationen im Moment des Ereignisses erfasst werden müssen – beispielsweise ein Screenshot im Fehlerfall.
• Reporter Die Funktion wird einmalig nach Abschluss jeder Suite benachrichtigt und empfängt Objekte, die den gesamten Durchlauf beschreiben. Verwenden Sie sie, wenn das Ergebnis ein fertiges Dokument ist, z. B. eine PDF-Datei oder eine benutzerdefinierte HTML-Seite.

Ein Listener, der jedes Ergebnis über die Reporter-Klasse in den Bericht einfügt, sieht folgendermaßen aus.

import org.testng.ITestListener;
import org.testng.ITestResult;
import org.testng.Reporter;

public class ReportListener implements ITestListener {

    @Override
    public void onTestSuccess(ITestResult result) {
        Reporter.log("PASSED: " + result.getName(), true);
    }

    @Override
    public void onTestFailure(ITestResult result) {
        Reporter.log("FAILED: " + result.getName(), true);
    }

    @Override
    public void onTestSkipped(ITestResult result) {
        Reporter.log("SKIPPED: " + result.getName(), true);
    }
}

Die Registrierung des Listeners erfolgt in derselben testng.xml Suite-Datei, die Sie bereits für DemoA und DemoB erstellt haben.

<suite name="Demo Suite">
  <listeners>
    <listener class-name="ReportListener" />
  </listeners>
  <test name="Demo Test">
    <classes>
      <class name="DemoA" />
      <class name="DemoB" />
    </classes>
  </test>
</suite>

Zwei Befehlszeilenoptionen sind beim Experimentieren hilfreich. -d Diese Option ändert das Verzeichnis, in das die Berichte geschrieben werden, und -usedefaultlisteners false Die integrierten Reporter werden deaktiviert, sodass nur Ihr eigener Listener ausgeführt wird. Beides wird in der offiziellen Dokumentation beschrieben. TestNG Protokollierung und Ergebnisdokumentation, welche auch die vom integrierten XML-Reporter akzeptierten Eigenschaften dokumentiert.

Ein Listener wird einmal registriert und gilt dann für jede Klasse in der Suite. Aus diesem Grund verwenden Teams, die große Klassen ausführen, diese Methode. Automatisierungstests Testsuiten bevorzugen dies in der Regel gegenüber dem manuellen Hinzufügen von Logzeilen zu jeder Testmethode.

TestNG Standardberichte vs. ExtentReports vs. Allure

Die Standardberichte reichen für eine kleine Suite aus, enthalten aber weder Verlaufsdaten noch Diagramme. Bei größeren Suiten werden üblicherweise zwei Open-Source-Bibliotheken hinzugefügt, die beide mit … kompatibel sind. TestNG.

Beginnen Sie mit den Standardberichten, solange die Berichtssuite noch klein ist. Wechseln Sie zu ExtentReports wenn Stakeholder übersichtliche Dashboards fordern, und um Allure-Bericht Wenn die Historie fehlerhafter Tests über verschiedene Builds hinweg zum entscheidenden Faktor wird. Unabhängig von der gewählten Methode wird der Bericht normalerweise vom Build-Job veröffentlicht, der im Abschnitt „…“ behandelt wird. Jenkins kontinuierliche integration Tutorial.

Häufig gestellte Fragen