#ctx.off()

Entfernt Ereignis-Listener, die über ctx.on(eventName, handler) registriert wurden. Es wird häufig in Verbindung mit ctx.on verwendet, um Abonnements zum richtigen Zeitpunkt zu kündigen und so Speicherlecks oder mehrfache Auslösungen zu vermeiden.

#Anwendungsfälle

#Typdefinition

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

#Beispiele

#Paarweise Verwendung in 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);
}, []);

#Abbestellen von Ressourcen-Ereignissen

const handler = () => { /* ... */ };
ctx.resource?.on('refresh', handler);
// Zum angemessenen Zeitpunkt
ctx.resource?.off('refresh', handler);

#Hinweise

1. Konsistente Handler-Referenz: Der an ctx.off übergebene handler muss dieselbe Referenz sein wie der in ctx.on verwendete; andernfalls kann er nicht korrekt entfernt werden.
2. Rechtzeitige Bereinigung: Rufen Sie ctx.off auf, bevor die Komponente unmountet oder der Kontext zerstört wird, um Speicherlecks zu vermeiden.

#Verwandte Dokumente

• ctx.on – Ereignisse abonnieren
• ctx.resource – Ressourcen-Instanz und deren on/off-Methoden