Konfiguracja Specflow w projektach .NET

Aby zacząć używać Specflow w projektach .NET, najpierw należy zainstalować pakiet NuGet Specflow, aby skonfigurować ramy testowe, tworzyć pliki funkcji i definiować scenariusze testowe.

1. Otwórz program Visual Studio.
2. Utwórz nowy projekt .NET lub otwórz istniejący.
3. Przejdź do menu Rozszerzenia, a następnie Zarządzaj rozszerzeniami.
4. Wyszukaj "Specflow". Zainstaluj rozszerzenie Specflow.

Podstawowy przykład kodu

Po skonfigurowaniu Specflow można utworzyć pierwszy plik funkcji, który zostanie umieszczony w folderze funkcji. Plik funkcji w Specflow opisuje zachowania, które chcesz przetestować, w czytelny sposób. Oto prosty przykład, jak utworzyć nowy plik funkcji i zdefiniować scenariusze:

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

Ten plik funkcji opisuje podstawowy proces logowania. Given ustawia scenę testu. When opisuje działanie. Then definiuje oczekiwane wyniki. Te stwierdzenia piszesz w prostym języku angielskim. To ułatwia zrozumienie przepływu i celu testu.

Pisanie testów z definicjami kroków

W Specflow testy są napędzane przez scenariusze zawarte w plikach funkcji. Aby te scenariusze były wykonane, potrzebujesz definicji kroków. Definicje kroków wiążą proste kroki językowe z kodem C#. Oto jak definiujesz definicje kroków:

[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
    }
}

<Binding>
Public Class LoginSteps
	<Given("I am on the login page")>
	Public Sub GivenIAmOnTheLoginPage()
		' Code to navigate to the login page
	End Sub

	<[When]("I enter valid credentials")>
	Public Sub WhenIEnterValidCredentials()
		' Code to input username and password
	End Sub

	<[Then]("I should be redirected to the dashboard")>
	Public Sub ThenIShouldBeRedirectedToTheDashboard()
		' Code to verify the dashboard is displayed
	End Sub
End Class

Ta klasa C# reprezentuje kroki scenariusza logowania. Każda metoda jest oznaczona atrybutem Specflow odpowiadającym typowi kroku, takim jak klucz string dla identyfikacji określonych kroków.

Testowanie sterowane danymi

Specflow wspiera testowanie sterowane danymi, pozwalając na wykorzystanie różnych zbiorów danych testowych w scenariuszach. To pozwala testować scenariusze z różnymi zestawami danych. Oto przykład użycia tabeli w pliku funkcji:

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

W definicjach kroku możesz uzyskać dostęp do tych danych w następujący sposób:

[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
    }
}

<[When]("I login with the following credentials:")>
Public Sub WhenILoginWithTheFollowingCredentials(ByVal table As Table)
	For Each row In table.Rows
		Dim username As String = row("Username")
		Dim password As String = row("Password")
		' Code to perform login
	Next row
End Sub

Integracja z Explorerem Testów

Specflow integruje się z Exploratoriem Testów Visual Studio, gdzie można efektywnie uruchamiać i zarządzać wszystkimi testami. To ułatwia uruchamianie i zarządzanie testami. Upewnij się, że twój projekt jest poprawnie skonfigurowany. Twoje testy pojawią się w Exploratorze Testów po zbudowaniu projektu. Możesz uruchamiać pojedyncze testy lub wszystkie testy jednocześnie.

Równoległe wykonanie testów

Specflow wspiera uruchamianie testów równolegle, aby skrócić czas wykonania. To zmniejsza czas potrzebny na wykonanie wszystkich testów. Musisz skonfigurować swój plik specflow.json lub AssemblyInfo.cs, aby umożliwić równoległe wykonanie:

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

Ta konfiguracja pozwala na jednoczesne uruchamianie do czterech testów.

Własne zaczepy

Specflow pozwala na definiowanie własnych zaczepów. Te zaczepy mogą wykonywać kod w różnych punktach cyklu życia testów. Oto jak możesz zdefiniować zaczep do skonfigurowania bazy danych przed uruchomieniem jakichkolwiek testów:

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

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

<BeforeTestRun>
Public Shared Sub SetUpDatabase()
	' Code to set up database
End Sub

Własne zaczepy to potężna funkcja. Pomagają w zarządzaniu procesami konfiguracji i likwidacji testów.

Ta sekcja obejmowała pięć kluczowych funkcji Specflow, które mogą poprawić twoją ramę testową w projektach .NET. Każda funkcja jest zaprojektowana, aby poprawić elastyczność i efektywność twoich wysiłków w automatyzacji testów.

Use Case of Merging IronPDF with Specflow C

Praktyczny przypadek użycia kombinacji IronPDF ze Specflow to walidacja zawartości i formatowania raportu PDF generowanego przez twoją aplikację. Na przykład, można automatycznie testować, czy raport zawiera prawidłowe dane, spełnia oczekiwany układ i jest dostępny w ramach określonych wymagań. Ta integracja jest szczególnie przydatna w sytuacjach, gdy dokładna dokumentacja, taka jak faktury lub raporty zgodności, jest kluczowa.

Upewnij się, że zainstalowałeś IronPDF. Można go zainstalować przy użyciu konsoli pakietów NuGet:

Install-Package IronPdf

Przykład kodu przypadku użycia

Oto kompletny przykład kodu, który pokazuje, jak skonfigurować definicję kroku SpecFlow do testowania zawartości PDF przy użyciu IronPDF. Ten przykład zakłada, że testujesz dokument PDF generowany przez twoją aplikację, który powinien zawierać określony tekst:

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.");
        }
    }
}

Imports IronPdf
Imports TechTalk.SpecFlow

<Binding>
Public Class PdfContentSteps
'INSTANT VB WARNING: Nullable reference types have no equivalent in VB:
'ORIGINAL LINE: private string? _pdfPath;
	Private _pdfPath As String
	Private _pdfDocument? As PdfDocument

	<Given("a PDF file generated at '(.*)'")>
	Public Sub GivenAPDFFileGeneratedAt(ByVal pdfPath As String)
		_pdfPath = pdfPath
		_pdfDocument = New PdfDocument(_pdfPath)
	End Sub

	<[Then]("the PDF should contain the text '(.*)'")>
	Public Sub ThenThePDFShouldContainTheText(ByVal expectedText As String)
		' Extract text from the PDF and check if it contains the expected text
		Dim textContent = _pdfDocument.ExtractAllText()
		If Not textContent.Contains(expectedText) Then
			Throw New Exception("PDF content does not contain the expected text.")
		End If
	End Sub
End Class

W tym kodzie definiujemy krok Specflow, który najpierw ładuje PDF z określonej ścieżki, a następnie weryfikuje, że ten PDF zawiera oczekiwany tekst. Klasa IronPdf.PdfDocument służy do ładowania i manipulowania plikiem PDF. Ta konfiguracja pozwala na integrację walidacji PDF w twoich testach automatycznych, ułatwiając wykrywanie błędów.