Blazor中JS完成时通知C#的核心是JS主动回调：用DotNetObjectReference包装C#方法传给JS，JS执行完后调用该引用上的[JSInvokable]方法；或JS返回Promise，C#用InvokeAsync await获取结果。
Blazor 中 JS 完成时获得通知，核心是利用 IJSRuntime.InvokeVoidAsync 调用 JS 函数，并在 JS 里通过 .NET 对象回调（即 JS 传回结果给 C#）。关键不是“等 JS 执行完”，而是“JS 主动通知 C# 完成了”。
用 DotNetObjectReference 从 JS 回调 C# 方法
这是最常用、最可靠的方式。C# 先把一个可被 JS 调用的方法包装成 DotNetObjectReference，再传给 JS；JS 在完成操作后，直接调用这个引用上的方法，触发 C# 端逻辑。
- C# 端：在组件中创建回调方法并生成引用
@inject IJSRuntime JSRuntime
@implements IDisposable
@code {
private DotNetObjectReference<Counter>? objRef;
protected override void OnInitialized() {
objRef = DotNetObjectReference.Create(this);
JSRuntime.InvokeVoidAsync("setupJsTask", objRef);
}
[JSInvokable]
public void OnJsFinished(string result) {
Console.WriteLine($"JS 已完成，返回：{result}");
StateHasChanged();
}
public void Dispose() => objRef?.Dispose();
}
- JS 端：接收引用，执行完后调用它
window.setupJsTask = (dotNetHelper) => {
// 模拟异步操作（如 fetch、动画、第三方 SDK 初始化）
setTimeout(() => {
dotNetHelper.invokeMethodAsync('OnJsFinished', '加载成功');
}, 1000);
};
用 Promise + InvokeAsync 获取 JS 返回值（适合简单同步/异步结果）
如果 JS 函数本身返回 Promise，C# 可直接 await 它，拿到 resolve 的值。适用于 JS 逻辑明确、不需复杂状态管理的场景。
- JS 端返回 Promise
window.doSomethingAsync = () => {
return new Promise((resolve) => {
setTimeout(() => resolve("JS 处理完毕"), 800);
});
};
- C# 端 await 调用，自动等待完成
var result = await JSRuntime.InvokeAsync<string>("doSomethingAsync");
Console.WriteLine(result); // 输出：JS 处理完毕
注意生命周期和内存泄漏
使用 DotNetObjectReference 时，必须在组件销毁时调用 Dispose()，否则 JS 会持有对 .NET 对象的强引用，导致内存泄漏。
- 务必实现
IDisposable并释放objRef - 避免在 JS 中长期缓存
DotNetObjectReference（比如挂到 window 上） - 若 JS 需多次回调，确保 C# 方法是线程安全的（Blazor Server 下可能跨 SignalR 连接）
基本上就这些。核心就两条路：JS 主动回调（推荐用于复杂流程），或 C# await JS Promise（适合轻量交互）。选哪个取决于你的 JS 逻辑是否可控、是否需要中间状态、以及是否要复用回调。
