feat(butil): add custom string input feature to UserAgent api of Butil #11548 (#11549)

Author: msynk

src/Butil/Bit.Butil/Publics/UserAgent.cs

@@ -13,8 +13,8 @@ public class UserAgent(IJSRuntime js)
     /// Extracts the user agent properties from the browser or web-view.
     /// </summary>
     [DynamicDependency(DynamicallyAccessedMemberTypes.All, typeof(UserAgentProperties))]
-    public async ValueTask<UserAgentProperties> Extract()
+    public async ValueTask<UserAgentProperties> Extract(string? userAgentString = null)
     {
-        return await js.Invoke<UserAgentProperties>("BitButil.userAgent.extract");
+        return await js.Invoke<UserAgentProperties>("BitButil.userAgent.extract", userAgentString);
     }
 }

src/Butil/Bit.Butil/Scripts/userAgent.ts

@@ -5,9 +5,9 @@ var BitButil = BitButil || {};
         extract,
     };
 
-    function extract() {
+    function extract(userAgentString?: string) {
         var nav = window.navigator;
-        var ua = nav.userAgent || '';
+        var ua = userAgentString || nav.userAgent || '';
 
         var opera = (window as any).operamini || (window as any).opera;
         var brave = (nav as any).brave;
@@ -423,7 +423,7 @@ var BitButil = BitButil || {};
         if (description.length) {
             userAgentProps.description = description.join(' ');
         }
-        
+
         return userAgentProps;
 
         function getLayout(guesses) {

src/Butil/Demo/Bit.Butil.Demo.Core/Pages/UserAgentPage.razor

@@ -24,15 +24,18 @@
 <hr />
 <br />
 
+<input @bind="userAgentString" />
 <button @onclick="Extract">Extract</button>
 
 <br />
 <br />
 
 @code {
-    private async Task Extract()
+	private string? userAgentString;
+
+	private async Task Extract()
     {
-        var userAgentProps = await userAgent.Extract();
+        var userAgentProps = await userAgent.Extract(userAgentString);
         await console.Log("UserAgent properties:", userAgentProps);
     }
 }