feat(LoadModeByName): add LoadModuleByName extension method (#5286)

* refactor: 过滤掉超时异常

* refactor: 更新代码

* test: 更新单元测试

* refactor: 增加 LoadModuleByName 扩展方法

* refactor: 使用新的扩展方法减少代码

* refactor: 重构代码

* refactor: 设置方法为公开

Author: ArgoZhang

src/BootstrapBlazor/Components/Validate/ValidateBase.cs

@@ -485,7 +485,7 @@ public virtual void ToggleMessage(IEnumerable<ValidationResult> results)
 
     private JSModule? ValidateModule { get; set; }
 
-    private Task<JSModule> LoadValidateModule() => JSRuntime.LoadModule("./_content/BootstrapBlazor/modules/validate.js");
+    private Task<JSModule> LoadValidateModule() => JSRuntime.LoadModuleByName("validate");
 
     /// <summary>
     /// 增加客户端 Tooltip 方法

src/BootstrapBlazor/Components/WebSpeech/WebSpeechService.cs

@@ -10,7 +10,7 @@ namespace BootstrapBlazor.Components;
 /// <summary>
 /// Web Speech 服务
 /// </summary>
-public class WebSpeechService(IJSRuntime runtime, IComponentIdGenerator ComponentIdGenerator, ILogger<WebSpeechService> logger)
+public class WebSpeechService(IJSRuntime runtime, IComponentIdGenerator ComponentIdGenerator)
 {
     private JSModule? SynthesisModule { get; set; }
 
@@ -24,9 +24,7 @@ public async Task<WebSpeechSynthesizer> CreateSynthesizerAsync()
     {
         if (SynthesisModule == null)
         {
-            var moduleName = "./_content/BootstrapBlazor/modules/synthesis.js";
-            logger.LogInformation("load module {moduleName}", moduleName);
-            SynthesisModule = await runtime.LoadModule(moduleName);
+            SynthesisModule = await runtime.LoadModuleByName("synthesis");
         }
         return new WebSpeechSynthesizer(SynthesisModule, ComponentIdGenerator);
     }
@@ -39,9 +37,7 @@ public async Task<WebSpeechRecognition> CreateRecognitionAsync()
     {
         if (RecognitionModule == null)
         {
-            var moduleName = "./_content/BootstrapBlazor/modules/recognition.js";
-            logger.LogInformation("load module {moduleName}", moduleName);
-            RecognitionModule = await runtime.LoadModule(moduleName);
+            RecognitionModule = await runtime.LoadModuleByName("recognition");
         }
         return new WebSpeechRecognition(RecognitionModule, ComponentIdGenerator);
     }

src/BootstrapBlazor/Extensions/JSModuleExtensions.cs

@@ -16,10 +16,23 @@ public static class JSModuleExtensions
     /// <param name="jsRuntime"></param>
     /// <param name="version"></param>
     /// <returns>A <see cref="Task"/><![CDATA[<]]><see cref="JSModule"/><![CDATA[>]]> 模块加载器</returns>
-    public static Task<JSModule> LoadUtility(this IJSRuntime jsRuntime, string? version = null) => LoadModule(jsRuntime, "./_content/BootstrapBlazor/modules/utility.js", version);
+    public static Task<JSModule> LoadUtility(this IJSRuntime jsRuntime, string? version = null) => LoadModuleByName(jsRuntime, "utility", version);
 
     /// <summary>
-    /// IJSRuntime 扩展方法 动态加载脚本 脚本目录为 modules
+    /// 通过名称导入内置脚本模块
+    /// </summary>
+    /// <param name="jsRuntime"></param>
+    /// <param name="moduleName"></param>
+    /// <param name="version"></param>
+    /// <returns>A <see cref="Task"/><![CDATA[<]]><see cref="JSModule"/><![CDATA[>]]> 模块加载器</returns>
+    public static Task<JSModule> LoadModuleByName(this IJSRuntime jsRuntime, string moduleName, string? version = null)
+    {
+        var fileName = $"./_content/BootstrapBlazor/modules/{moduleName}.js";
+        return LoadModule(jsRuntime, fileName, version);
+    }
+
+    /// <summary>
+    /// IJSRuntime 扩展方法 动态加载脚本
     /// </summary>
     /// <param name="jsRuntime"></param>
     /// <param name="fileName"></param>

src/BootstrapBlazor/Services/AjaxService.cs

@@ -15,7 +15,7 @@ public class AjaxService(IJSRuntime jSRuntime)
     [NotNull]
     private JSModule? _module = null;
 
-    private Task<JSModule> LoadModule() => jSRuntime.LoadModule("./_content/BootstrapBlazor/modules/ajax.js");
+    private Task<JSModule> LoadModule() => jSRuntime.LoadModuleByName("ajax");
 
     /// <summary>
     /// 调用Ajax方法发送请求

src/BootstrapBlazor/Services/Bluetooth/DefaultBluetooth.cs

@@ -44,7 +44,7 @@ public DefaultBluetooth(IJSRuntime jsRuntime)
 
     private async Task<JSModule> LoadModule()
     {
-        var module = await _runtime.LoadModule("./_content/BootstrapBlazor/modules/bt.js");
+        var module = await _runtime.LoadModuleByName("bt");
 
         IsSupport = await module.InvokeAsync<bool>("init");
         return module;

src/BootstrapBlazor/Services/ClipboardService.cs

@@ -13,7 +13,7 @@ public class ClipboardService(IJSRuntime jSRuntime)
     [NotNull]
     private JSModule? _module = null;
 
-    private Task<JSModule> LoadModule() => jSRuntime.LoadModule("./_content/BootstrapBlazor/modules/utility.js");
+    private Task<JSModule> LoadModule() => jSRuntime.LoadUtility();
 
     /// <summary>
     /// 获取剪切板数据方法

src/BootstrapBlazor/Services/DefaultBrowserFingerService.cs

@@ -13,14 +13,12 @@ class DefaultBrowserFingerService(IJSRuntime jSRuntime) : IBrowserFingerService
     [NotNull]
     private JSModule? _module = null;
 
-    private Task<JSModule> LoadModule() => jSRuntime.LoadModule("./_content/BootstrapBlazor/modules/utility.js");
-
     /// <summary>
     /// 获取剪切板数据方法
     /// </summary>
     public async Task<string?> GetFingerCodeAsync(CancellationToken token = default)
     {
-        _module ??= await LoadModule();
+        _module ??= await jSRuntime.LoadUtility();
         return await _module.InvokeAsync<string?>("getFingerCode", token);
     }
 }

src/BootstrapBlazor/Services/DefaultGeoLocationService.cs

@@ -28,7 +28,7 @@ public DefaultGeoLocationService(IJSRuntime jsRuntime)
         Interop = DotNetObjectReference.Create(this);
     }
 
-    private Task<JSModule> LoadModule() => JSRuntime.LoadModule("./_content/BootstrapBlazor/modules/geo.js");
+    private Task<JSModule> LoadModule() => JSRuntime.LoadModuleByName("geo");
 
     /// <summary>
     /// get the current position of the device

src/BootstrapBlazor/Services/EyeDropperService.cs

@@ -19,7 +19,7 @@ public class EyeDropperService(IJSRuntime jSRuntime)
     /// <returns></returns>
     public async Task<string?> PickAsync(CancellationToken token = default)
     {
-        _module ??= await jSRuntime.LoadModule("./_content/BootstrapBlazor/modules/eye-dropper.js");
+        _module ??= await jSRuntime.LoadModuleByName("eye-dropper");
         return await _module.InvokeAsync<string?>("open", token);
     }
 }

src/BootstrapBlazor/Services/FullScreenService.cs

@@ -21,7 +21,7 @@ public class FullScreenService(IJSRuntime jSRuntime)
     /// <returns></returns>
     public async Task Toggle(FullScreenOption? option = null, CancellationToken token = default)
     {
-        _module ??= await jSRuntime.LoadModule("./_content/BootstrapBlazor/modules/fullscreen.js");
+        _module ??= await jSRuntime.LoadModuleByName("fullscreen");
         await _module.InvokeVoidAsync("toggle", token, option);
     }
 }