Blazor 怎么在JS完成时获得通知

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? 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 端:接收引用,执行完后调用它
// wwwroot/js/site.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("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 逻辑是否可控、是否需要中间状态、以及是否要复用回调。