Função de Limpeza no useEffect: Guia Prático
⚡ Curso de React.js • Web-ZoneWare

Função de Limpeza (Cleanup) no useEffect: Prevenindo Memory Leaks

Lição 19 de 50

Função de Limpeza (Cleanup) no useEffect: Prevenindo Memory Leaks

1. O Perigo Invisível dos Efeitos Colaterais Zumbis

Ao conectar componentes com recursos externos (como temporizadores setInterval, listeners globais window.addEventListener ou conexões WebSocket), iniciamos processos que continuam rodando de forma independente na memória do navegador. O que acontece se o usuário navegar para outra página ou fechar o modal onde esse componente estava?

Se o componente for removido do DOM (desmontado), mas o temporizador ou ouvinte continuar ativo, criamos o que a engenharia de software chama de Vazamento de Memória (Memory Leak):

  • Consumo Progressivo de Memória: Cada vez que o componente for montado e desmontado, um novo ouvinte ou timer fantasma será acumulado na memória heap.
  • Tentativa de Atualizar Componentes Mortos: Se o timer fantasma tentar chamar um setState em um componente que não existe mais na tela, o React emitirá o clássico aviso: “Can’t perform a React state update on an unmounted component”.

Para resolver essa questão com segurança absoluta, o React fornece a Função de Limpeza (Cleanup Function) do useEffect.


2. Anatomia da Função de Limpeza (Cleanup)

Para registrar uma rotina de desativação ou limpeza, basta retornar uma função de dentro do callback do useEffect:

CODE 19 linhas
import { useState, useEffect } from 'react';
 
function Cronometro() {
  const [segundos, setSegundos] = useState(0);
 
  useEffect(() => {
    // 1. SETUP: Inicia o temporizador
    const timerId = setInterval(() => {
      setSegundos(prev => prev + 1);
    }, 1000);
 
    // 2. CLEANUP: Retorna a função de limpeza que o React executará!
    return () => {
      clearInterval(timerId); // Cancela o timer na memória!
    };
  }, []); // Executa na montagem e limpa na desmontagem
 
  return <h2>Tempo Ativo: {segundos}s</h2>;
}

3. Quando o Cleanup Executa? (O Mito da Desmontagem Única)

Existe um equívoco muito comum entre desenvolvedores que acreditam que a função de limpeza roda apenas quando o componente é desmontado da tela. Essa afirmação está incompleta!

A regra de ouro da engenharia do React é:

O Ciclo de Limpeza Intermediário

Se o seu efeito possuir dependências (ex: [idUsuario]) e for re-executado porque a dependência mudou:

O React executa a função de limpeza do efeito ANTERIOR imediatamente antes de executar o NOVO efeito com os novos valores!

E finalmente, quando o componente for destruído (unmount), o React executa a última limpeza pendente.

Veja a linha do tempo cronológica quando a prop id muda de 1 para 2:

  1. O componente monta com id = 1 → Executa Efeito 1 (conecta ao chat da sala 1).
  2. A prop muda para id = 2.
  3. O React executa a Limpeza do Efeito 1 (desconecta da sala 1).
  4. O React executa o Novo Efeito 2 (conecta ao chat da sala 2).
  5. O usuário fecha o app → Executa a Limpeza do Efeito 2 (desconecta da sala 2).

4. O Strict Mode do React 18: Por Que Meu Efeito Roda Duas Vezes?

Se você estiver desenvolvendo em ambiente local com <React.StrictMode> ativado, notará que ao carregar a página os seus console.log dentro do useEffect aparecem duas vezes seguidas!

Isso não é um bug! É um recurso proposital de auditoria do React 18. Em modo de desenvolvimento, o React simula o seguinte ciclo:

CODE 3 linhas
1. Monta o componente (Executa Setup)
2. Desmonta imediatamente (Executa Cleanup)
3. Remonta com o mesmo estado (Executa Setup novamente)

O React faz isso intencionalmente para expor falhas arquiteturais: se o seu código não possuir função de limpeza, ou se o cleanup não desfizer 100% do que o setup fez, a aplicação quebrará imediatamente no desenvolvimento, alertando a equipe antes que o vazamento de memória chegue à produção!


5. Casos Clássicos que Exigem Cleanup Obrigatório

Recurso Conectado no Setup Operação Obrigatória no Cleanup
const id = setInterval(...) clearInterval(id)
const id = setTimeout(...) clearTimeout(id)
window.addEventListener('resize', fn) window.removeEventListener('resize', fn)
const socket = connectSocket(...) socket.disconnect()
const controller = new AbortController() controller.abort() (Cancela requisição HTTP pendente)
🛠️ Laboratório Prático & Prática Imediata

Aplique o que você aprendeu nesta lição

Utilize nossas ferramentas online gratuitas para experimentar os conceitos ou teste o código ao vivo no Playground IDE.

💻 Desenvolvedor & Código

Editor de Códigos Web Online

Ambiente com destaque de sintaxe para você testar tags, tabelas e scripts na hora.

Abrir Ferramenta Online
⚡ Live Code Studio

Playground Web Online

Escreva seu código HTML, CSS ou JavaScript e veja o resultado renderizado ao vivo no navegador com zero configuração.

⚡ Codificar no Playground IDE
Foto de Web-Zoneware
✓ Verificado
🎓 Tutor & Coordenador da Web Academy

Web-Zoneware

Tutor Técnico & Desenvolvedor Full-Stack

Desenvolvedor web e instrutor focado na formação prática de novos programadores. Defensor ferrenho de código semântico, arquitetura limpa e acessibilidade W3C/WCAG, dedicando-se a construir cursos estruturados em metodologia passo a passo com execução ao vivo no Playground IDE.

Especialidades: HTML5 Semântico CSS3 & Flexbox/Grid JavaScript Moderno Acessibilidade WCAG 2.2 Didática Prática
Rolar para cima