Array de Dependências no useEffect: Montagem, Atualização & Boas Práticas
📑 Índice do Conteúdo
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
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
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
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:
// ❌ 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). |
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.
Editor de Códigos Web Online
Ambiente com destaque de sintaxe para você testar tags, tabelas e scripts na hora.
Abrir Ferramenta OnlinePlayground 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