#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. 適切なタイミングでのクリーンアップ: メモリリークを避けるため、コンポーネントのアンマウント時やコンテキストの破棄前に ctx.off を呼び出してください。

#関連ドキュメント

• ctx.on - イベントの購読
• ctx.resource - リソースインスタンスとその on/off メソッド