Hook useTransition: Transições Não-Bloqueantes e Concorrência no React 18 e 19
Hook useTransition: Transições Não-Bloqueantes e Concorrência no React 18 e 19
Até o React 17, todas as atualizações de estado eram síncronas e bloqueavam a thread principal, causando o temido congelamento da digitação em listas extensas. Com o React Concorrente e o hook useTransition, você divide atualizações em Urgentes e Transições, permitindo que a interface continue respondendo a 60 FPS mesmo durante renderizações pesadas.
📑 Índice do Conteúdo
1. O Problema da UI Travada (Jank) e as Atualizações Concorrentes
Considere o cenário clássico de uma barra de busca filtrando milhares de registros. Quando o usuário digita rapidamente no teclado:
function SearchCatalog() {
const [query, setQuery] = useState('');
function handleChange(e) {
// 💥 O React tenta atualizar o input E renderizar 5.000 itens ao mesmo tempo!
// O cursor congela, a digitação engasga e o INP (Interaction to Next Paint) é arruinado.
setQuery(e.target.value);
}
return <input value={query} onChange={handleChange} />;
}
No modelo síncrono tradicional, o navegador não consegue desenhar o texto digitado até que a função de render de todos os 5.000 componentes filhos seja concluída.
2. Atualizações Urgentes vs. Atualizações de Transição
A filosofia do React Concorrente divide as alterações de estado em duas categorias bem distintas:
Atualizações Urgentes (Urgent Updates)
Refletem interação física imediata: digitar no input, focar elementos, clicar em botões. Precisam de resposta visual instantânea em menos de 16 milissegundos.
Atualizações de Transição (Transitions)
Mudanças de tela ou filtros pesados: transição entre abas, filtragem de listas, recálculo de gráficos. O usuário aceita uma breve espera enquanto a tela é calculada.
3. A Sintaxe e o Funcionamento do useTransition
O hook useTransition retorna uma tupla com dois elementos: um booleano de pendência (isPending) e a função disparadora (startTransition):
import { useState, useTransition } from 'react';
function SearchCatalog() {
// 1. Estado imediato do input (Urgente)
const [inputValue, setInputValue] = useState('');
// 2. Estado de busca pesada da lista (Transição)
const [searchQuery, setSearchQuery] = useState('');
// 3. Hook de Concorrência
const [isPending, startTransition] = useTransition();
function handleChange(e) {
// Atualização Urgente: o input reflete a letra IMEDIATAMENTE (sem lag)
setInputValue(e.target.value);
// Atualização de Transição: marcada como não-bloqueante
startTransition(() => {
setSearchQuery(e.target.value);
});
}
return (
<div>
<input value={inputValue} onChange={handleChange} />
{/* Feedback visual elegante com isPending */}
{isPending && <span className="spinner">Filtrando catálogo...</span>}
<div style={{ opacity: isPending ? 0.6 : 1 }}>
<DenseProductList query={searchQuery} />
</div>
</div>
);
}
4. A Mecânica Interna: O Que Acontece no Motor Fiber?
Quando uma função é envolvida por startTransition, o motor React Fiber altera seu algoritmo de escalonamento:
- Fatia de Tempo (Time-Slicing): O React trabalha na árvore
workInProgressem fatias microscópicas de 5ms, devolvendo o controle periodicamente para o navegador processar eventos. - Interrompibilidade Atômica: Se o usuário digitar uma nova letra enquanto o React estiver na metade do cálculo da lista, o React descarta o trabalho inacabado, atende a nova letra digitada (prioridade urgente) e recomeça a transição com a busca mais recente!
startTransition passou a aceitar funções assíncronas nativamente (startTransition(async () => { await mutateData(); })), permitindo orquestrar mutações de rede e Server Actions com isPending automático sem necessidade de gerenciar estados manuais de loading!
5. useTransition vs. useDeferredValue: Qual Escolher?
| Critério | useTransition | useDeferredValue |
|---|---|---|
| Como funciona? | Envolve a chamada do setter de estado (startTransition(() => setState())). |
Envolve um valor bruto recebido (const deferred = useDeferredValue(value)). |
| Disponibilidade de isPending | ✅ Sim (booleano retornado diretamente pelo hook). | ❌ Não nativo (compara-se value !== deferredValue). |
| Caso de Uso Típico | Quando você tem o controle direto da função de disparo do estado no componente. | Quando você recebe um valor via props de um componente pai ou biblioteca externa. |
6. Laboratório Prático: Simulador de Concorrência e Digitação Fluida
No laboratório interativo abaixo, teste a diferença brutal entre a renderização tradicional bloqueante e a renderização concorrente com useTransition. Ative a simulação de carga pesada (5.000 nós no DOM) e digite rapidamente na barra de busca para sentir o cursor travando no modo síncrono versus a resposta lisa a 60 FPS garantida pelo useTransition!
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