Skip to content

1. Introducción

El PDF del documento está AQUÍ.

Los códigos del documento están AQUÍ.

Este documento es un producto de Claude, la IA de Anthropic. Sigue al curso “Introducción paso a paso al framework web NestJS”, del cual cambia la perspectiva:

  • en el curso [NestJS], el servidor genera las páginas HTML (motor de vistas [Handlebars]); el navegador se limita a mostrarlas;
  • en este curso, las páginas se generan en el navegador mediante una aplicación [React]; el servidor, reducido ahora a un simple servidor JSON, solo proporciona datos.

Sin embargo, las páginas de la aplicación permanecen sin cambios: son las de la aplicación [RdvMedecins] ya presentada con los otros frameworks (inicio de sesión con CAPTCHA, agenda del médico, ventana de citas, portal del paciente, gestión de médicos y clientes, creación de cuentas, francés e inglés).

Este documento sigue la misma estructura que sus predecesores: primero, numerosos ejemplos breves, cada uno centrado en un concepto específico de [React], seguidos de un caso de estudio completo —el cliente [React] de la aplicación [RdvMedecins]— con todos los archivos comentados. Sigue la misma estructura que los cursos *Introducción paso a paso al framework Vue.js* e *Introducción paso a paso al framework Angular*: los lectores familiarizados con [Vue.js] o [Angular] encontrarán los mismos ejemplos, escritos al estilo de [React]: 25 ejemplos, numerados como los del curso [Angular].

Ya existe un curso sobre este tema: Un ejemplo cliente/servidor con React / NestJS (2026), que abarca tanto el servidor como el cliente. Este documento se diferencia de aquel en su enfoque: el servidor se trata como una caja negra, y solo nos interesan la API y el JSON; aprendemos [React] paso a paso antes de abordar el cliente completo.

1.1. El papel de React en una aplicación web

La aplicación tiene dos partes, que se comunican entre sí solo mediante solicitudes:

Image

  • 1: la aplicación [React], que se ejecuta en el navegador, envía una solicitud HTTP al servidor, por ejemplo, [GET /api/schedule?doctorId=1&day=2026-10-05];
  • 2: el servidor responde con datos JSON: la agenda de ese médico para ese día. No genera ninguna página;
  • 3: con estos datos, [React] actualiza la página mostrada en el navegador sin recargarla.

El siguiente diagrama compara las dos arquitecturas:

Image

El navegador carga una única página HTML, casi vacía, al iniciar. Todo lo demás lo genera el código [JavaScript]: esto se conoce como aplicación de página única (SPA, por [Single Page Application]). Cuando el usuario hace clic en un enlace interno, no se solicita ninguna página al servidor: el enrutador cambia la URL mostrada y reemplaza el contenido de la página.

[React] es una biblioteca creada por [Facebook] (hoy [Meta]) y lanzada en 2013. Actualmente es la biblioteca más utilizada para construir interfaces web. Se basa en tres conceptos:

  • componentes: la interfaz se descompone en partes reutilizables (una barra de navegación, un campo de formulario, una ventana de confirmación, etc.). Un componente [React] es una simple función de [JavaScript] (o [TypeScript]) que devuelve lo que debe mostrarse, escrita en JSX, una sintaxis que combina HTML y [JavaScript];
  • el estado y el renderizado declarativo: los datos de un componente se almacenan en su estado ([useState]). Cuando el estado cambia, [React] llama a la función del componente, compara el resultado con el anterior y actualiza automáticamente lo que haya cambiado en la página. Nunca escribimos código que modifique directamente la página: describimos la página en función de su estado;
  • hooks: funciones ([useState], [useEffect], [useContext]...) mediante las cuales un componente accede a los mecanismos de [React]: estado, efectos secundarios y datos compartidos. Usted puede escribir sus propios hooks para reutilizar un comportamiento.

