ASP.NET Core 快速轻量级的浏览器检测和设备检测库

在 .NET Framework 4.7 中那样，通过 HttpContext.Request 的 Browser 属性轻松获取发起 HTTP 请求的浏览器信息，ASP.NET Core 并未直接提供这一功能，现在有了 BrowserDetector 这个强大的 NuGet 包，你可以在 ASP.NET Core 应用中轻松实现浏览器、设备类型以及操作系统的检测。
BrowserDetector 支持以下 .NET 框架版本： .NET 6/7/8

如何使用 BrowserDetector

安装 NuGet 包

首先需要安装 BrowserDetector NuGet 包

Install-Package Shyjus.BrowserDetector 

启用浏览器检测服务

在你的启动代码中，调用 IServiceCollection 上的 AddBrowserDetection 方法来启用浏览器检测服务：

services.AddBrowserDetection(); 

注入并使用 IBrowserDetector

接下来，你可以在控制器类、视图文件或中间件中注入 IBrowserDetector，并访问其 Browser 属性来获取浏览器相关信息。

在控制器中的使用示例

public class HomeController : Controller {     private readonly IBrowserDetector browserDetector;      public HomeController(IBrowserDetector browserDetector)     {         this.browserDetector = browserDetector;     }      public IActionResult Index()     {         var browser = this.browserDetector.Browser;         // 按需使用 browser 对象          return View();     } } 

在视图中的使用示例

@inject Shyjus.BrowserDetection.IBrowserDetector browserDetector  <h2>@browserDetector.Browser.Name</h2> <h3>@browserDetector.Browser.Version</h3> <h3>@browserDetector.Browser.OS</h3> <h3>@browserDetector.Browser.DeviceType</h3> 

在自定义中间件中的使用

你还可以将 IBrowserDetector 注入到中间件的 InvokeAsync 方法中

public class MyCustomMiddleware {     private RequestDelegate next;      public MyCustomMiddleware(RequestDelegate next)     {         this.next = next;     }      public async Task InvokeAsync(HttpContext httpContext, IBrowserDetector browserDetector)     {         var browser = browserDetector.Browser;          if (browser.Type == BrowserType.Edge)         {             await httpContext.Response.WriteAsync("Have you tried the new chromuim based edge ?");         }         else         {             await this.next.Invoke(httpContext);         }     } } 

解读 IBrowserDetector.Name 返回的名称值

IBrowserDetector.Name 返回的名称值具有特定含义，以下是常见名称的解释：

• Firefox：Firefox 浏览器。
• EdgeChromium：基于 Chromium 的新版 Microsoft Edge 浏览器。
• Edge：旧版 Edge 浏览器。
• Safari：Safari 浏览器。
• Chrome：Chrome 浏览器。

性能影响

你可能会关心添加 BrowserDetector 包对应用性能的影响。经过基准测试，在 Safari 和 Chrome 桌面用户代理上的测试结果显示，检测结果的返回时间大约在 1 微秒 左右。堆内存分配会根据输入的不同而有所变化。以下是具体的测试数据：

方法	平均值
Chrome_Windows	1.057 us
Safari_Windows	1.093 us

1 微秒仅相当于一百万分之一秒，这意味着 BrowserDetector 对性能的影响微乎其微，你完全可以放心使用它来为你的 ASP.NET Core Web API 应用增添浏览器检测功能。

仓库地址：https://github.com/kshyju/BrowserDetector