在 .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

自定义钩子是一个强大的功能。 它们帮助您管理测试设置和拆卸过程。

本节介绍了五个关键功能，这些功能可以增强 .NET 项目中的 Specflow 测试框架。 每个功能都旨在提高测试自动化工作的灵活性和效率。

合并 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 验证集成到自动化测试中，使捕获错误变得更容易。