在 .NET 專案中設定 Specflow

若要開始在您的 .NET 專案中使用 Specflow，您首先需要安裝 Specflow NuGet 套件，以設定您的測試框架、建立功能檔案以及定義測試情境。

1.開啟 Visual Studio。 2.建立新的 .NET 專案或開啟現有的專案。 3.移至 Extensions 功能表，然後選取 Manage Extensions。 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

與 Test Explorer 整合

Specflow 與 Visual Studio 的 Test Explorer 整合，您可以在其中有效率地執行和管理所有測試。 這可讓您輕鬆執行和管理測試。 確保您的專案配置正確。 一旦您建立專案，您的測試就會出現在 Test Explorer 中。 您可以執行單獨測試或一次執行所有測試。

平行測試執行

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 專案中的測試框架。 每個功能的設計都是為了提高您測試自動化工作的彈性和效率。

Use Case of Merging IronPDF with 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 驗證整合到自動化測試中，從而更容易捕獲錯誤。