Hook useState no React: Estado Local, Reatividade & Snapshots
📑 Índice do Conteúdo
1. Por Que Variáveis Comuns Não Funcionam no React?
Para quem está dando os primeiros passos no React, é muito intuitivo tentar gerenciar dados mutáveis com uma variável comum do JavaScript declarada dentro da função do componente:
// ❌ TENTATIVA INGÊNUA: Variável local comum
function ContadorInutil() {
let cliques = 0;
function handleClick() {
cliques = cliques + 1;
console.log("Cliques:", cliques); // O valor incrementa no console...
}
return <button onClick={handleClick}>Cliques: {cliques}</button>; // ...mas a tela NUNCA atualiza!
}
Por que a interface não é atualizada quando handleClick é executado? Por dois motivos fundamentais da arquitetura de reatividade do React:
- Variáveis locais não persistem entre renderizações: Quando um componente React é re-executado, ele é chamado como uma função comum. Todas as variáveis locais são reinicializadas a partir do zero.
- Mutações em variáveis locais não disparam re-renders: O React não observa variáveis arbitrárias. Ele não tem como “adivinhar” que a variável
cliquesmudou e que o DOM precisa ser recalculado.
Para persistir dados entre renders e notificar o motor do React de que a interface deve ser repintada, utilizamos o hook mais emblemático da biblioteca: o useState.
2. Anatomia do useState & Desestruturação de Arrays
A sintaxe básica para declarar uma variável de estado é:
import { useState } from 'react';
const [estado, setEstado] = useState(valorInicial);
O hook useState recebe um único parâmetro (o valor inicial do estado) e retorna um array contendo exatamente dois elementos:
1º Elemento: A Variável de Estado (Leitura)
Representa o valor atual do estado retido pelo React para a renderização vigente. Durante o primeiro render, conterá exatamente o valorInicial.
2º Elemento: A Função Despachante (Setter)
Uma função despachante que atualiza o valor daquele nó no Fiber e agenda uma nova renderização (re-render) para o componente.
Por Que o React Retorna um Array e Não um Objeto?
Esta é uma das decisões de design de API mais elegantes do React. Se o useState retornasse um objeto (como { value, setValue }), você precisaria renomear as propriedades via alias em cada invocação para evitar colisões:
// Se retornasse objeto (verboso e cansativo):
const { value: nome, setValue: setNome } = useState('Flavio');
const { value: idade, setValue: setIdade } = useState(38);
// Com Array Destructuring (limpo e posicional):
const [nome, setNome] = useState('Flavio');
const [idade, setIdade] = useState(38);
Com arrays, os nomes das variáveis são 100% livres e atribuídos pela ordem de posição (índice 0 e índice 1).
3. O Conceito Fundamental: O Estado é um Snapshot
Um dos conceitos mais importantes e que mais gera dúvidas em entrevistas técnicas é compreender que o estado do React se comporta como uma fotografia estática (Snapshot) daquele ciclo de renderização.
Considere o código a seguir:
function BotaoContador() {
const [contador, setContador] = useState(0);
function handleClick() {
setContador(contador + 1);
console.log("Valor de contador:", contador);
}
return <button onClick={handleClick}>Valor: {contador}</button>;
}
Se o botão for clicado pela primeira vez, o que será impresso no console? Será impresso 0, e não 1!
Como Funciona o Ciclo de Snapshot
1. O componente é renderizado. Neste render, a constante contador vale 0.
2. O usuário clica. A função handleClick é invocada.
3. setContador(contador + 1) avisa o React: “Por favor, agende um novo render onde contador valha 1”.
4. No entanto, dentro da função handleClick atual, a variável contador é uma constante local com valor 0 capturada pela closure!
5. O novo valor 1 só existirá quando o React executar o componente na próxima renderização!
4. A Armadilha de Múltiplos Setters com Snapshot Fixo
Imagine que você queira somar 3 ao contador ao clicar em um botão e tente fazer o seguinte:
// ⚠️ PROBLEMA: Tentando somar 3 com chamadas consecutivas
function handleSomarTres() {
setContador(contador + 1);
setContador(contador + 1);
setContador(contador + 1);
}
Qual será o resultado final após o clique? O contador avançará apenas +1, e não +3!
Por que isso acontece? Porque em todas as três chamadas, a variável contador tinha exatamente o mesmo valor do snapshot atual (por exemplo, 0):
- 1ª chamada:
setContador(0 + 1)→ Agenda o valor 1. - 2ª chamada:
setContador(0 + 1)→ Sobrescreve com o valor 1. - 3ª chamada:
setContador(0 + 1)→ Sobrescreve com o valor 1.
Para resolver esse cenário com segurança absoluta, o React fornece a Atualização Funcional com prevState, que estudaremos detalhadamente na Lição 13.
5. Automatic Batching: Otimização de Performance no React 18
Antes do React 18, se você chamasse múltiplos setStates dentro de uma Promise (como um fetch) ou dentro de um setTimeout, cada chamada disparava um re-render independente, causando repinturas desnecessárias.
No React 18+, foi introduzido o Automatic Batching (agrupamento automático). Independentemente de onde as atualizações sejam disparadas (eventos de clique, timeouts, promises ou callbacks nativos), o React agrupa todas as atualizações de estado em uma única transação e realiza apenas um re-render consolidado no final do ciclo de processamento da callstack!
6. Inicialização Preguiçosa de Estado (Lazy Initial State)
Se o valor inicial do seu estado exigir um cálculo computacionalmente pesado (como ler e fazer o JSON.parse de um dado extenso salvo no localStorage), passar o resultado direto no useState é prejudicial à performance:
// ❌ RUIM: Ler o localStorage a CADA re-render do componente
const [dados, setDados] = useState(JSON.parse(localStorage.getItem('minha_chave')));
// ✅ EXCELENTE (Lazy Initialization): A função só roda UMA VEZ no primeiro render!
const [dados, setDados] = useState(() => {
const salvo = localStorage.getItem('minha_chave');
return salvo ? JSON.parse(salvo) : { tema: 'escuro', notificacoes: true };
});
Ao passar uma função para o useState, o React executa essa função exclusivamente durante a montagem inicial do componente, ignorando-a por completo em todos os re-renders posteriores!
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