Skip to content

1. Introdução

O PDF do documento está AQUI.

Os códigos do documento estão AQUI.

Este documento é um produto da IA Claude da Anthropic. Ele segue o curso “Introdução passo a passo ao framework web NestJS”, do qual muda a perspectiva:

  • No curso [NestJS], o servidor gera as páginas HTML (engine de views [Handlebars]); o navegador apenas as exibe;
  • neste curso, as páginas são geradas no navegador por uma aplicação [React]; o servidor, agora reduzido a um simples servidor JSON, fornece apenas dados.

As páginas da aplicação, porém, permanecem as mesmas: são as da aplicação [RdvMedecins] já apresentada com os outros frameworks (login com CAPTCHA, agenda do médico, janela de consulta, portal do paciente, gerenciamento de médicos e clientes, criação de conta, francês e inglês).

Este documento segue a mesma estrutura de seus antecessores: primeiro, vários exemplos curtos, cada um focado em um conceito específico do [React], seguidos de um estudo de caso completo — o cliente [React] da aplicação [RdvMedecins] — com todos os arquivos comentados. Ele segue a mesma estrutura dos cursos *Introdução passo a passo ao framework Vue.js* e *Introdução passo a passo ao framework Angular*: os leitores familiarizados com [Vue.js] ou [Angular] encontrarão os mesmos exemplos, escritos no estilo do [React]: 25 exemplos, numerados como os do curso [Angular].

Já existe um curso sobre este tema: Um exemplo cliente/servidor React / NestJS (2026), que cobre tanto o servidor quanto o cliente. Este documento difere daquele em sua abordagem: o servidor é tratado como uma caixa-preta, e nos interessamos apenas pela API e pelo JSON; aprendemos [React] passo a passo antes de abordar o cliente completo.

1.1. O papel do React em uma aplicação web

A aplicação tem duas partes, que se comunicam entre si apenas por meio de requisições:

Image

  • 1: A aplicação [React], executada no navegador, envia uma requisição HTTP ao servidor, por exemplo, [GET /api/schedule?doctorId=1&day=2026-10-05];
  • 2: O servidor responde com dados JSON: a agenda desse médico para aquele dia. Ele não gera nenhuma página;
  • 3: Com esses dados, o [React] atualiza a página exibida no navegador sem recarregá-la.

O diagrama a seguir compara as duas arquiteturas:

Image

O navegador carrega apenas uma única página HTML, quase vazia, na inicialização. Todo o resto é gerado pelo código [JavaScript]: é o que se chama de aplicação de página única (SPA, de [Single Page Application]). Quando o usuário clica em um link interno, nenhuma página é solicitada ao servidor: o roteador altera a URL exibida e substitui o conteúdo da página.

[React] é uma biblioteca criada pelo [Facebook] (hoje [Meta]) e lançada em 2013. Atualmente, é a biblioteca mais usada para construir interfaces web. Ela se baseia em três conceitos:

  • componentes: a interface é dividida em partes reutilizáveis (uma barra de navegação, um campo de formulário, uma janela de confirmação etc.). Um componente [React] é uma simples função [JavaScript] (ou [TypeScript]) que retorna o que deve ser exibido, escrita em JSX, uma sintaxe que combina HTML e [JavaScript];
  • Estado e renderização declarativa: os dados de um componente ficam armazenados em seu estado ([useState]). Quando o estado muda, o [React] chama a função do componente, compara o resultado com o anterior e atualiza automaticamente o que mudou na página. Nunca escrevemos código que modifica diretamente a página: descrevemos a página em função do estado;
  • hooks: funções ([useState], [useEffect], [useContext]...) por meio das quais um componente acessa os mecanismos do [React]: estado, efeitos colaterais e dados compartilhados. Você pode escrever seus próprios hooks para reutilizar um comportamento.

Diferentemente do [Angular], o [React] não é um framework "tudo em um": é uma biblioteca de renderização. O roteador, os formulários, o cliente HTTP, a tradução e o estado compartilhado são fornecidos por outras bibliotecas, escolhidas pelo desenvolvedor. Este curso usa as mais comuns: [React Router] (o roteador), [React Hook Form] (uma biblioteca de formulários de exemplo), [TanStack Query] (leitura de dados do servidor), [Zustand] (estado compartilhado) e [i18next] (idiomas). A ferramenta de build é o [Vite].

