如何在Blazor单元测试中模拟浏览器环境的平台限制？

问题描述 #

Blazor WebAssembly应用在浏览器运行时，部分.NET API（如TcpClient.ConnectAsync()）会抛出PlatformNotSupportedException，但默认bUnit单元测试运行在桌面.NET环境，不会触发该异常，导致测试通过但实际运行失败。

解决方案 #

1. 手动模拟不支持API的异常抛出 #

针对明确知晓的浏览器不支持API，直接在测试中模拟其抛出异常的行为，确保测试能捕获平台限制问题。

示例代码：

using Moq;
using Xunit;
using Bunit;

public class MyComponentTests : TestContext
{
    [Fact]
    public async Task WhenCallingUnsupportedApi_ThrowsPlatformNotSupportedException()
    {
        // 模拟TcpClient，让ConnectAsync抛出指定异常
        var mockTcpClient = new Mock<TcpClient>();
        mockTcpClient.Setup(client => client.ConnectAsync(It.IsAny<string>(), It.IsAny<int>()))
                     .ThrowsAsync(new PlatformNotSupportedException());

        // 将模拟实例注入测试上下文（若组件依赖TcpClient）
        Services.AddSingleton(mockTcpClient.Object);

        // 渲染组件并触发调用API的逻辑
        var cut = RenderComponent<MyComponent>();
        cut.Find("button").Click();

        // 根据组件实际逻辑调整断言，比如检查错误提示是否显示
        Assert.Contains("该功能在浏览器环境下不支持", cut.Markup);
    }
}

2. 模拟浏览器平台标识 #

通过修改.NET运行时信息，让代码中的平台检测逻辑判定当前为浏览器环境，从而触发API本身的平台限制判断。

可通过反射修改RuntimeInformation的相关属性（注：反射操作可能受.NET版本限制）：

using System.Runtime.InteropServices;
using System.Reflection;

[Fact]
public async Task SetBrowserPlatformForTest()
{
    // 获取RuntimeInformation的私有字段，修改OS平台标识
    var osPlatformField = typeof(RuntimeInformation).GetField("_osPlatform", BindingFlags.NonPublic | BindingFlags.Static);
    osPlatformField.SetValue(null, OSPlatform.Create("BROWSER"));

    // 此时调用TcpClient.ConnectAsync()会抛出PlatformNotSupportedException
    await Assert.ThrowsAsync<PlatformNotSupportedException>(() => new TcpClient().ConnectAsync("localhost", 8080));
}

3. 依赖抽象而非具体实现 #

重构代码，将依赖的.NET API（如TcpClient）抽象为接口，为浏览器环境提供抛出异常的实现，测试时直接使用该实现：

示例：

// 定义抽象接口
public interface ITcpClientWrapper
{
    Task ConnectAsync(string host, int port);
}

// 浏览器环境实现（抛出异常）
public class BrowserTcpClientWrapper : ITcpClientWrapper
{
    public Task ConnectAsync(string host, int port)
    {
        throw new PlatformNotSupportedException("TCP连接在浏览器环境下不支持");
    }
}

// 测试逻辑
[Fact]
public async Task BrowserImplementation_ThrowsException()
{
    var wrapper = new BrowserTcpClientWrapper();
    await Assert.ThrowsAsync<PlatformNotSupportedException>(() => wrapper.ConnectAsync("localhost", 8080));
}

这种方式符合依赖倒置原则，能确保测试与浏览器运行时使用一致的逻辑。

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