Hook useState no React: Estado Local e Reatividade
⚡ Curso de React.js • Web-ZoneWare

Hook useState no React: Estado Local, Reatividade & Snapshots

Lição 12 de 50

Hook useState no React: Estado Local, Reatividade & Snapshots

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:

CODE 11 linhas
// ❌ 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:

  1. 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.
  2. 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 cliques mudou 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 é:

CODE 3 linhas
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:

CODE 7 linhas
// 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:

CODE 10 linhas
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:

CODE 6 linhas
// ⚠️ 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:

CODE 8 linhas
// ❌ 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!

🛠️ 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