Overview

Reqnroll based autotest framework

Main features:

• C# expression support inside features
• Test data management framework
• Model transformation framework
• Component framework for UI testing
• Playwright integration

Test example

Feature: CheckoutForm

Scenario: checkout form validation test
    Given navigate to '@Data.Common.HomePageUrl'
    When set following values:
    | Name                  | Value      |
    | checkout > first name | first_name |
    | checkout > last name  | last_name  |
    And click on 'checkout > continue to checkout'
    Then should be visible:
    | Name                              |
    | checkout > username error message |
    And should have following values:
    | Name                              | Value                      |
    | checkout > username error message | Your username is required. |

Requirements

• .NET 8+ (.NET 9 is recommended)
• Visual Studio 2022 or Visual Studio Code
• Reqnroll plugin for Visual Studio 2022 or Cucumber plugin for Visual Studio Code

Nuget packages links

• https://www.nuget.org/packages/AutoTests.Framework
• https://www.nuget.org/packages/AutoTests.Framework.Components
• https://www.nuget.org/packages/AutoTests.Framework.Playwright

How to use

You can find example in Bootstrap.Tests project for UI testing

Basic steps:

1. Create basic unit test project is visual studio
2. Add additional Reqnroll nuget packages:

Nuget package	Link
AutoTests.Framework.Playwright	AutoTests.Framework.Playwright
Microsoft.Playwright	Microsoft.Playwright
Unit Tests framework adapter nuget package	Reqnroll.MsTest or Reqnroll.NUnit or Reqnroll.xUnit

Warning

Version of test adapter nuget package should match to Reqnroll package version

3. Create reqnroll.json and register framework assemblies. Example:

{
  "$schema": "https://schemas.reqnroll.net/reqnroll-config-latest.json",
  "stepAssemblies": [
    { "assembly": "AutoTests.Framework" },
    { "assembly": "AutoTests.Framework.Components" },
    { "assembly": "AutoTests.Framework.Playwright" }
  ]
}

4. Create Application class for UI application

internal sealed class BootstrapApplication : IApplication
{
    [Route("checkout")]
    public Checkout? Checkout { get; set; }
}

How to make browser window visible

By default browser will run in headless mode.

If you need to change this behavior just add BeforeTestRun hook inside your test app and override BrowserTypeLaunchOptions like this:

[Binding]
internal sealed class ReqnrollHooks
{
    [BeforeTestRun(Order = 0)]
    public static void BeforeTestRun(IObjectContainer objectContainer)
    {
        objectContainer.RegisterInstanceAs(new BrowserTypeLaunchOptions { Headless = false });
    }
}

How to work with test data

You can create json file in Data subfolder and get access to content in feature to it like:

Feature: CheckoutForm

Scenario: checkout form validation test
    Given navigate to '@Data.Common.HomePageUrl' #return value HomePageUrl from Data\Common.json

You can find example in 'Bootstrap.Tests'