Array de Dependências no useEffect: Guia Completo
⚡ Curso de React.js • Web-ZoneWare

Array de Dependências no useEffect: Montagem, Atualização & Boas Práticas

Lição 18 de 50

Array de Dependências no useEffect: Montagem, Atualização & Boas Práticas

1. As Três Modalidades do useEffect: O Papel do 2º Argumento

Na Lição 17, aprendemos que o useEffect serve para sincronizar o componente com sistemas externos após a pintura da tela pelo navegador. No entanto, o seu verdadeiro poder de controle reside no seu segundo argumento opcional: o Array de Dependências (Dependency Array).

Dependendo de como você passa esse segundo parâmetro, o React adota três comportamentos radicalmente distintos de execução:

1. Sem Array: Executa em TODOS os Renders

CODE 3 linhas
useEffect(() => {
  console.log("Roda sempre!");
});

Executa após a montagem inicial e após cada re-render do componente. Cuidado: disparar setState aqui causa loop infinito!

2. Array Vazio []: Executa APENAS na Montagem

CODE 3 linhas
useEffect(() => {
  console.log("Roda 1 vez só!");
}, []);

Executa exclusivamente uma vez logo após o componente ser montado no DOM. É o substituto moderno do antigo componentDidMount.

3. Com Dependências: Executa sob Mudança

CODE 3 linhas
useEffect(() => {
  carregarDados(id);
}, [id]);

Executa na montagem e é re-executado apenas quando o valor de ‘id’ mudar entre renderizações sucessivas.


2. Como o React Avalia o Array: Comparação Rasa (Object.is)

Como o React decide internamente se o efeito deve ou não ser re-executado? Ele utiliza o mesmo algoritmo que estudamos no estado: comparação rasa com Object.is.

A cada re-renderização, o React compara cada item do array de dependências atual com o item da mesma posição no render anterior:

Algoritmo Interno de Comparação do React

Render 1: [ id: 10, filtro: ‘ativo’ ]
Render 2: [ id: 10, filtro: ‘ativo’ ] ──> Object.is() retorna TRUE em todos ──> EFEITO IGNORADO! (Skip)

Render 3: [ id: 10, filtro: ‘inativo’ ] ─> Object.is() retorna FALSE no 2º item ─> EFEITO RE-EXECUTADO!

⚠️ A Armadilha dos Objetos e Funções no Array

Como objetos literais ({ tema: 'escuro' }) e funções (() => {}) criadas dentro do componente geram uma nova referência de memória a cada render, passar um objeto ou função diretamente no array de dependências fará o useEffect rodar em todo e qualquer re-render, anulando a proteção do array!


3. A Regra de Ouro: Nunca Minta para o React

Um dos erros mais perigosos em times de desenvolvimento é suprimir o aviso do linter oficial (react-hooks/exhaustive-deps) com um comentário de escape:

CODE 15 linhas
// ❌ PRÁTICA PROIBIDA: Mentir para o React silenciando o linter!
function Perfil({ idUsuario }) {
  const [usuario, setUsuario] = useState(null);
 
  useEffect(() => {
    // Usamos 'idUsuario' aqui dentro...
    buscarNoServidor(idUsuario).then(setUsuario);
    
    // ...mas MENTIMOS passando array vazio para rodar só 1 vez!
    // eslint-disable-next-line react-hooks/exhaustive-deps
  }, []); 
 
  // Se 'idUsuario' mudar de 1 para 2 via prop, o componente NUNCA buscará o usuário 2!
  return <h1>{usuario?.nome}</h1>;
}

O que acontece quando você mente para o React omitindo dependências?

  • O efeito colateral fica preso a uma Stale Closure (fechamento desatualizado com os valores do primeiro render).
  • Se as props ou estados mudarem, o efeito não reage, gerando bugs silenciosos e dados desatualizados na tela.

4. Estratégias Limpas para Resolver Avisos do Linter

Em vez de desativar o linter com comentários, aplique as soluções arquiteturais oficiais:

Cenário do Problema Solução Limpa e Correta
A função externa é usada no efeito Mova a declaração da função para dentro do próprio useEffect. Assim, ela deixa de ser uma dependência externa.
A função não usa nada de props/state Mova a função para fora do componente (no escopo do arquivo). O React saberá que ela é estática e imutável.
Você só precisa de ‘contador’ para somar +1 Use atualização funcional: setContador(prev => prev + 1). Como você não lê mais a variável contador, ela é removida das dependências com 100% de segurança!
Funções ou objetos que precisam vir via props Estabilize as referências com useCallback e useMemo (que estudaremos no Módulo 5).
🛠️ 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