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]);O Effect roda depois da renderização
A tela já foi atualizada. Por isso não bloqueia o que a pessoa vê.
As dependências dizem quando repetir
Liste tudo que o Effect usa e pode mudar. O plugin
eslint-plugin-react-hooksaponta o que faltou.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.currentnã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.