Requisições a APIs com useEffect & AbortController: Race Conditions e Loading
📑 Índice do Conteúdo
1. A Tríade Canônica de Estados em Requisições HTTP
A integração entre interfaces React e servidores remotos é uma das tarefas mais comuns e vitais do desenvolvimento web. Ao disparar uma chamada assíncrona para uma API REST ou GraphQL, o seu componente inevitavelmente transita por três fases distintas de ciclo de vida:
1. Estado de Dados (Data)
Inicialmente null ou um array vazio []. Armazena o payload JSON retornado com sucesso pelo servidor.
2. Estado de Carregamento (Loading)
Booleano (true/false). Informa à interface que a requisição está em trânsito pela rede, permitindo exibir spinners ou skeletons.
3. Estado de Erro (Error)
Inicialmente null. Captura exceções de rede, falhas de timeout ou códigos HTTP 4xx/5xx para exibir mensagens claras e botões de retentativa.
2. Por Que o Callback do useEffect NÃO Pode Ser async?
Um dos erros de sintaxe mais comuns cometidos por programadores ao integrar APIs no React é declarar a função passada ao useEffect diretamente com a palavra-chave async:
// ❌ ERRO GRAVE: O React rejeitará isso imediatamente!
useEffect(async () => {
const resposta = await fetch('/api/usuarios');
const dados = await resposta.json();
setUsuarios(dados);
}, []);
Por que essa sintaxe é estritamente proibida pelo React?
No JavaScript, toda função marcada com async retorna implicitamente uma Promise (Promise<void>). No entanto, conforme aprendemos na Lição 19, o motor do React espera que o callback do useEffect retorne ou nada (undefined) ou uma Função de Limpeza (Cleanup Function)!
Se você passar uma função async, o React receberá uma Promise onde esperava uma função de cleanup e não conseguirá cancelar seus efeitos colaterais na desmontagem.
A Sintaxe Correta: Função Assíncrona Interna
Para contornar essa regra com elegância, declaramos uma função async dentro do efeito e a invocamos imediatamente:
// ✅ FORMA CORRETA E IDIOMÁTICA:
useEffect(() => {
async function buscarUsuarios() {
try {
setCarregando(true);
const res = await fetch('/api/usuarios');
if (!res.ok) throw new Error('Falha na resposta do servidor');
const dados = await res.json();
setUsuarios(dados);
} catch (err) {
setErro(err.message);
} finally {
setCarregando(false);
}
}
buscarUsuarios();
}, []);
3. A Ameaça Oculta das Race Conditions (Condições de Corrida)
Imagine uma tela onde o usuário pode alternar entre abas de diferentes usuários: “Usuário 1” e “Usuário 2”. O que acontece se o usuário clicar no Usuário 1 e, imediatamente meio segundo depois, clicar no Usuário 2?
O Fenômeno da Race Condition
1. T = 0ms: Usuário clica em ‘Usuário 1’. Dispara fetch('/user/1').
2. T = 300ms: Usuário clica em ‘Usuário 2’. Dispara fetch('/user/2').
3. T = 500ms: O servidor responde a requisição 2 (rápida!). A UI exibe os dados do Usuário 2.
4. T = 1800ms: O servidor finalmente responde a requisição 1 (que sofreu atraso de rede). O setUsuario(dados1) executa e sobrescreve a tela com os dados do Usuário 1!
🚨 Resultado Catastrófico: A aba selecionada diz “Usuário 2”, mas o perfil exibido na tela pertence ao “Usuário 1”!
4. A Solução Corporativa: AbortController Nativo
Para eliminar Race Conditions e evitar que requisições obsoletas desperdicem banda e corrompam o estado, utilizamos a API nativa do navegador AbortController combinada com a função de limpeza do useEffect:
import { useState, useEffect } from 'react';
function PerfilUsuario({ id }) {
const [usuario, setUsuario] = useState(null);
const [carregando, setCarregando] = useState(true);
const [erro, setErro] = useState(null);
useEffect(() => {
// 1. Instancia o controlador nativo para esta execução do efeito
const controller = new AbortController();
async function carregarPerfil() {
try {
setCarregando(true);
setErro(null);
// 2. Conecta o sinal do controller à requisição fetch:
const resposta = await fetch(`https://api.exemplo.com/users/${id}`, {
signal: controller.signal
});
if (!resposta.ok) throw new Error('Não foi possível carregar o perfil');
const dados = await resposta.json();
setUsuario(dados);
} catch (err) {
// 3. Tratamento vital: ignoramos erros causados pelo cancelamento proposital!
if (err.name !== 'AbortError') {
setErro(err.message);
}
} finally {
setCarregando(false);
}
}
carregarPerfil();
// 4. CLEANUP: Se 'id' mudar ou o componente desmontar, cancela a requisição em trânsito!
return () => {
controller.abort();
};
}, [id]);
if (carregando) return <div className="spinner">Carregando perfil...</div>;
if (erro) return <div className="erro">Erro: {erro}</div>;
return <h1>{usuario?.nome}</h1>;
}
Quando o usuário clica no Usuário 2, o React executa a limpeza da requisição anterior chamando controller.abort(). A requisição pendente do Usuário 1 é abortada no nível de rede do navegador, eliminando por completo a possibilidade de concorrência desordenada!
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