Usaremos o [React] 19, com sua implementação mais recente: componentes de função e hooks (os antigos componentes escritos como classes não são mais usados), actions de formulário ([useActionState]), [use()] e [<Suspense>], [<title>] posicionado por um componente, [useEffectEvent] e [<Activity>] (React 19.2).

1.2. Ferramentas utilizadas

Os exemplos foram escritos e testados com as seguintes ferramentas (as instruções de instalação estão no apêndice):

  • [Node.js] 24 (ou pelo menos 22.22: é uma exigência do [React Router] 8) e seu gerenciador de pacotes [npm];
  • o editor [Visual Studio Code], que inclui suporte a [TypeScript] e JSX sem nenhuma extensão adicional;
  • um navegador recente ([Chrome], [Firefox], [Edge]), se possível com a extensão [React Developer Tools];
  • a ferramenta de linha de comando [curl], que exibe as respostas HTTP brutas;
  • o SGBD [MySQL] (ou [MariaDB]), por exemplo, o do [Laragon] no [Windows]: ele é necessário para o servidor JSON, conforme descrito no capítulo que o apresenta.

As bibliotecas são as dos arquivos [package.json]: [React] 19.3, [React Router] 8.4, [Vite] 8.3, [TypeScript] 6.0, [React Hook Form] 7.89, [TanStack Query] 5.104, [Zustand] 5.0, [i18next] 26 e [react-i18next] 17, [Bootstrap] 5.3.

1.3. Exemplos

Os códigos do documento estão organizados em três pastas:

1
2
3
4
deliverable/
├── examples-react/            the 25 small React examples
├── rdvmedecins-nestjs-json/   the RdvMedecins JSON server (the "black box")
└── rdvmedecins-react/         the React client of the case study

A pasta de exemplos contém vinte e cinco pequenas aplicações — uma por exemplo — que compartilham as mesmas bibliotecas:

examples-react/
├── 01-first-application/
│   ├── index.html
│   └── src/
├── 02-state/
├── ...
├── 25-server-errors/
├── common/            code shared by examples 24 and 25
├── node_modules/
├── package.json
├── tsconfig.json
└── vite.config.ts     the Vite configuration, shared by all the examples

Instale as bibliotecas uma única vez, em um console aberto na pasta [examples-react] (no [VS Code]: menu Terminal / Novo Terminal):

npm install

Depois, execute um exemplo digitando seu nome:

npm start 01-first-application

O servidor de desenvolvimento do [Vite] serve o exemplo na porta 5173: abra-o em http://localhost:5173/. Esse servidor não precisa ser reiniciado quando você modifica um arquivo: cada arquivo salvo é recompilado imediatamente e a página do navegador é atualizada automaticamente, normalmente sem nem perder seu estado. Interrompa-o digitando [Ctrl-C] no console antes de executar o exemplo seguinte (apenas um exemplo por vez pode ocupar a porta 5173).

Os exemplos 22 a 25 consultam os servidores JSON e [RdvMedecins]: será preciso tê-los instalado e iniciado, conforme explicado no capítulo dedicado a eles.

1.4. Conteúdo do documento

Capítulo
Conteúdo
Exemplos
Primeiros passos
Uma aplicação, estado, JSX, eventos, campos controlados, useReducer, validação, React Hook Form, formatação
01–09
Componentes
props, funções passadas ao pai, composição (children, render props), ciclo de vida e efeitos, contextos, hooks personalizados, caixa de diálogo de confirmação
10 a 16
Roteamento
React Router, guards de navegação (middleware)
17 e 18
Operações assíncronas e estado compartilhado
Timers, antirrebote (debounce), respostas expiradas, use() e Suspense, Zustand
19 e 20
Internacionalização
Uma aplicação em francês e inglês (i18next)
21
O servidor: uma caixa-preta
Instalação do servidor JSON, sua API, exemplos com curl
-
Interação com o servidor
fetch, login e cookies, actions de formulário, a camada de acesso à API, TanStack Query, erros do servidor
22–25
Estudo de caso
O cliente React da aplicação RdvMedecins
-
Implantação
O cliente compilado, servido pelo servidor JSON
-

Cada exemplo é apresentado com seu código completo, comentado linha por linha, e uma captura de tela de sua execução. O próprio código é amplamente comentado: esses comentários fazem parte do curso.