{"componentChunkName":"component---src-templates-content-template-js","path":"/es/part7/funcionamiento_interno_de_vite_y_esbuild","result":{"data":{"markdownRemark":{"html":"
\n

En los primeros tiempos, React era algo famoso por ser muy difícil de configurar con las herramientas necesarias para el desarrollo de aplicaciones. Para facilitar la situación, se desarrolló Create React App, que eliminó los problemas relacionados con la configuración. Vite, que se utiliza a lo largo de este curso, ha reemplazado desde entonces a Create React App como el estándar para nuevas aplicaciones React.

\n

Tanto Vite como Create React App utilizan bundlers para hacer el trabajo real. En esta sección veremos más de cerca qué hacen realmente los bundlers, cómo funciona Vite por debajo y cómo configurarlo para distintos escenarios. También examinaremos brevemente esbuild, un bundler de bajo nivel que el propio Vite usa internamente. Entender esbuild ayuda a aclarar qué significa, en el fondo, el bundling.

\n
\n

¿Y Webpack?

\n

Webpack fue el bundler dominante durante la mayor parte de la década de 2010 y todavía aparece en bases de código antiguas y empresariales. Este curso también cubrió Webpack hasta la primavera de 2026.

\n

Si trabajas en un proyecto legacy, es útil saber que Webpack existe y que utiliza los mismos conceptos básicos (entry points, loaders/plugins, output). Sin embargo, en 2026 no se recomienda configurar un proyecto nuevo con Webpack. Su configuración es compleja y las herramientas modernas como Vite proporcionan una experiencia de desarrollo mucho mejor. No cubriremos la configuración de Webpack en este curso.

\n
\n

Bundling

\n

Hemos implementado nuestras aplicaciones dividiendo nuestro código en módulos separados que han sido importados en los lugares que los necesitan. Aunque los módulos ES6 están definidos en el estándar ECMAScript, no todos los entornos de ejecución manejan automáticamente el código basado en módulos. Incluso los navegadores modernos se benefician de que las dependencias se preprocesen y optimicen antes de ser entregadas.

\n

Por esta razón, el código dividido en módulos se empaqueta para producción, es decir, los archivos de código fuente se transforman y combinan en un conjunto optimizado de archivos que el navegador puede cargar eficientemente. Cuando ejecutamos npm run build en partes anteriores del curso, Vite realizó este bundling. La salida aparece en el directorio dist:

\n
├── assets\n│   ├── index-d526a0c5.css\n│   ├── index-e92ae01e.js\n│   └── react-35ef61ed.svg\n├── index.html\n└── vite.svg
\n

El archivo index.html de la raíz carga el JavaScript empaquetado con una etiqueta script:

\n
<!doctype html>\n<html lang=\"en\">\n  <head>\n    <meta charset=\"UTF-8\" />\n    <link rel=\"icon\" type=\"image/svg+xml\" href=\"/vite.svg\" />\n    <meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\" />\n    <title>Vite + React</title>\n    <script type=\"module\" crossorigin src=\"/assets/index-e92ae01e.js\"></script>    <link rel=\"stylesheet\" href=\"/assets/index-d526a0c5.css\">  </head>\n  <body>\n    <div id=\"root\"></div>\n  </body>\n</html>
\n

El CSS también se empaqueta en un único archivo.

\n

En la práctica, el bundling parte de un entry point, que normalmente es main.jsx. Vite incluye no solo el código del entry point, sino también todo lo que este importa, recursivamente, hasta que se resuelve el grafo completo de dependencias.

\n

Dado que parte de los archivos importados son paquetes como React, Redux y Axios, el archivo JavaScript empaquetado también contendrá el contenido de cada una de esas librerías.

\n
\n

Antes de que existieran los bundlers, el enfoque antiguo se basaba en que el archivo index.html cargaba todos los archivos JavaScript separados de la aplicación con ayuda de etiquetas script. Esto provocaba un peor rendimiento, ya que la carga de cada archivo separado genera cierta sobrecarga. Por eso, hoy en día el método preferido es agrupar el código en un solo archivo. El bundling también permite optimizaciones como la minificación y el tree-shaking (eliminación de código no utilizado).

\n
\n

Cómo funciona Vite

\n

Vite tiene dos modos de funcionamiento claramente distintos, y funcionan de forma bastante diferente.

\n

Modo de desarrollo (npm run dev) no empaqueta tu código en absoluto. En su lugar, Vite arranca un servidor de desarrollo que sirve los archivos fuente como módulos ES nativos, dejando que el navegador resuelva los imports directamente. Por eso el arranque es casi instantáneo independientemente del tamaño del proyecto.\nHay una excepción: las dependencias de terceros de node_modules se preempaquetan con esbuild antes de que arranque el servidor. Esto resuelve dos problemas: muchos paquetes de npm siguen estando en formato CommonJS (que los navegadores no pueden consumir nativamente) y algunas librerías consisten en cientos de pequeños archivos internos que, de otro modo, provocarían cientos de peticiones separadas. esbuild convierte y consolida esas dependencias, cachea el resultado en disco, y los siguientes arranques son casi instantáneos.

\n

Modo de producción (npm run build) utiliza Rollup para el bundling, con esbuild encargándose todavía de otras tareas como la transpilación (JSX, TypeScript) y la minificación. Rollup fue diseñado desde el principio para módulos ES, lo que lo hace especialmente bueno en tree-shaking, una técnica que analiza estáticamente qué exports de cada módulo se usan realmente y elimina el resto del bundle final. Por ejemplo, si importas una sola función de utilidad de una librería grande, el tree-shaking garantiza que el resto del código de esa librería no se incluya en el bundle. Esto puede reducir significativamente el tamaño final.

\n

La división del trabajo, esbuild para la velocidad y Rollup para la calidad del bundle, es central en el diseño de Vite.

\n
\n

Puede que te preguntes por qué Vite no usa simplemente esbuild también para el bundling en producción, dado lo rápido que es. La razón es que la salida de bundling de esbuild, aunque correcta, produce resultados menos optimizados en escenarios avanzados: tiene soporte limitado para code splitting, no genera el mismo nivel de optimización de chunks y su ecosistema de plugins para transformaciones a nivel de bundle todavía está madurando. La salida de Rollup es más predecible y está mejor ajustada para los grafos de dependencias complejos que producen las aplicaciones reales. Los autores de Vite han afirmado que su intención es cambiar a esbuild para el bundling de producción cuando sus capacidades cierren esa brecha.

\n
\n

Entendiendo esbuild

\n

Para entender qué implica realmente el bundling, es útil trabajar directamente con esbuild, sin la capa de abstracción que Vite añade encima. Construyamos un entorno React mínimo desde cero.

\n

Vamos a crear una app React sencilla con la siguiente estructura de directorios:

\n
├── dist\n│   └── index.html\n├── src\n│   ├── main.jsx\n│   └── App.jsx\n└── package.json
\n

Empezamos instalando React y react-dom:

\n
npm install react react-dom
\n

También necesitamos instalar esbuild:

\n
npm install --save-dev esbuild
\n

Al principio añadimos dos scripts al archivo package.json:

\n
{\n  \"scripts\": {\n    \"build\": \"esbuild src/main.jsx --bundle --outfile=dist/main.js --jsx=automatic\",\n    \"serve\": \"npx serve dist\"\n  },\n  // ...\n}
\n

Para la app necesitamos el archivo dist/index.html, que carga el bundle JavaScript:

\n
<!DOCTYPE html>\n<html lang=\"en\">\n  <head>\n    <meta charset=\"UTF-8\" />\n    <title>esbuild app</title>\n  </head>\n  <body>\n    <div id=\"root\"></div>\n    <script src=\"./main.js\"></script>\n  </body>\n</html>
\n

El entry point src/main.jsx es el típico:

\n
import React from 'react'\nimport ReactDOM from 'react-dom/client'\nimport App from './App'\n\nReactDOM.createRoot(document.getElementById('root')).render(<App />)
\n

El componente simple de la aplicación src/App.jsx es el siguiente:

\n
import React, { useState } from 'react'\n\nconst App = () => {\n  const [counter, setCounter] = useState(0)\n\n  return (\n    <div>\n      <p>count: {counter}</p>\n      <button onClick={() => setCounter(counter + 1)}>increment</ button>\n    </div>\n  )\n}\n\nexport default App
\n

Ahora podemos empaquetar la app:

\n
npm run build
\n

La salida es un único dist/main.js que contiene el código de tu aplicación junto con la librería React empaquetada.

\n

Ahora podemos ejecutar la app empaquetada con npm run serve. Esto usa el paquete serve para iniciar un servidor estático local para el directorio dist, dejando la aplicación disponible en http://localhost:3000:

\n\n

esbuild también soporta minificación mediante flags de línea de comandos. La minificación elimina espacios en blanco y comentarios, acorta nombres de variables y aplica otras optimizaciones de tamaño. El bundle será notablemente grande porque incluye la librería React completa. La minificación reduce mucho su tamaño.

\n

Activemos ahora la minificación:

\n
{\n  \"scripts\": {\n    \"build\": \"esbuild src/main.jsx --bundle --minify --outfile=dist/main.js --jsx=automatic\",    \"serve\": \"npx serve dist\"\n  }\n}
\n

La minificación reduce el tamaño del bundle de alrededor de 1,1 MB a unos 190 KB, una reducción importante.

\n

La minificación tiene una contrapartida: si la aplicación lanza un error en tiempo de ejecución, las herramientas de desarrollo del navegador señalarán una línea del archivo minificado main.js, que es prácticamente imposible de leer:

\n\n

La solución es un source map: un archivo complementario (dist/main.js.map) que registra cómo cada línea del bundle minificado corresponde al código fuente original. Con él activado, un stack trace apunta a la línea exacta de App.jsx o main.jsx en lugar de hacerlo a un muro ilegible de código minificado.

\n

Podemos activar los source maps añadiendo el flag --sourcemap:

\n
{\n  \"scripts\": {\n    \"build\": \"esbuild src/main.jsx --bundle --minify --sourcemap --outfile=dist/main.js --jsx=automatic\",    \"serve\": \"npx serve dist\"\n  }\n}
\n

Ahora el error tiene sentido:

\n\n

Ten en cuenta que los source maps son muy valiosos durante el desarrollo y la depuración, pero puede que quieras dejarlos fuera de un build público de producción. Como un source map contiene tu código fuente original, cualquiera que abra las herramientas de desarrollo del navegador puede leer la lógica sin minificar de tu aplicación. Si eso te preocupa, simplemente omite el flag --sourcemap en el comando de build de producción.

\n

Transpilación

\n

Junto con el bundling, esbuild realiza otra tarea esencial: la transpilación. Transpilar significa convertir código fuente escrito en una forma de JavaScript a otra forma, normalmente de sintaxis moderna o extendida a JavaScript plano que el navegador pueda ejecutar.

\n

Los navegadores entienden JavaScript estándar, pero JSX no es JavaScript válido y ningún navegador puede parsearlo directamente. Cuando escribimos:

\n
const element = <App />
\n

hay que transpilarlo a algo que el navegador sí pueda ejecutar:

\n
const element = React.createElement(App, null)
\n

Por eso la transpilación es un paso obligatorio en cualquier proyecto React, no una optimización opcional. esbuild la realiza automáticamente durante el bundling. Con el flag --jsx=automatic, esbuild maneja JSX sin ninguna herramienta externa. En el flujo antiguo basado en Webpack había que instalar y configurar Babel y paquetes relacionados para transpilar JSX para el navegador. Con esbuild, los archivos que terminan en .jsx se transpilan directamente.

\n

Entorno de desarrollo

\n

Hasta ahora, cada cambio requiere ejecutar npm run build y refrescar manualmente el navegador, un ciclo lento que rápidamente se vuelve tedioso. El servidor de desarrollo integrado de esbuild resuelve esto. Añade un script dev a package.json:

\n
{\n  \"scripts\": {\n    \"build\": \"esbuild src/main.jsx --bundle --minify --sourcemap --outfile=dist/main.js --jsx=automatic\",\n    \"serve\": \"npx serve dist\",\n    \"dev\": \"esbuild src/main.jsx --bundle --outfile=dist/main.js --jsx=automatic --servedir=./dist --watch\"  }\n}
\n

Ejecutar npm run dev hace dos cosas a la vez. En primer lugar, --watch le dice a esbuild que observe todos los archivos fuente importados y reconstruya el bundle automáticamente siempre que alguno se guarde. En segundo lugar, --servedir inicia un servidor HTTP ligero que sirve el contenido del directorio dist, tu index.html y el main.js recién generado en http://localhost:8000.

\n

El flag --servedir es lo que hace que ambas piezas funcionen juntas: sin él, esbuild solo reconstruiría en modo watch pero no serviría nada. Con él, el servidor siempre entrega el último bundle, así que solo necesitas refrescar el navegador después de guardar un archivo.

\n

Ten en cuenta que, a diferencia del servidor de desarrollo de Vite, esbuild no soporta hot module replacement. Los cambios en el código fuente requieren un refresco manual del navegador para surtir efecto.

\n

La claridad de la interfaz de esbuild ilustra lo que hace fundamentalmente un bundler: toma un entry point, sigue todos los imports y produce una salida optimizada. Vite construye encima de esta base y añade la capa de experiencia de desarrollo: un servidor dev, hot module replacement y valores por defecto sensatos para proyectos React.

\n

Ahora que tenemos una imagen más clara de lo que implican realmente el bundling y la transpilación, volvamos a Vite y veamos cómo puede configurarse.

\n

Configuración de Vite

\n

Para la mayoría de los proyectos React, Vite funciona sin ninguna configuración. Sin embargo, cuando sí necesitas personalizar su comportamiento, editas vite.config.js (o vite.config.ts).

\n

Una configuración mínima de Vite para un proyecto React se ve así:

\n
import { defineConfig } from 'vite'\nimport react from '@vitejs/plugin-react'\n\nexport default defineConfig({\n  plugins: [react()],\n})
\n

El plugin @vitejs/plugin-react habilita la transformación de JSX, fast refresh (hot module replacement que conserva el estado del componente) y otras características específicas de React.

\n

Configuración del servidor de desarrollo

\n

Puedes configurar el puerto del servidor de desarrollo y otros ajustes bajo la clave server:

\n
export default defineConfig({\n  plugins: [react()],\n  server: {\n    port: 3000,\n    open: true,        // open browser automatically\n  },\n})
\n

Proxy de peticiones API

\n

Cuando desarrollas en local, tu app React normalmente se ejecuta en un puerto (por ejemplo, 3000) mientras que tu backend corre en otro (por ejemplo, 3001). La política same-origin del navegador normalmente bloquearía las peticiones entre ambos. La configuración de proxy de Vite resuelve esto sin requerir configuración CORS en el backend:

\n
export default defineConfig({\n  plugins: [react()],\n  server: {\n    port: 3000,\n    proxy: {\n      '/api': {\n        target: 'http://localhost:3001',\n        changeOrigin: true,\n      },\n    },\n  },\n})
\n

Con esta configuración, cualquier petición que tu app React haga a /api/notes se reenviará automáticamente a http://localhost:3001/api/notes a través del servidor de desarrollo de Vite. Tu código frontend nunca necesita incluir localhost:3001 en sus URLs durante el desarrollo.

\n

Variables de entorno

\n

Vite incluye soporte integrado para variables de entorno mediante archivos .env. Este es el reemplazo moderno de inyectar constantes manualmente en el bundle.

\n

Crea un archivo .env en la raíz del proyecto:

\n
VITE_BACKEND_URL=http://localhost:3001/api/notes
\n

Y un archivo .env.production para los valores de producción:

\n
VITE_BACKEND_URL=https://myapp.fly.dev/api/notes
\n

Importante: todas las variables de entorno expuestas al navegador deben empezar con el prefijo VITE_. Las variables sin este prefijo permanecen solo del lado del servidor y no se incluyen en el bundle. Es una medida de seguridad deliberada para evitar filtrar secretos accidentalmente.

\n

Accede a la variable en el código de tu aplicación a través de import.meta.env:

\n
const App = () => {\n  const notes = useNotes(import.meta.env.VITE_BACKEND_URL)\n\n  return (\n    <div>\n      {notes.length} notes on server {import.meta.env.VITE_BACKEND_URL}\n    </div>\n  )\n}
\n

Vite selecciona automáticamente el archivo .env correcto según el modo:

\n\n

Añade .env.production a .gitignore si contiene valores sensibles, y utiliza .env.example para documentar qué variables son necesarias.

\n

Transpilación

\n

Vite gestiona la transpilación del código automáticamente. Durante el desarrollo, esbuild transpila tu TypeScript y JSX bajo demanda. Es lo bastante rápido como para hacerlo archivo por archivo sin retraso apreciable. Durante los builds de producción, Rollup se encarga del bundling mientras que esbuild realiza la transpilación.

\n

El objetivo de transpilación por defecto en Vite son navegadores modernos que soportan módulos ES nativos (Chrome 87+, Firefox 78+, Safari 14+, Edge 88+). Si necesitas soportar navegadores más antiguos, puedes configurar el target explícitamente y añadir el plugin @vitejs/plugin-legacy:

\n
npm install --save-dev @vitejs/plugin-legacy
\n
import { defineConfig } from 'vite'\nimport react from '@vitejs/plugin-react'\nimport legacy from '@vitejs/plugin-legacy'\n\nexport default defineConfig({\n  plugins: [\n    react(),\n    legacy({\n      targets: ['defaults', 'not IE 11'],\n    }),\n  ],\n})
\n

El plugin legacy genera automáticamente un bundle separado para navegadores antiguos usando Babel.

\n

CSS

\n

Vite maneja CSS sin ninguna configuración. Simplemente importa un archivo CSS desde tu JavaScript:

\n
import './index.css'
\n

Vite lo procesará y lo incluirá en el build. En producción, el CSS se extrae a un archivo separado. Durante el desarrollo, se inyecta mediante etiquetas <style> con soporte de hot reload.

\n

Vite también soporta de forma nativa CSS Modules para estilos con alcance local. Cualquier archivo que termine en .module.css se trata como un CSS Module:

\n
import styles from './App.module.css'\n\nconst App = () => (\n  <div className={styles.container}>\n    hello vite\n  </div>\n)
\n

Los preprocessors de CSS como Sass pueden añadirse simplemente instalando el preprocessor, sin plugin ni configuración adicional:

\n
npm install --save-dev sass
\n

Después de eso, los archivos .scss funcionan automáticamente.

\n

Minificación

\n

Al ejecutar npm run build, Vite minifica la salida. La minificación elimina espacios en blanco y comentarios, acorta nombres de variables y aplica otras optimizaciones de tamaño. El resultado es un archivo mucho más pequeño que carga más rápido en el navegador.

\n

Vite usa esbuild para la minificación de JavaScript y un minificador integrado de CSS para las hojas de estilo.

\n

Source maps

\n

Los source maps permiten que las herramientas de desarrollo del navegador mapeen errores y breakpoints a tu código fuente original en lugar de al bundle minificado. Sin ellos, un stack trace que apunta a la línea 1 de main.js sirve de muy poco para depurar.

\n

En desarrollo, Vite genera source maps automáticamente. Para builds de producción, puedes habilitarlos explícitamente:

\n
export default defineConfig({\n  plugins: [react()],\n  build: {\n    sourcemap: true,\n  },\n})
\n

Ten en cuenta que los source maps de producción aumentan el tiempo de build y exponen tu código fuente a cualquiera que mire la pestaña de red. En muchos casos, es mejor subir los source maps a un servicio de monitorización de errores (como Sentry) y no publicarlos en el servidor.

\n

Plugins

\n

La funcionalidad de Vite se amplía mediante plugins. El ecosistema de plugins ha crecido rápidamente y cubre la mayoría de las necesidades comunes. Algunos plugins ampliamente utilizados incluyen:

\n\n

Los plugins se especifican en el array plugins dentro de vite.config.js. Siguen la misma interfaz que los plugins de Rollup, por lo que muchos plugins de Rollup también funcionan con Vite.

\n

Polyfills

\n

Un polyfill es código que implementa una funcionalidad para navegadores que no la soportan de forma nativa. La transpilación por sí sola no basta para características que son sintácticamente válidas pero no están implementadas. Por ejemplo, un navegador puede parsear Promise correctamente pero no tener implementación de esa API.

\n

Con Vite, los polyfills se gestionan mediante el plugin @vitejs/plugin-legacy, que incluye automáticamente los polyfills necesarios según tus targets de navegador. Si necesitas un polyfill específico sin usar el plugin legacy, puedes instalarlo directamente e importarlo al principio de tu archivo de entrada.

\n

Puedes consultar la compatibilidad de APIs concretas en https://caniuse.com o en la documentación MDN de Mozilla.

\n
","frontmatter":{"mainImage":{"publicURL":"/static/2184b1c35920cfc7a09e10660dea04eb/part-7.svg"},"part":7,"letter":"b","lang":"es"}}},"pageContext":{"part":7,"letter":"b","lang":"es"}},"staticQueryHashes":["3128451518"]}