KI-Übersetzungshinweis

Dieses Dokument wurde von KI übersetzt. Für genaue Informationen lesen Sie bitte die englische Version.

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

Szenario	Beschreibung
React useEffect Bereinigung	Aufruf innerhalb der `useEffect`-Bereinigungsfunktion (Cleanup), um Listener zu entfernen, wenn die Komponente unmountet.
JSField / JSEditableField	Kündigen des Abonnements von `js-field:value-change` während der bidirektionalen Datenbindung für Felder.
Ressourcenbezogen	Kündigen von Abonnements für Listener wie `refresh` oder `saved`, die über `ctx.resource.on` registriert wurden.

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

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.
Rechtzeitige Bereinigung: Rufen Sie ctx.off auf, bevor die Komponente unmountet oder der Kontext zerstört wird, um Speicherlecks zu vermeiden.

#ctx.off()

#Anwendungsfälle

#Typdefinition

#Beispiele

#Paarweise Verwendung in React useEffect

#Abbestellen von Ressourcen-Ereignissen

#Hinweise

#Verwandte Dokumente