В ноябрьском аудите 36 продакшен-сайтов из витрины Nuxt Showcase меня зацепила одна цифра: медианный размер скрытого блока состояния внутри документа составляет 93 КБ, съедая 29% объема разметки. Обычно виновников медленной загрузки ищут среди тяжелых картинок или бандлов, считая HTML легким каркасом. Но на деле у 17 проектов этот довесок превышает желтый порог в 100 КБ, у 6 сайтов пробивает красную отметку в 500 КБ, а несколько крупных магазинов пересылают в разметке главной от 120 до 280 КБ словарей локализации.
В такую же ловушку попала киберспортивная платформа BIGPLAY на Nuxt: лаконичная главная разрослась больше чем на полмегабайта текста, хотя гостю на ней нужно показать лишь пару десятков фраз. Разберемся, как гидратация превращает состояние в сетевой балласт, как просветить сайт через утилиту nuxt-payload-xray и как вынести переводы в вечный кэш.
Невидимый груз гидратации: зачем Nuxt прячет состояние внутри HTML
При серверном рендеринге (Server-Side Rendering) браузер сразу получает готовую верстку. Следом загружается клиентский JavaScript, которому нужно «оживить» страницу — привязать обработчики кликов и запустить меню. Этот шаг называется гидратацией.
Это как отправка собранного конструктора по почте: чтобы ты сразу переключал рычаги без звонков на завод, в коробку кладут опись настроек. Без этих данных браузеру после загрузки скриптов пришлось бы заново опрашивать бэкенд, вызывая мигание экрана. Поэтому фреймворк собирает состояние из useState, useAsyncData, useFetch и сторов и пишет их в конец HTML внутри <script type="application/json" id="__NUXT_DATA__">.
Внутри тега данные лежат как плоский массив со ссылками по индексам: нулевой элемент указывает на корень, а повторяющиеся строки пишутся один раз. Дедупликация экономит место на повторах, но запускает цепочку:
- если во время серверного запроса ты кладешь в состояние справочник или весь ответ API, сериализатор упаковывает его в массив целиком;
- если блок вшит в HTML, браузер не кэширует его между визитами как статический скрипт — при обновлении вкладки или переходе из поиска весь объем качается заново;
- а если до гидратации браузер должен распарсить сотни килобайт JSON в основном потоке процессора, на смартфонах интерфейс замирает.
При разработке заметить это трудно: при переходах через NuxtLink новый HTML не запрашивается, а данные берутся из памяти. На ноутбуке инженера все летает, пока пользователи из поиска ждут загрузки тяжелой разметки.
Рентген серверного ответа: как nuxt-payload-xray вычисляет тяжелые ключи
Стандартные аудиторы скорости лишь жалуются на большой HTML, не называя виновный ключ в __NUXT_DATA__. Встроенная панель отладки Nuxt подсвечивает вес ключей только локально в dev-режиме, а анализаторы статики проверяют _payload.json лишь при сборке через nuxt generate.
Разработчик BIGPLAY Даурен под ником dadashi44 в разборе на Хабре рассказал, как написал для проверки живых серверов утилиту nuxt-payload-xray. Она обращается к странице по URL без доступа к коду, находит __NUXT_DATA__, проходит по ссылкам массива от ключей data, state и pinia и считает вес каждой ветки.
Проверим через терминал самые тяжелые ключи на живом сайте и зададим лимит веса для тестового стенда в CI/CD:
# Инспекция самых тяжелых ключей payload на живой странице
npx nuxt-payload-xray https://nuxt.com --top 10
# Проверка лимита веса в CI/CD с возвратом кода ошибки при превышении
npx nuxt-payload-xray "$PREVIEW_URL" --max 150kb
Первая команда скачивает разметку и выводит диаграмму: сырой и сжатый в gzip размер пакета, долю от HTML и рейтинг ключей. Вторая команда с флагом --max страхует сборку: если страница на превью-стенде превысит планку 150kb, скрипт вернет код ошибки 1 и остановит выкатку.
Показателен замер самого сайта nuxt.com: пакет данных весит 196,6 КБ или 51,3 КБ в gzip — это 36% от документа на 546,3 КБ. Лидирует ключ data: navigation:4.x на 77,7 КБ, далее идут data: index на 49,6 КБ и data: official-modules на 40,4 КБ. Внутри navigation:4.x лежит меню из 429 разделов документации для мгновенного поиска по Ctrl+K. Отсюда правило: большой ключ, который нужен странице целиком, — честная цена за функцию; большой ключ, из которого нужна малая доля, — ошибка.
Ловушка локализации: как словарь всего сайта попадает в каждую страницу
Когда Даурен просканировал главную BIGPLAY до оптимизации, несжатый HTML весил 658 КБ, из которых 271 КБ занимал пакет гидратации. Внутри лежал ключ translations на 218 КБ — 2271 строка переводов всех разделов портала, включая личный кабинет и настройки профиля.
Причина крылась в обманчиво удобной схеме: серверный middleware забирал переводы из внешнего сервиса, а плагин клал их в useState('translations'), чтобы локализация работала на сервере и клиенте. Поскольку useState синхронизирует данные с браузером, фреймворк сериализовал весь словарь в каждую страницу.
Тексты интерфейса меняются редко, поэтому словарь вынесли в отдельный файл. Сервер считает SHA-1 хеш словаря и отдает его по адресу /i18n/ru.<хеш>.json с заголовком Cache-Control: public, max-age=31536000, immutable, кэшируя файл на год.
Посмотрим, как изменился код: вместо словаря в useState остается короткий хеш версии, а в <head> добавляется предзагрузка файла:
// Было: весь словарь попадает в useState и сериализуется в HTML
// const translations = useState('translations', () => ({}))
// Стало: в payload хранится только короткий SHA-1 хеш версии словаря
const translationVersion = useState('i18n_ver', () => 'a1b2c3d4e5f6')
useHead({
link: [
{
rel: 'preload',
href: `/i18n/ru.${translationVersion.value}.json`,
as: 'fetch',
crossorigin: 'anonymous'
}
]
})
Теперь в __NUXT_DATA__ уезжает строка 'a1b2c3d4e5f6' из двенадцати символов. Сервер рендерит HTML с полным словарем из памяти для поисковиков, а <link rel="preload" as="fetch"> заставляет браузер качать JSON параллельно с документом. Я специально обратил внимание на атрибут crossorigin="anonymous": без него режим CORS не совпадет с fetch(), и браузер скачает словарь дважды. О предзагрузке ресурсов по маршрутам я также рассказывал в статье Экосистема Nuxt: предзагрузка шрифтов по маршрутам и ускорение рендеринга иконок.
При выкатке обошли еще две ловушки. Во-первых, файл нельзя класть в /api/, если путь закрыт в robots.txt: иначе Googlebot не скачает словарь и проиндексирует сырые ключи — поэтому выбрали /i18n/. Во-вторых, HTML из серверного кэша может запросить устаревший хеш после обновления переводов — о правилах кэширования я писал в разборе Nuxt v4.6.4: срочный релиз безопасности, проверка хостов и новые правила кэширования Nitro. Чтобы страницы не ломались, сервер держит последние версии словаря в памяти, а на неизвестный хеш отдает актуальный словарь с Cache-Control: no-store.
Результаты на продакшене и разумный предел оптимизации
Повторный прогон nuxt-payload-xray на bigplay.gg показал чистую картину: несжатый HTML главной сократился до 191,6 КБ, а блок гидратации — до 55,9 КБ или 15,7 КБ в gzip, тогда как в сводке тестового замера объем ужался с 256 до 47 КБ. Теперь 97% пакета — 54,3 КБ — занимает ключ data: home-page-ru с турнирами и баннерами, а сторы pinia: tournamentsPageStore и pinia: translationState весят 172 Б и 132 Б.
На прод-сборке в gzip выигрыш по маршрутам выглядит так:
| Страница портала | Вес HTML: было → стало | Вес payload: было → стало |
|---|---|---|
| Главная | 112 КБ → 59 КБ | 66 КБ → 12 КБ |
Английская версия /en | 96 КБ → 58 КБ | 50 КБ → 12 КБ |
| Список турниров | 101 КБ → 48 КБ | 56 КБ → 3 КБ |
На первом визите экономия по сети почти нулевая, так как словарь весом 53 КБ в gzip качается отдельным файлом. Зато на повторных заходах словарь берется из кэша за 0 байт, урезая вес страницы вдвое.
Меня в этом кейсе подкупает расчет автора, почему не стоит резать словарь дальше под каждую страницу:
- Если делить по разделам, то шапка, футер и модалки есть везде и тянут 68–82% словаря.
- Если делить по ключам, странице нужно 21–32% строк, но статически в коде находится лишь 58% ключей — остальные собираются динамически, и промах парсера покажет пользователю сырой
tournament_page.xxx. - Если сравнить потоки загрузки, словарь качается параллельно с JS-бандлом главной страницы весом 317 КБ в gzip. Интерактивность наступает после загрузки JS, поэтому ужимание словаря не ускорит отклик.
Чтобы держать серверный ответ в тонусе на своих проектах, ориентируйся на три рабочих принципа:
- Просвечивай страницы по URL: запускай
npx nuxt-payload-xray <url>на ключевых маршрутах и сверяй, какая доля тяжелых ключей видна на экране. - Отсекай лишние поля API: в
useFetch('/api/tournaments', { pick: ['id', 'title', 'startDate'] })забирай черезpickтолько нужные шаблону поля и не складывай в сторы весь ответ бэкенда. - Выноси статику из
useState: редко меняющиеся переводы, справочники и конфиги отдавай отдельными файлами с кэшированием по хешу.
Первый шаг забрал почти всю выгоду без риска сломать интерфейс, а умение вовремя остановиться и не строить хрупкий парсер ради копеечной экономии — лучшее проявление инженерного прагматизма.

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

