#ctx.off()

移除通过 ctx.on(eventName, handler) 注册的事件监听。常与 ctx.on 配合使用，在适当时机取消订阅，避免内存泄漏或重复触发。

#适用场景

#类型定义

off(eventName: string, handler: (event?: any) => void): void;

#示例

#React useEffect 中配对使用

React.useEffect(() => {
  const handler = (ev) => setValue(ev?.detail ?? '');
  ctx.on('js-field:value-change', handler);
  return () => ctx.off('js-field:value-change', handler);
}, []);

#资源事件取消订阅

const handler = () => { /* ... */ };
ctx.resource?.on('refresh', handler);
// 适当时机
ctx.resource?.off('refresh', handler);

#注意事项

1. handler 引用一致：ctx.off 时传入的 handler 必须与 ctx.on 时是同一引用，否则无法正确移除。
2. 及时清理：在组件卸载或 context 销毁前调用 ctx.off，避免内存泄漏。

#相关文档

• ctx.on - 订阅事件
• ctx.resource - 资源实例及其 on/off