As Regras dos Hooks do React: Top-Level, Callstack & Lista Encadeada
📑 Índice do Conteúdo
1. A Revolução dos Hooks no React 16.8
Até o lançamento do React 16.8 no início de 2019, a divisão de responsabilidades no ecossistema era binária e rígida:
- Componentes Funcionais: Eram meras funções estáticas que recebiam props e retornavam JSX. Não podiam ter estado próprio nem ciclo de vida. Eram chamados de componentes “burros” ou puramente visuais.
- Componentes de Classe (ES6): A única alternativa para gerenciar estados locais (
this.state) e orquestrar efeitos colaterais através de métodos de ciclo de vida (componentDidMount,componentDidUpdate,componentWillUnmount).
Embora funcionassem, as classes traziam consigo uma pesada sobrecarga cognitiva: a necessidade constante de fazer bind manual do this, a dispersão de lógicas correlatas entre múltiplos métodos de ciclo de vida e a impossibilidade de compartilhar lógica reativa sem apelar para padrões convolutos como Higher-Order Components (HOCs) ou Render Props (o temido “Wrapper Hell”).
Os Hooks resolveram esses problemas de forma brilhante: são funções puras que permitem “engatar” (hook) recursos nativos de estado, contexto, referências e efeitos colaterais diretamente dentro de componentes funcionais.
2. As Duas Regras de Ouro dos Hooks
Para que o motor reativo do React consiga sincronizar estados e efeitos sem exigir compilações mágicas ou sobrecarregar a memória, o time de engenharia do Facebook definiu duas regras universais e inegociáveis:
⚠️ Regra 1: Chame Hooks APENAS no Nível Superior (Top-Level)
NUNCA chame Hooks dentro de loops (for, while, map), dentro de blocos condicionais (if, switch, operador ternário) ou dentro de funções aninhadas/callbacks.
Os hooks devem ser invocados sempre no mesmo topo do componente, antes de qualquer retorno antecipado (early return).
⚛️ Regra 2: Chame Hooks APENAS em Funções do React
Invoque hooks exclusivamente a partir de:
- Componentes Funcionais do React (funções cujo nome começa com letra maiúscula).
- Custom Hooks (funções personalizadas que começam obrigatoriamente com o prefixo
use, comouseAuthouuseDebounce).
Nunca invoque hooks em funções utilitárias JavaScript comuns fora da árvore de componentes.
3. Por Baixo dos Panos: Como o React Sabe Qual Estado é Qual?
Considere o seguinte componente com múltiplos hooks:
function PerfilUsuario() {
const [nome, setNome] = useState('Flavio'); // Hook 1
const [idade, setIdade] = useState(38); // Hook 2
const [temaEscuro, setTemaEscuro] = useState(true); // Hook 3
return <h1>{nome} - {idade}</h1>;
}
Observe com atenção: na invocação de useState('Flavio'), você não forneceu nenhum identificador de texto (como useState('campo_nome', 'Flavio')). Como o React sabe, no próximo re-render, que o valor retornado deve pertencer à variável nome e não à variável idade?
O segredo reside na arquitetura interna dos Fiber Nodes: o React armazena os hooks de um componente como uma Lista Encadeada (Linked List) ordenada na memória:
Estrutura da Lista Encadeada no Fiber Node (fiber.memoizedState)
[Hook 1: useState] [Hook 2: useState] [Hook 3: useState]
{ memoizedState: 'Flavio', next: ----> { memoizedState: 38, next: ----> { memoizedState: true, next: null } }
A cada ciclo de renderização, o React inicializa um ponteiro interno no primeiro nó da lista. Cada vez que um hook é invocado:
- O React consulta o valor do nó atual da lista encadeada;
- Retorna o estado e sua função despachante;
- Avança o ponteiro para o nó seguinte (
pointer = pointer.next).
4. O Desastre de Violar a Ordem: Corrupção Silenciosa de Estado
Agora imagine que você cometa o erro de colocar o Hook 2 dentro de um bloco if:
// ❌ ANTI-PATTERN GRAVE: Condicional envolvendo um Hook!
function Perfil({ exibirIdade }) {
const [nome, setNome] = useState('Flavio'); // 1º Hook invocado
if (exibirIdade) {
const [idade, setIdade] = useState(38); // 2º Hook invocado (CONDICIONAL!)
}
const [temaEscuro, setTemaEscuro] = useState(true); // 3º Hook
}
Veja o desastre que ocorre quando exibirIdade muda de true para false:
| Ciclo de Render | 1ª Chamada de Hook | 2ª Chamada de Hook | Resultado na Memória |
|---|---|---|---|
| 1º Render (exibirIdade = true) | Pega Nó 1: 'Flavio' |
Pega Nó 2: 383ª chamada pega Nó 3: true |
✔ Normal (3 nós criados na lista) |
| 2º Render (exibirIdade = false) | Pega Nó 1: 'Flavio' |
Pula o Nó 2! A 2ª chamada agora é useState(temaEscuro), que lê o Nó 2 (valor 38)! |
❌ CORRUPÇÃO TOTAL: temaEscuro recebe o valor numérico 38! |
5. A Armadilha Comum: O “Early Return”
Uma violação sutil que costuma passar despercebida ocorre quando um desenvolvedor insere um retorno antecipado (por exemplo, exibindo um componente de loading) antes de outros hooks:
// ❌ ERRADO: Early return quebra a contagem de hooks
function Dashboard({ carregando }) {
const [contador, setContador] = useState(0);
// Se carregando for true, o componente encerra a execução AQUI!
if (carregando) {
return <p>Carregando dados...</p>;
}
// Estes hooks ABAIXO jamais serão chamados quando carregando for true:
const [dados, setDados] = useState(null);
useEffect(() => { carregarGraficos(); }, []);
return <div>...</div>;
}
A Regra de Ouro da Refatoração: Declare sempre todos os hooks no topo. Retornos antecipados condicionais (early returns) são perfeitamente válidos e saudáveis, desde que posicionados após a declaração de TODOS os hooks do componente.
6. O Sentinela Automático: eslint-plugin-react-hooks
Você não precisa confiar apenas na memória humana para se proteger dessas armadilhas. O time do React disponibiliza o plugin oficial do ESLint que bloqueia violações em tempo de edição:
{
"plugins": ["react-hooks"],
"rules": {
"react-hooks/rules-of-hooks": "error", // Impede hooks em condicionais e loops
"react-hooks/exhaustive-deps": "warn" // Alerta dependências esquecidas em efeitos
}
}
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