Blazor中JS互操作必须通过IJSRuntime实例，注入后使用InvokeVoidAsync（无返回）或InvokeAsync<T>（有返回），JS函数需挂载到window或显式导出，且脚本须在Blazor启动前加载。
Blazor中调用JS函数必须用 IJSRuntime
Blazor Server 和 WebAssembly 都不支持直接执行 JS 字符串或通过 window.xxx() 调用，所有 JS 互操作必须走 IJSRuntime 实例。注入方式是：@inject IJSRuntime JSRuntime。别试图用 Microsoft.JSInterop.IJSInProcessRuntime（仅 WebAssembly 可用且已过时），也别在组件构造函数里调用 JS——此时 JSRuntime 还未注入完成。
InvokeVoidAsync 和 InvokeAsync<T> 的选择依据
调用无返回值的 JS 函数用 InvokeVoidAsync；有返回值则用 InvokeAsync<T>，其中 T 必须是 JSON 可序列化的类型（如 string、int、bool 或简单 POCO）。JS 端若返回 Promise，Blazor 会自动 await；若返回普通值，也无需额外包装 Promise。
- JS 中写
return "ok"→ C# 用InvokeAsync<string> - JS 中写
return Promise.resolve(42)→ C# 同样用InvokeAsync<int> - JS 中抛错（
throw new Error("boom")）→ C# 会转为JSException，需 try/catch
JS 函数必须挂载到 window 或显式注册
Blazor 默认只能访问挂载在全局 window 对象上的函数，例如：
window.showAlert = (msg) => alert(msg); window.getTimestamp = () => Date.now();
不推荐直接污染 window，更稳妥的方式是在 wwwroot/index.html（WASM）或 _Host.cshtml（Server）中通过 import 加载模块后显式导出：
立即学习“Java免费学习笔记（深入）”；
import { doSomething } from './interop.js';
window.doSomething = doSomething;注意：JS 文件需在 Blazor 启动前加载（<script> 放在 <body> 底部或使用 defer），否则 InvokeAsync 会报 JavaScript interop calls cannot be issued at this time。
常见错误：异步时机不对、JS 未定义、跨域或 CSP 限制
最常遇到的不是语法错，而是执行环境错位：
-
System.InvalidOperationException: JavaScript interop calls cannot be issued at this time→ 组件尚未渲染完成（比如在OnInitialized里就调 JS），改用OnAfterRenderAsync+firstRender判断，或用StateHasChanged()后延时调用 -
Microsoft.JSInterop.JSException: Could not find 'xxx' in 'window'→ JS 函数名拼错，或脚本未加载成功（检查浏览器控制台 Network 标签页） - 在启用严格 CSP 的站点中，内联脚本或
eval被禁用 → 确保 JS 文件外链加载，避免动态eval式调用
复杂交互（如 DOM 元素引用、事件监听器绑定）建议封装成 JS 模块并统一管理生命周期，而不是每次调用都查 DOM。
