Einrichtung von Specflow in .NET-Projekten

Um Specflow in Ihren .NET-Projekten zu verwenden, müssen Sie zuerst das Specflow NuGet-Paket installieren, um Ihr Testframework einzurichten, Feature-Dateien zu erstellen und Testszenarien zu definieren.

1. Öffnen Sie Visual Studio.
2. Erstellen Sie ein neues .NET-Projekt oder öffnen Sie ein bestehendes.
3. Gehen Sie zum Menü 'Erweiterungen' und dann zu 'Erweiterungen verwalten'.
4. Suchen Sie nach "Specflow". Installieren Sie die Specflow-Erweiterung.

Ein grundlegendes Code-Beispiel

Sobald Specflow eingerichtet ist, können Sie Ihre erste Feature-Datei erstellen, die im Features-Ordner abgelegt wird. Eine Feature-Datei in Specflow beschreibt die Verhaltensweisen, die Sie in einem lesbaren Format testen möchten. Hier ist ein einfaches Beispiel, wie man eine neue Feature-Datei erstellt und Szenarien definiert:

Feature: Login Feature
    Scenario: Successful Login with Valid Credentials
        Given I am on the login page
        When I enter valid credentials
        Then I should be redirected to the dashboard

Diese Feature-Datei beschreibt einen grundlegenden Anmeldeprozess. Given legt die Szene für den Test fest. When beschreibt die Aktion. Then definiert das erwartete Ergebnis. Sie schreiben diese Aussagen in einfachem Englisch. Dies macht es einfach, den Ablauf und den Zweck des Tests zu verstehen.

Tests mit Schrittdefinitionen schreiben

In Specflow werden Tests durch Szenarien angetrieben, die in Feature-Dateien dargelegt sind. Um diese Szenarien ausführbar zu machen, benötigen Sie Schrittdefinitionen. Schrittdefinitionen binden die Schritte in einfacher Sprache an C#-Code. So definieren Sie Schrittdefinitionen:

[Binding]
public class LoginSteps
{
    [Given(@"I am on the login page")]
    public void GivenIAmOnTheLoginPage()
    {
        // Code to navigate to the login page
    }

    [When(@"I enter valid credentials")]
    public void WhenIEnterValidCredentials()
    {
        // Code to input username and password
    }

    [Then(@"I should be redirected to the dashboard")]
    public void ThenIShouldBeRedirectedToTheDashboard()
    {
        // Code to verify the dashboard is displayed
    }
}

[Binding]
public class LoginSteps
{
    [Given(@"I am on the login page")]
    public void GivenIAmOnTheLoginPage()
    {
        // Code to navigate to the login page
    }

    [When(@"I enter valid credentials")]
    public void WhenIEnterValidCredentials()
    {
        // Code to input username and password
    }

    [Then(@"I should be redirected to the dashboard")]
    public void ThenIShouldBeRedirectedToTheDashboard()
    {
        // Code to verify the dashboard is displayed
    }
}

Diese C#-Klasse repräsentiert die Schritte des Anmeldeszenarios. Jede Methode ist mit einem Specflow-Attribut markiert, das dem Schritttyp entspricht, z.B. einem Zeichenfolgeschlüssel zur Identifizierung spezifischer Schritte.

Datengetriebenes Testen

Specflow unterstützt datengetriebene Tests, indem es Ihnen ermöglicht, verschiedene Testsätze in Ihren Szenarien zu nutzen. Dadurch können Sie Szenarien mit verschiedenen Datensätzen testen. Hier ist ein Beispiel für die Tabelle in einer Feature-Datei:

Scenario: Login with multiple users
    Given I am on the login page
    When I login with the following credentials:
        | Username  | Password |
        | user1     | pass1    |
        | user2     | pass2    |
    Then I should see user specific dashboard

In Ihren Schrittdefinitionen können Sie auf diese Daten wie folgt zugreifen:

[When(@"I login with the following credentials:")]
public void WhenILoginWithTheFollowingCredentials(Table table)
{
    foreach(var row in table.Rows)
    {
        string username = row["Username"];
        string password = row["Password"];
        // Code to perform login
    }
}

[When(@"I login with the following credentials:")]
public void WhenILoginWithTheFollowingCredentials(Table table)
{
    foreach(var row in table.Rows)
    {
        string username = row["Username"];
        string password = row["Password"];
        // Code to perform login
    }
}

Integration mit Test Explorer

Specflow integriert sich in den Test-Explorer von Visual Studio, wo Sie alle Tests effizient ausführen und verwalten können. Dies erleichtert das Ausführen und Verwalten Ihrer Tests. Stellen Sie sicher, dass Ihr Projekt richtig konfiguriert ist. Ihre Tests erscheinen im Test-Explorer, sobald Sie das Projekt erstellen. Sie können einzelne Tests oder alle Tests auf einmal ausführen.

Parallele Testdurchführung

