#ctx.off()

Remove os ouvintes de eventos registrados via ctx.on(eventName, handler). É frequentemente utilizado em conjunto com ctx.on para cancelar a assinatura no momento apropriado, evitando vazamentos de memória ou gatilhos duplicados.

#Casos de Uso

#Definição de Tipo

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

#Exemplos

#Uso pareado no useEffect do React

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

#Cancelando a assinatura de eventos de recurso

const handler = () => { /* ... */ };
ctx.resource?.on('refresh', handler);
// No momento apropriado
ctx.resource?.off('refresh', handler);

#Observações

1. Referência consistente do handler: O handler passado para ctx.off deve ser a mesma referência utilizada em ctx.on; caso contrário, ele não poderá ser removido corretamente.
2. Limpeza oportuna: Chame ctx.off antes que o componente seja desmontado ou o contexto seja destruído para evitar vazamentos de memória.

#Documentos Relacionados

• ctx.on - Inscrever-se em eventos
• ctx.resource - Instância de recurso e seus métodos on/off