En la auditoría de noviembre de 36 sitios en producción del escaparate Nuxt Showcase, me llamó la atención una cifra: el tamaño mediano del bloque oculto de estado dentro del documento es de 93 KB, devorando el 29% del volumen del marcado. Normalmente se buscan culpables de la carga lenta entre imágenes pesadas o bundles, asumiendo que el HTML es un esqueleto ligero. Pero en la práctica, en 17 proyectos ese lastre supera el umbral amarillo de 100 KB, en 6 sitios rompe la marca roja de 500 KB, y varias tiendas grandes envían en el HTML de inicio entre 120 y 280 KB de diccionarios de localización.
En esa misma trampa cayó la plataforma de esports BIGPLAY hecha con Nuxt: una página de inicio sobria creció a más de medio megabyte de texto, aunque al visitante solo se le muestran un par de docenas de frases. Veamos cómo la hidratación convierte el estado en lastre de red, cómo radiografiar el sitio con la utilidad nuxt-payload-xray y cómo sacar las traducciones a una caché eterna.
El peso invisible de la hidratación: por qué Nuxt esconde el estado dentro del HTML
Con Server-Side Rendering, el navegador recibe de inmediato el HTML ya renderizado. Acto seguido se descarga el JavaScript del cliente, que debe «dar vida» a la página: enlazar manejadores de clics y activar menús. Ese paso se llama hidratación.
Es como enviar un mueble armado por correo: para que puedas mover las palancas enseguida sin llamar a la fábrica, meten en la caja el inventario completo de ajustes. Sin esos datos, tras cargar los scripts el navegador tendría que volver a consultar al backend, provocando parpadeos en pantalla. Por eso el framework reúne el estado de useState, useAsyncData, useFetch y los stores y lo escribe al final del HTML dentro de <script type="application/json" id="__NUXT_DATA__">.
Dentro de la etiqueta, los datos viven como un arreglo plano con referencias por índice: el elemento cero apunta a la raíz y las cadenas repetidas se escriben una sola vez. La deduplicación ahorra espacio en repeticiones, pero dispara una cadena de efectos:
- si durante la petición en servidor guardas en el estado un catálogo entero o toda la respuesta de la API, el serializador lo empaqueta completo en el arreglo;
- al ir incrustado en el HTML, el navegador no lo cachea entre visitas como un script estático: al recargar la pestaña o entrar desde el buscador, todo el volumen se descarga otra vez;
- y si antes de hidratar el navegador debe parsear cientos de kilobytes de JSON en el hilo principal de la CPU, en móviles la interfaz se congela.
Durante el desarrollo cuesta notarlo: al navegar con NuxtLink no se pide un nuevo HTML y los datos salen de memoria. En el portátil del ingeniero todo vuela, mientras los usuarios que llegan desde Google esperan la descarga de un marcado pesado.
Radiografía a la respuesta del servidor: cómo nuxt-payload-xray detecta las claves pesadas
Los auditores de velocidad habituales solo se quejan del tamaño del HTML sin señalar la clave culpable en __NUXT_DATA__. El panel de depuración integrado en Nuxt muestra el peso de las claves solo en local en modo dev, y los analizadores estáticos revisan _payload.json únicamente al compilar con nuxt generate.
El desarrollador de BIGPLAY Dauren, bajo el alias dadashi44, contó en un artículo en Habr cómo escribió la utilidad nuxt-payload-xray para auditar servidores en vivo. La herramienta consulta una página por URL sin acceso al código, localiza __NUXT_DATA__, recorre las referencias del arreglo desde data, state y pinia y calcula el peso de cada rama.
Revisemos por terminal las claves más pesadas de un sitio en vivo y fijemos un límite de peso para el entorno de pruebas en CI/CD:
# Inspección de las claves más pesadas del payload en una página en vivo
npx nuxt-payload-xray https://nuxt.com --top 10
# Comprobación del límite de peso en CI/CD devolviendo código de error si se supera
npx nuxt-payload-xray "$PREVIEW_URL" --max 150kb
El primer comando descarga el HTML y muestra un diagrama: tamaño bruto y en gzip del paquete, porcentaje del HTML y ranking de claves. El segundo comando con la bandera --max protege el despliegue: si la página en el entorno de preview supera la cota de 150kb, el script devuelve código de salida 1 y frena la publicación.
Es reveladora la medición del propio sitio nuxt.com: el paquete de datos pesa 196.6 KB, o 51.3 KB en gzip, lo que representa el 36% de un documento de 546.3 KB. Lidera la clave data: navigation:4.x con 77.7 KB, seguida de data: index con 49.6 KB y data: official-modules con 40.4 KB. Dentro de navigation:4.x vive el menú de 429 secciones de documentación para la búsqueda instantánea con Ctrl+K. De ahí sale una regla clara: una clave grande que la página necesita entera es un precio justo por la función; una clave grande de la que solo usas una mínima parte es un error.
La trampa de la localización: cómo el diccionario de todo el sitio se cuela en cada página
Cuando Dauren escaneó la portada de BIGPLAY antes de optimizar, el HTML sin comprimir pesaba 658 KB, de los cuales 271 KB correspondían al paquete de hidratación. Adentro viajaba la clave translations con 218 KB: 2271 líneas de traducciones de todas las secciones del portal, incluidos el área privada y los ajustes de perfil.
La causa estaba en un patrón engañosamente cómodo: un middleware de servidor traía las traducciones de un servicio externo y un plugin las guardaba en useState('translations') para que la localización funcionara en servidor y cliente. Como useState sincroniza los datos con el navegador, el framework serializaba todo el diccionario en cada página.
Los textos de la interfaz cambian poco, así que sacaron el diccionario a un archivo independiente. El servidor calcula el hash SHA-1 del diccionario y lo sirve en /i18n/ru.<hash>.json con la cabecera Cache-Control: public, max-age=31536000, immutable, cacheándolo por un año.
Veamos cómo cambió el código: en useState solo queda un hash corto de versión y en <head> se añade la precarga del archivo:
// Antes: todo el diccionario entra en useState y se serializa en el HTML
// const translations = useState('translations', () => ({}))
// Ahora: en el payload solo se guarda un hash SHA-1 corto de la versión del diccionario
const translationVersion = useState('i18n_ver', () => 'a1b2c3d4e5f6')
useHead({
link: [
{
rel: 'preload',
href: `/i18n/ru.${translationVersion.value}.json`,
as: 'fetch',
crossorigin: 'anonymous'
}
]
})
Ahora a __NUXT_DATA__ solo viaja la cadena 'a1b2c3d4e5f6' de doce caracteres. El servidor renderiza el HTML con el diccionario completo desde memoria para los buscadores, mientras <link rel="preload" as="fetch"> hace que el navegador descargue el JSON en paralelo con el documento. Me fijé especialmente en el atributo crossorigin="anonymous": sin él, el modo CORS no coincide con fetch() y el navegador descarga el diccionario dos veces. Sobre la precarga de recursos por ruta también hablé en el artículo Ecosistema Nuxt: precarga de fuentes por ruta y aceleración del renderizado de iconos.
Durante el despliegue esquivaron otras dos trampas. Primero, el archivo no puede vivir bajo /api/ si esa ruta está bloqueada en robots.txt: de lo contrario Googlebot no descargará el diccionario e indexará las claves crudas, así que eligieron /i18n/. Segundo, un HTML servido desde caché de servidor podría pedir un hash antiguo tras actualizar traducciones (sobre reglas de caché escribí en el análisis de Nuxt v4.6.4: lanzamiento urgente de seguridad, validación de hosts y nuevas reglas de caché en Nitro). Para que las páginas no se rompan, el servidor conserva en memoria las últimas versiones del diccionario y ante un hash desconocido entrega el diccionario vigente con Cache-Control: no-store.
Resultados en producción y el límite razonable de optimización
Una nueva pasada de nuxt-payload-xray en bigplay.gg mostró una imagen limpia: el HTML sin comprimir de la portada bajó a 191.6 KB y el bloque de hidratación cayó a 55.9 KB, o 15.7 KB en gzip, mientras que en el resumen de la medición de prueba el volumen se redujo de 256 a 47 KB. Ahora el 97% del paquete —54.3 KB— lo ocupa la clave data: home-page-ru con torneos y banners, mientras que los stores pinia: tournamentsPageStore y pinia: translationState pesan 172 B y 132 B.
En el build de producción en gzip, la ganancia por rutas queda así:
| Página del portal | Peso HTML: antes → después | Peso payload: antes → después |
|---|---|---|
| Inicio | 112 KB → 59 KB | 66 KB → 12 KB |
Versión en inglés /en | 96 KB → 58 KB | 50 KB → 12 KB |
| Lista de torneos | 101 KB → 48 KB | 56 KB → 3 KB |
En la primera visita el ahorro de red es casi nulo, porque el diccionario de 53 KB en gzip se descarga como archivo aparte. En cambio, en visitas posteriores el diccionario sale de caché con 0 bytes, reduciendo el peso de la página a la mitad.
En este caso me convence mucho el cálculo del autor sobre por qué no vale la pena trocear más el diccionario para cada página:
- Si divides por secciones, el encabezado, el pie de página y los modales están en todas partes y arrastran el 68–82% del diccionario.
- Si divides por claves, cada página usa el 21–32% de las líneas, pero en el código solo se detectan estáticamente el 58% de las claves: el resto se arma de forma dinámica y un fallo del parser mostraría al usuario un crudo
tournament_page.xxx. - Si comparas los flujos de carga, el diccionario se descarga en paralelo con el bundle JS de la portada, que pesa 317 KB en gzip. La interactividad llega después de cargar el JS, así que exprimir el diccionario no acelerará la respuesta.
Para mantener en forma las respuestas del servidor en tus proyectos, guíate por tres principios prácticos:
- Radiografía las páginas por URL: ejecuta
npx nuxt-payload-xray <url>en las rutas clave y comprueba qué fracción de las claves pesadas se ve realmente en pantalla. - Recorta campos sobrantes de la API: en
useFetch('/api/tournaments', { pick: ['id', 'title', 'startDate'] })extrae conpicksolo los campos que usa la plantilla y no metas en los stores toda la respuesta del backend. - Saca los datos estáticos de
useState: traducciones, catálogos y configuraciones que cambian poco deben servirse en archivos aparte cacheados por hash.
El primer paso capturó casi todo el beneficio sin arriesgar la estabilidad de la interfaz, y saber detenerse a tiempo sin construir un parser frágil por un ahorro marginal es la mejor muestra de pragmatismo ingenieril.

![Node.JS [ru]](/api/digests/it_development/daily/20261110/assets/sources/we-use-js.jpg?v=4e739904da309a5c1bd405ffe4bb4ed8fa29b8896a994311dcb46db77318c887)