APIs no React com useEffect e AbortController
⚡ Curso de React.js • Web-ZoneWare

Requisições a APIs com useEffect & AbortController: Race Conditions e Loading

Lição 20 de 50

Requisições a APIs com useEffect & AbortController: Race Conditions e Loading

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:

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

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

CODE 47 linhas
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!

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