A diferencia de [Angular], [React] no es un framework "todo en uno": es una biblioteca de renderizado. El enrutador, los formularios, el cliente HTTP, la traducción y el estado compartido los proporcionan otras bibliotecas, elegidas por el desarrollador. Este curso utiliza las más comunes: [React Router] (el enrutador), [React Hook Form] (un ejemplo de biblioteca de formularios), [TanStack Query] (lectura de datos del servidor), [Zustand] (estado compartido) e [i18next] (idiomas). La herramienta de compilación es [Vite].

Usaremos [React] 19, con su implementación más reciente: componentes de función y hooks (los antiguos componentes escritos como clases ya no se usan), acciones de formulario ([useActionState]), [use()] y [<Suspense>], [<title>] colocado por un componente, [useEffectEvent] y [<Activity>] (React 19.2).

1.2. Herramientas utilizadas

Los ejemplos se escribieron y probaron con las siguientes herramientas (las instrucciones de instalación se encuentran en el apéndice):

  • [Node.js] 24 (o al menos 22.22: es un requisito de [React Router] 8) y su administrador de paquetes [npm];
  • el editor [Visual Studio Code], que incluye [TypeScript] y JSX sin necesidad de extensiones adicionales;
  • un navegador reciente ([Chrome], [Firefox], [Edge]), si es posible con la extensión [React Developer Tools];
  • la herramienta de línea de comandos [curl], que muestra las respuestas HTTP sin procesar;
  • el SGBD [MySQL] (o [MariaDB]), por ejemplo, el de [Laragon] en [Windows]: es necesario para el servidor JSON, como se describe en el capítulo que lo presenta.

Las bibliotecas son las de los archivos [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 y [react-i18next] 17, [Bootstrap] 5.3.

1.3. Ejemplos

Los códigos del documento se organizan en tres carpetas:

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

La carpeta examples contiene veinticinco aplicaciones pequeñas, una por ejemplo, que comparten las mismas 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 las bibliotecas una sola vez, en una consola abierta en la carpeta [examples-react] (en [VS Code]: menú Terminal / Nueva terminal):

npm install

Luego ejecute un ejemplo escribiendo su nombre:

npm start 01-first-application

El servidor de desarrollo de [Vite] sirve el ejemplo en el puerto 5173: ábralo en http://localhost:5173/. No es necesario reiniciar este servidor cuando se modifica un archivo: cada archivo guardado se vuelve a compilar de inmediato y la página del navegador se actualiza automáticamente, normalmente sin siquiera perder su estado. Deténgalo escribiendo [Ctrl-C] en la consola antes de ejecutar el siguiente ejemplo (solo un ejemplo a la vez puede ocupar el puerto 5173).

Los ejemplos 22 a 25 consultan los servidores JSON y [RdvMedecins]: deberá haberlos instalado e iniciado, como se explica en el capítulo dedicado a ellos.

1.4. Contenido del documento

Capítulo
Contenido
Ejemplos
Primeros pasos
Una aplicación, estado, JSX, eventos, campos controlados, useReducer, validación, React Hook Form, formato
01–09
Componentes
props, funciones pasadas hacia el padre, composición (children, render props), ciclo de vida y efectos, contextos, hooks personalizados, cuadro de diálogo de confirmación
10 a 16
Enrutamiento
React Router, guardias de navegación (middleware)
17 y 18
Operaciones asíncronas y estado compartido
Temporizadores, antirrebote, respuestas caducadas, use() y Suspense, Zustand
19 y 20
Internacionalización
Una aplicación en francés e inglés (i18next)
21
El servidor: una caja negra
Instalación del servidor JSON, su API, ejemplos con curl
-
Interacción con el servidor
fetch, conexión y cookies, acciones de formulario, la capa de acceso a la API, TanStack Query, errores del servidor
22–25
Caso de estudio
El cliente React de la aplicación RdvMedecins
-
Despliegue
El cliente compilado, servido por el servidor JSON
-

Cada ejemplo se presenta con su código completo, comentado línea por línea, y una captura de pantalla de su ejecución. El propio código está ampliamente comentado: estos comentarios forman parte del curso.