useEffect: quando usar e quando evitar

Estado derivado, eventos e sincronização: como decidir se você precisa de um Effect e como limpá-lo.

7 min de leitura · Intermediário · Revisado em

Para que serve um Effect

useEffect serve para sincronizar o componente com algo fora do React: uma requisição, um timer, uma assinatura de eventos, a API do navegador. Se nada externo está envolvido, você provavelmente não precisa de um Effect.

Quando não usar

Evite

Estado derivado em Effect

Renderiza duas vezes e pode mostrar um valor desatualizado por um instante.

const [total, setTotal] = useState(0);
useEffect(() => {
  setTotal(itens.reduce((s, i) => s + i.preco, 0));
}, [itens]);

Prefira

Calcule durante a renderização

Sempre atualizado. Use useMemo só se o cálculo for comprovadamente caro.

const total = itens.reduce(
  (s, i) => s + i.preco,
  0,
);

Evite

Reagir a uma ação no Effect

O envio fica longe do clique que o causou e pode disparar de novo sem querer.

useEffect(() => {
  if (enviado) api.salvar(form);
}, [enviado]);

Prefira

Faça no tratador do evento

A causa e o efeito ficam juntos, e acontece exatamente uma vez.

async function aoEnviar() {
  await api.salvar(form);
  setEnviado(true);
}
  • Para reiniciar o estado quando um id muda, use key={id} no componente em vez de um Effect que zera tudo.
  • Para avisar o componente pai, chame a função recebida por props no próprio evento.

Quando usar, e como fazer direito

Buscar dados quando o id muda, sem resposta fora de ordem

useEffect(() => {
  const controle = new AbortController();

  fetch(`/api/cursos/${id}`, { signal: controle.signal })
    .then((resposta) => resposta.json())
    .then(setCurso)
    .catch((erro) => {
      if (erro.name !== 'AbortError') setErro(erro);
    });

  return () => controle.abort(); // limpeza
}, [id]);
  1. O Effect roda depois da renderização

    A tela já foi atualizada. Por isso não bloqueia o que a pessoa vê.

  2. As dependências dizem quando repetir

    Liste tudo que o Effect usa e pode mudar. O plugin eslint-plugin-react-hooks aponta o que faltou.

  3. A limpeza roda antes da próxima vez

    Cancele requisições, remova ouvintes de eventos e pare timers. Sem limpeza, uma resposta antiga pode sobrescrever a nova.

E o useRef?

Elemento do DOM
ref={campo} dá acesso ao elemento real para focar, medir ou rolar. Ex.: campo.current.focus().
Valor que não renderiza
Guarda algo entre renderizações sem causar uma nova, como o id de um timer.
Não leia durante a renderização
Mudar ref.current não atualiza a tela. Se o valor aparece na interface, ele é estado.
  • Cada Effect sincroniza com algo externo ao React.
  • Valores que dá para calcular a partir de props e estado não estão em useState.
  • Ações do usuário estão nos tratadores de eventos.
  • Todas as dependências estão listadas, sem desligar o lint.
  • Requisições, ouvintes e timers têm limpeza.

Referências

Trilhas relacionadas