Saltar al contenido
Herramientas y ecosistema

Vite y el bundling moderno

Lección 2 de 610 min3 ejercicios

El navegador entiende módulos ES, pero no entiende TypeScript, ni JSX, ni import "lodash", y cargar cientos de archivos pequeños en producción es lento. Un empaquetador (bundler) traduce y une tu código para el navegador. Vite es hoy el más usado: rápido al desarrollar y cuidadoso al publicar.

Crear un proyecto

npm create vite@latest mi-app      # elige "Vanilla" o un framework, con o sin TypeScript
cd mi-app
npm install
npm run dev                        # http://localhost:5173

La estructura es simple: un index.html en la raíz (el punto de entrada, que carga tu src/main.js como módulo), la carpeta src y la carpeta public.

Dos modos

En desarrollo (vite), no empaqueta nada: sirve tus archivos como módulos ES y transforma al vuelo solo lo que el navegador pide (TypeScript, JSX, CSS). Por eso arranca en milisegundos, sin importar el tamaño del proyecto. Las dependencias de node_modules sí se preprocesan una vez, para que carguen rápido.

Con HMR (Hot Module Replacement), al guardar un archivo se reemplaza solo ese módulo en el navegador, sin recargar la página ni perder el estado.

En producción (vite build), empaqueta y optimiza: une los módulos en pocos archivos, elimina el código que no se usa (tree shaking), minifica, divide en partes que se cargan cuando hacen falta (por cada import() dinámico) y pone un hash en cada nombre (assets/index-3f9a1c.js). El resultado queda en dist/, listo para cualquier servidor de archivos estáticos.

npm run build        # genera dist/
npm run preview      # sirve dist/ para probarlo localmente

Importar de todo

Además de JavaScript, Vite entiende otros tipos de archivo en los import:

import "./estilos.css";                          // se inyecta en la página
import estilos from "./tarjeta.module.css";      // CSS Modules: clases con nombres únicos
import logo from "./logo.svg";                   // la URL final del archivo
import datos from "./datos.json";                // el objeto
import textoPlano from "./aviso.txt?raw";        // el contenido como texto
import Trabajador from "./calculo.js?worker";    // un Web Worker listo para usar

Lo que está en public/ se copia tal cual y se referencia desde la raíz (/favicon.ico), sin pasar por el empaquetador.

Configuración

Vite funciona sin configuración. Cuando hace falta, vite.config.js:

import { defineConfig } from "vite";

export default defineConfig({
  server: {
    port: 3000,
    proxy: { "/api": "http://localhost:8080" },   // redirige las llamadas a tu servidor
  },
  build: {
    sourcemap: true,
  },
});

Los plugins agregan soporte para frameworks (React, Vue, Svelte) y para casi cualquier cosa. Vite usa la interfaz de plugins de Rollup, así que hay miles.

Variables de entorno

Los archivos .env, .env.development y .env.production definen variables. Solo las que empiezan con VITE_ llegan al código del navegador, a través de import.meta.env:

# .env
VITE_API_URL=https://api.tienda.com
DB_PASSWORD=no-llega-al-navegador
const api = import.meta.env.VITE_API_URL;
if (import.meta.env.DEV) console.log("modo desarrollo");

El ecosistema

Vite es la base de muchos frameworks: Astro (con el que está hecho este sitio), SvelteKit, Nuxt, Remix, SolidStart y otros. Su ejecutor de pruebas, Vitest, usa la misma configuración. Por debajo, Vite está migrando a Rolldown, un empaquetador escrito en Rust, para que el build sea todavía más rápido.

Resumen

  • Un empaquetador traduce y une tu código para el navegador.
  • En desarrollo, Vite sirve módulos ES sin empaquetar y actualiza con HMR.
  • vite build empaqueta, optimiza, divide y pone hash en los nombres: el resultado va en dist/.
  • Importa CSS, JSON, imágenes, textos y workers; public/ se copia tal cual.
  • Solo las variables VITE_ llegan al navegador, y todas son públicas.

¡A practicar!

Tu progreso se guarda en este navegador.

Autoevaluación: Del código al sitio publicado

Elige una respuesta en cada pregunta.

  1. ¿Por qué el servidor de desarrollo de Vite arranca tan rápido?

  2. ¿Qué es el HMR (Hot Module Replacement)?

  3. ¿Qué hace vite build?

  4. ¿Qué variables de entorno puede ver el código del navegador en Vite?

Ordena la salida: Variables de entorno

Cuatro valores de import.meta.env con el servidor de desarrollo. Ordena lo que aparecería en la consola del navegador.

// .env//   VITE_API=https://api.tienda.com//   CLAVE_SECRETA=abc123 // src/main.js, con el servidor de desarrollo (npm run dev)console.log(import.meta.env.VITE_API);console.log(import.meta.env.CLAVE_SECRETA);console.log(import.meta.env.MODE);console.log(import.meta.env.DEV);

Consola, de arriba abajo

  1. development
  2. https://api.tienda.com
  3. true
  4. undefined

Detective: Una variable que no llega

La URL de la API está en el .env, pero el código no la ve. Encuentra la línea y elige el arreglo.

Consola

Uncaught TypeError: Failed to construct 'URL': Invalid base URL
    at api.js:2:13

Paso 1: toca la línea de código que causa el error.

domina-js · JavaScript en español, gratis y paso a paso.