在 .NET 專案中設定 Specflow

要在 .NET 專案中開始使用 Specflow，首先需要安裝 Specflow 的 NuGet 套件以設置測試框架、創建功能文件和定義測試場景。

1. 打開 Visual Studio。
2. 創建一個新的 .NET 專案或打開一個現有的專案。
3. 轉到擴展功能選單，然後選擇管理擴展功能。
4. 搜尋“Specflow”。 安裝 Specflow 擴展功能。

基本代碼範例

一旦設置好 Specflow，您可以創建您的第一個功能文件，它將位於功能夾中。 在 Specflow 中，功能文件以可讀格式概述了您要測試的行為。 這裡有一個簡單的示例，說明如何創建新的功能文件並定義場景：

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

此功能文件描述了基本的登錄過程。 Given 為測試設置場景。When 描述操作。 Then 定義預期結果。 您可以用簡單的英語書寫這些語句。 這使得理解測試的流程和目的變得簡單。

使用步驟定義編寫測試

在 Specflow 中，測試由功能文件中概述的場景驅動。 要使這些場景可執行，您需要步驟定義。 步驟定義將簡單語言步驟綁定到 C# 代碼。 以下是定義步驟定義的方法：

[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

這個 C# 類表示登錄場景的步驟。 每個方法都標有 Specflow 屬性，對應於步驟類型，例如用於識別特定步驟的字符串鍵。

資料驅動測試

Specflow 支援資料驅動測試，允許您在場景中使用各種測試數據集。 這使您可以用不同資料集測試場景。 以下是在功能文件中使用表格的示例：

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

在步驟定義中，您可以這樣訪問該數據：

[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

與測試資源管理器整合

Specflow 與 Visual Studio 的測試資源管理器整合，您可以在其中高效地運行和管理所有測試。 這使得運行和管理測試變得容易。 確保專案正確配置。 一旦構建專案，您的測試將出現在測試資源管理器中。 您可以一次運行單個測試或所有測試。

並行測試執行

Specflow 支援運行並行測試以減少整體執行時間。這減少了執行所有測試的時間。 您需要配置 specflow.json 文件或 AssemblyInfo.cs 以啟用並行執行：

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

這種配置允許同時運行最多四個測試。

自定義釘子

Specflow 允許您定義自定義釘子。 這些釘子可以在測試生命週期的各個階段執行代碼。 以下是您如何為在運行任何測試前設置資料庫定義釘子的方法：

[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

自定義釘子是一個強大的功能。 它們幫助您管理測試設置和拆解過程。

本節涵蓋了五個 Specflow 的關鍵功能，可以增強您在 .NET 專案中的測試框架。 每個功能都旨在提高您的測試自動化工作量的靈活性和效率。

融合 IronPDF 與 Specflow C♯ 的用例

將 IronPDF 與 Specflow 結合使用的一個實際用例是驗證您的應用程式生成的 PDF 報告的內容和格式。 例如，您可以自動化測試報告中是否包含正確的數據，符合預期的布局，並且可在規定的要求範圍內訪問。 在需要精確文檔（如發票或合規報告）的場合，此整合尤其有用。

確保已安裝 IronPDF。 您可以使用 NuGet 套件控制台安裝它：

Install-Package IronPdf

用例的代碼示例

這裡有一個完整的代碼示例，展示了如何設置 SpecFlow 步驟定義來使用 IronPDF 測試 PDF 內容。 假設您正在測試的 PDF 文檔應包含特定文本：

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

在這段代碼中，我們定義一個 Specflow 步驟，首先從指定路徑加載 PDF，然後確認該 PDF 包含預期文本。 IronPdf.PdfDocument 類被用來加載和操作 PDF 文件。這個設置讓您能夠將 PDF 驗證整合到自動化測試中，使得更容易捕捉錯誤。