如何在SpecFlow Playwright C#中实现可运行时配置的跨浏览器测试

1. 定义配置模型类 #

对应你的自定义JSON结构，创建C#实体类，方便序列化读取配置：

public class BrowserConfig
{
    public List<BrowserType> BrowserTypes { get; set; }
    public List<string> DefaultBrowser { get; set; }
    public string DefaultEnvironment { get; set; }
}

public class BrowserType
{
    public string BrowserName { get; set; }
    public List<string> OS { get; set; }
}

2. 读取自定义配置文件 #

写个工具类读取你的浏览器配置和specflow.actions.json配置：

public static class ConfigReader
{
    public static BrowserConfig GetBrowserConfig()
    {
        var configPath = Path.Combine(AppContext.BaseDirectory, "browser-config.json"); // 替换为你的自定义JSON文件名
        var jsonContent = File.ReadAllText(configPath);
        return JsonSerializer.Deserialize<BrowserConfig>(jsonContent);
    }

    public static SpecFlowActionsConfig GetSpecFlowActionsConfig()
    {
        var configPath = Path.Combine(AppContext.BaseDirectory, "specflow.actions.json");
        var jsonContent = File.ReadAllText(configPath);
        return JsonSerializer.Deserialize<SpecFlowActionsConfig>(jsonContent);
    }
}

// 对应specflow.actions.json的模型
public class SpecFlowActionsConfig
{
    public TargetConfig Target { get; set; }
}

public class TargetConfig
{
    public int DefaultTimeout { get; set; }
    public bool Headless { get; set; }
    public string TraceDir { get; set; }
}

3. 用SpecFlow Hooks动态配置浏览器 #

在Hooks类中，结合运行时参数和配置，动态启动对应浏览器/设备：

[Binding]
public class BrowserHooks
{
    private readonly IPlaywright _playwright;
    private readonly BrowserConfig _browserConfig;
    private readonly SpecFlowActionsConfig _actionsConfig;
    private IBrowser _browser;
    private IBrowserContext _context;

    // 从环境变量获取运行时指定的浏览器和OS，未传则用默认值
    private readonly string _targetBrowser = Environment.GetEnvironmentVariable("TEST_BROWSER") ?? "Chrome";
    private readonly string _targetOS = Environment.GetEnvironmentVariable("TEST_OS") ?? "Win10_Chrome";

    public BrowserHooks(IPlaywright playwright)
    {
        _playwright = playwright;
        _browserConfig = ConfigReader.GetBrowserConfig();
        _actionsConfig = ConfigReader.GetSpecFlowActionsConfig();
    }

    [BeforeScenario]
    public async Task SetupBrowser()
    {
        // 从specflow.actions.json读取基础配置
        var browserOptions = new BrowserTypeLaunchOptions
        {
            Headless = _actionsConfig.Target.Headless,
            DefaultTimeout = _actionsConfig.Target.DefaultTimeout * 1000 // 转换为毫秒
        };

        // 根据目标浏览器启动对应实例
        switch (_targetBrowser.ToLower())
        {
            case "chrome":
                _browser = await _playwright.Chromium.LaunchAsync(browserOptions);
                break;
            case "edge":
                // 指定Edge渠道启动
                _browser = await _playwright.Chromium.LaunchAsync(browserOptions with { Channel = "msedge" });
                break;
            case "mobile":
                // 根据OS选择对应移动设备
                var device = _targetOS switch
                {
                    "IOS_Chrome" => _playwright.Devices["iPhone 14 Pro"],
                    "Android_Chrome" => _playwright.Devices["Pixel 7"],
                    _ => _playwright.Devices["iPhone 14 Pro"]
                };
                _browser = await _playwright.Chromium.LaunchAsync(browserOptions);
                _context = await _browser.NewContextAsync(device);
                break;
            default:
                _browser = await _playwright.Chromium.LaunchAsync(browserOptions);
                break;
        }

        // 非移动设备创建默认上下文
        if (_context == null)
        {
            _context = await _browser.NewContextAsync();
        }

        // 将上下文注入ScenarioContext，供测试步骤使用
        ScenarioContext.Current.Set(_context);
    }

    [AfterScenario]
    public async Task TeardownBrowser()
    {
        await _context?.CloseAsync();
        await _browser?.CloseAsync();
    }
}

4. 运行时指定浏览器和OS #

通过环境变量传递参数，命令行运行示例：

# Windows环境：运行Chrome + Win10_Chrome
set TEST_BROWSER=Chrome&&set TEST_OS=Win10_Chrome&&dotnet test

# Windows环境：运行Mobile + IOS_Chrome
set TEST_BROWSER=Mobile&&set TEST_OS=IOS_Chrome&&dotnet test

# Linux/Mac环境：运行Edge + Win10_Chrome
export TEST_BROWSER=Edge&&export TEST_OS=Win10_Chrome&&dotnet test

5. 批量运行多组合（可选） #

如果要一次性跑所有配置的浏览器/OS组合，可以用SpecFlow的ScenarioOutline加Examples：

Feature: 跨浏览器测试
    验证不同浏览器和操作系统下的页面行为

Scenario Outline: 页面访问验证
    Given 我打开<Browser>浏览器（<OS>环境）
    When 我访问测试首页
    Then 页面标题应该包含"测试平台"

Examples:
    | Browser | OS               |
    | Chrome  | Win10_Chrome     |
    | Chrome  | Win11_Chrome     |
    | Chrome  | Mac              |
    | Edge    | Win10_Chrome     |
    | Mobile  | IOS_Chrome       |
    | Mobile  | Android_Chrome   |

之后在步骤方法中直接获取Browser和OS参数，替换Hooks里的环境变量逻辑即可。

内容的提问来源于stack exchange，提问作者Kanchan Sharma