Specflow unterstützt das Ausführen von parallelen Tests, um die Gesamtausführungszeit zu verkürzen. Dies reduziert die Zeit, die für die Ausführung aller Tests benötigt wird. Sie müssen Ihre specflow.json-Datei oder AssemblyInfo.cs konfigurieren, um die parallele Ausführung zu aktivieren:

{
  "specFlow": {
    "runtime": {
      "testThreadCount": 4,
      "testSchedulingMode": "Parallel"
    }
  }
}

Diese Konfiguration ermöglicht es, bis zu vier Tests gleichzeitig auszuführen.

Benutzerdefinierte Hooks

Mit Specflow können Sie benutzerdefinierte Hooks definieren. Diese Hooks können zu verschiedenen Zeitpunkten im Testlebenszyklus Code ausführen. So definieren Sie einen Hook für die Einrichtung einer Datenbank, bevor Tests ausgeführt werden:

[BeforeTestRun]
public static void SetUpDatabase()
{
    // Code to set up database
}

[BeforeTestRun]
public static void SetUpDatabase()
{
    // Code to set up database
}

Benutzerdefinierte Hooks sind eine leistungsstarke Funktion. Sie helfen Ihnen, Testeinrichtungs- und Abbauprozesse zu verwalten.

In diesem Abschnitt wurden fünf wichtige Funktionen von Specflow behandelt, die Ihr Testframework in .NET-Projekten verbessern können. Jede Funktion ist darauf ausgelegt, die Flexibilität und Effizienz Ihrer Testautomatisierungsbemühungen zu verbessern.

Benutzungsfall der Zusammenführung von IronPDF mit Specflow C#

Ein praktischer Anwendungsfall für die Kombination von IronPDF mit Specflow ist die Validierung der Inhalte und der Formatierung eines von Ihrer Anwendung generierten PDF-Berichts. So können Sie beispielsweise automatisch testen, ob ein Bericht die korrekten Daten enthält, dem erwarteten Layout entspricht und den festgelegten Anforderungen entspricht. Diese Integration erweist sich besonders in Szenarien als nützlich, in denen genaue Dokumentationen wie Rechnungen oder Konformitätsberichte entscheidend sind.

Stellen Sie sicher, dass Sie IronPDF installiert haben. Sie können es mit der NuGet-Paketkonsole installieren:

Install-Package IronPdf

Codebeispiel für den Anwendungsfall

Hier ist ein vollständiges Codebeispiel, das zeigt, wie Sie eine Specflow-Schrittdefinition einrichten, um PDF-Inhalte mit IronPDF zu testen. Dieses Beispiel geht davon aus, dass Sie ein von Ihrer Anwendung generiertes PDF-Dokument testen, das einen bestimmten Text enthalten sollte:

using IronPdf;
using TechTalk.SpecFlow;

[Binding]
public class PdfContentSteps
{
    private string? _pdfPath;
    private PdfDocument? _pdfDocument;

    [Given(@"a PDF file generated at '(.*)'")]
    public void GivenAPDFFileGeneratedAt(string pdfPath)
    {
        _pdfPath = pdfPath;
        _pdfDocument = new PdfDocument(_pdfPath);
    }

    [Then(@"the PDF should contain the text '(.*)'")]
    public void ThenThePDFShouldContainTheText(string expectedText)
    {
        // Extract text from the PDF and check if it contains the expected text
        var textContent = _pdfDocument.ExtractAllText();
        if (!textContent.Contains(expectedText))
        {
            throw new Exception("PDF content does not contain the expected text.");
        }
    }
}

using IronPdf;
using TechTalk.SpecFlow;

[Binding]
public class PdfContentSteps
{
    private string? _pdfPath;
    private PdfDocument? _pdfDocument;

    [Given(@"a PDF file generated at '(.*)'")]
    public void GivenAPDFFileGeneratedAt(string pdfPath)
    {
        _pdfPath = pdfPath;
        _pdfDocument = new PdfDocument(_pdfPath);
    }

    [Then(@"the PDF should contain the text '(.*)'")]
    public void ThenThePDFShouldContainTheText(string expectedText)
    {
        // Extract text from the PDF and check if it contains the expected text
        var textContent = _pdfDocument.ExtractAllText();
        if (!textContent.Contains(expectedText))
        {
            throw new Exception("PDF content does not contain the expected text.");
        }
    }
}

In diesem Code definieren wir einen Specflow-Schritt, der zuerst ein PDF von einem angegebenen Pfad lädt und dann überprüft, dass dieses PDF den erwarteten Text enthält. Die IronPdf.PdfDocument-Klasse wird verwendet, um die PDF-Datei zu laden und zu bearbeiten. Diese Einrichtung ermöglicht es Ihnen, die PDF-Validierung in Ihre automatisierten Tests zu integrieren, was es einfacher macht, Fehler zu erkennen.