Автоматический контроль размера бандла в CI/CD: настройка и оптимизация

Бандл растёт незаметно — мы помогаем это контролировать

Вы добавили одну зависимость, коллега импортировал утилиту целиком — и через месяц JS-бандл потяжелел на 200 КБ. LCP просел на 30%, а виновник не найден. В 80% проектов разработчики замечают проблему только после деплоя в прод. Автоматическая проверка размера бандла в CI/CD останавливает деградацию до попадания в релиз. Наши инженеры с опытом 5+ лет настраивают такой контроль под ваш стек. Первичная консультация — бесплатно. Свяжитесь для аудита бандла.

Какие проблемы решаем

• Невидимый рост бандла — каждая новая зависимость увеличивает размер, но в PR этого не видно, пока LCP не вырастет на 30%. Например, импорт lodash целиком вместо lodash.get добавляет 20 КБ в gzip.
• Дублирование кода — одна и та же библиотека в разных чанках после code splitting, что увеличивает общий размер на 10-15%.
• Раздутие initial bundle — lazy-загрузка не настроена, и пользователь качает всё сразу, увеличивая TTI на 2 секунды.
• Отсутствие baseline — без истории изменений сложно отследить, какая версия внесла регрессию.

Как это работает

На каждый PR или деплой собираем бандл, сравниваем его размер и размер отдельных чанков с baseline — значениями из предыдущего деплоя или фиксированными лимитами. Если порог превышен — CI падает или оставляет предупреждение в PR. Это позволяет экономить до 500$ в месяц на поддержке производительности.

Инструменты делятся на два класса:

Как bundlewatch помогает контролировать размер бандла?

Устанавливаем:

npm install --save-dev bundlewatch

Конфигурация в package.json:

{
  "bundlewatch": {
    "files": [
      { "path": "dist/assets/index-*.js", "maxSize": "150kB" },
      { "path": "dist/assets/vendor-*.js", "maxSize": "400kB" },
      { "path": "dist/assets/*.css", "maxSize": "50kB" }
    ],
    "ci": {
      "trackBranches": ["main", "master"],
      "repoBranchBase": "main"
    }
  }
}

В GitHub Actions:

name: Bundle Size Check
on: [pull_request]
jobs:
  bundlewatch:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 20
          cache: npm
      - run: npm ci
      - run: npm run build
      - run: npx bundlewatch
        env:
          BUNDLEWATCH_GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
          CI_REPO_OWNER: ${{ github.repository_owner }}
          CI_REPO_NAME: ${{ github.event.repository.name }}
          CI_COMMIT_SHA: ${{ github.event.pull_request.head.sha }}
          CI_BRANCH: ${{ github.head_ref }}
          CI_BRANCH_BASE: ${{ github.base_ref }}

bundlewatch оставляет комментарий в PR с таблицей: текущий размер, delta, статус. Подробнее в bundlewatch.

Настройка size-limit: глубже, чем просто лимиты

size-limit анализирует дерево импортов: показывает вес модуля с учётом tree-shaking и gzip.

npm install --save-dev size-limit @size-limit/preset-app

.size-limit.json:

[
  {
    "path": "dist/assets/index-*.js",
    "limit": "150 kB",
    "gzip": true
  },
  {
    "name": "Vendor chunk",
    "path": "dist/assets/vendor-*.js",
    "limit": "380 kB",
    "gzip": true
  }
]

В package.json:

{
  "scripts": {
    "size": "size-limit",
    "analyze": "size-limit --why"
  }
}

--why запускает webpack-bundle-analyzer и показывает, что именно тянет размер.

Почему относительные лимиты удобнее абсолютных?

Абсолютные лимиты устаревают — проект растёт, и постоянно поднимать цифры надоедает. Альтернатива: проверять delta относительно base branch. Мы используем скрипт, который сравнивает размер текущей ветки с базовой. Скрипт выполняет сборку, сохраняет текущий размер, загружает размер базовой ветки из артефактов CI и вычисляет дельту. Если дельта превышает 10%, CI падает. Такой подход экономит время на настройку и не требует ручного обновления лимитов.

Что проверять помимо общего размера

• Количество чанков — рост числа чанков при code splitting может увеличить количество HTTP-запросов.
• Размер initial bundle отдельно от lazy-loaded чанков — именно он влияет на LCP и TTI.
• Дубли зависимостей — когда одна библиотека затягивается в несколько чанков в разных версиях. Для анализа: npm ls <package> или npx duplicate-package-checker-webpack-plugin.

Сравнение подходов: bundlewatch vs size-limit

Типичные ошибки и как их избежать

Некоторые команды забывают настроить кеширование, и проверка занимает 5+ минут. Мы используем кеширование node_modules и .vite, сокращая время до 40–60 секунд. Другая ошибка — устанавливают лимиты «на глаз». Правильно: замерить текущие размеры и задать с запасом 10–15%.

Что входит в работу

• Аудит текущего бандла и выявление проблемных мест.
• Настройка выбранного инструмента (bundlewatch или size-limit) с индивидуальными лимитами.
• Интеграция в CI/CD (GitHub Actions, GitLab CI, Bitbucket Pipelines).
• Документирование конфигурации и процесса поддержки.
• Обучение команды работе с уведомлениями и анализом.
• Пост-релизная поддержка в течение 1 месяца.

Сроки ориентировочно

Базовая настройка bundlewatch в существующий CI-пайплайн — от 4 до 8 часов. Настройка size-limit с анализом и уведомлениями в PR — от 1 до 2 рабочих дней. Стоимость рассчитывается индивидуально после оценки вашего проекта. Получите консультацию — мы расскажем, какой вариант оптимален. Закажите аудит бандла, и мы предложим конкретные решения.

Почему Core Web Vitals критичны для технического SEO

PageSpeed показывает 34/100 на мобильных. В Search Console — красные метрики по всем страницам категорий. Конкурент с сайтом на 3 года старше стоит выше в выдаче, несмотря на более слабые тексты. Техническая производительность стала прямым ранжирующим фактором — и разрыв между «приемлемо» и «быстро» стоит позиций. Мы решали эту проблему для десятков проектов — от интернет-магазинов до SaaS-платформ — и знаем, какие ошибки съедают ранжирование.

Core Web Vitals: что реально влияет на позиции

Google использует три метрики как сигналы ранжирования (Page Experience): LCP (Largest Contentful Paint), CLS (Cumulative Layout Shift), INP (Interaction to Next Paint, заменил FID с последнего крупного обновления алгоритма).

LCP: почему 8 секунд — это не проблема изображения

LCP измеряет время отрисовки самого большого видимого элемента страницы. Чаще всего — hero image или H1. Пороги: хорошо < 2.5s, плохо > 4s.

Типичный диагноз на реальном проекте: интернет-магазин одежды, LCP 7.8s на мобильных. Элемент — hero image категории, 4.2MB JPEG без srcset, загружается через CSS background-image (не <img>). Проблема здесь двойная: во-первых, браузер не может preload CSS background images через <link rel="preload"> стандартным способом. Во-вторых, 4.2MB на мобильном соединении — это физически медленно.

Решение по шагам:

1. Переносим hero из CSS background в <img> с fetchpriority="high" и loading="eager"
2. Конвертируем в WebP, добавляем srcset: 800w для мобильных, 1400w для десктопа
3. <link rel="preload" as="image" href="hero-800.webp" media="(max-width: 768px)"> в <head>
4. Убираем все render-blocking скрипты выше hero через defer

Итог: LCP 7.8s → 1.9s. Без смены хостинга, без CDN.

Если LCP — не изображение, а текстовый блок: проблема может быть в TTFB (медленный сервер), в render-blocking CSS/JS, или в web fonts с font-display: block.

CLS: смещения, которые раздражают пользователя и Google

CLS измеряет суммарный сдвиг элементов в процессе загрузки. Пороги: хорошо < 0.1, плохо > 0.25. CLS 0.35 — это баннер, который появляется через секунду и сдвигает всё содержимое страницы вниз.

Источники CLS:

• Изображения без заданных размеров. <img src="photo.jpg"> без width и height — браузер не резервирует место, контент прыгает при загрузке. Фикс: явные width/height или aspect-ratio в CSS.
• Рекламные блоки и виджеты. Google Ads, чат-виджеты, cookie consent — всё, что появляется после основного контента. Решение: резервировать место через min-height или загружать до рендера основного контента.
• Web fonts. FOUT (Flash of Unstyled Text) и FOIT (Flash of Invisible Text) могут вызывать переформатирование. font-display: swap с size-adjust (CSS свойство для выравнивания размеров fallback шрифта) минимизирует CLS.
• Динамический контент. Если блок появляется после загрузки (fetch данных, lazy load) — добавляем skeleton placeholder с нужными размерами.

INP: почему интерфейс «зависает» на 500ms

INP измеряет задержку ответа на любое взаимодействие пользователя: клик, тап, ввод. Пороги: хорошо < 200ms, плохо > 500ms. INP 680ms — это когда пользователь нажимает кнопку фильтра, а ничего не происходит полсекунды.

Главная причина высокого INP — заблокированный main thread. JavaScript-бандл 2.1MB парсируется и выполняется синхронно. Пока выполняется, пользовательские события не обрабатываются.

Диагностика через Chrome DevTools → Performance → взаимодействие с подозрительной задержкой → найти Long Tasks (> 50ms). Типичные виновники:

• Непрерывная обработка большого списка без requestIdleCallback или requestAnimationFrame
• Тяжёлые event listeners без debounce/throttle
• Синхронный setState в React, который триггерит полный ре-рендер сложного дерева компонентов
• Third-party scripts: livechat, аналитика, виджеты — они исполняются в том же main thread

Решения: code splitting через динамический import(), перенос тяжёлых вычислений в Web Workers, React.memo + useMemo для предотвращения лишних ре-рендеров, scheduler API для приоритизации задач.

Schema.org: разметка, которую читают роботы

Структурированные данные через JSON-LD — не прямой ранжирующий фактор, но дают rich snippets в выдаче (звёзды рейтингов, цены, дата публикации), что увеличивает CTR на 20–30%.

Типы разметки по сценариям:

• E-commerce: Product с offers (цена, наличие, валюта), aggregateRating (рейтинг из отзывов), brand. BreadcrumbList для навигации. ItemList для страниц категорий.
• Статьи и блог: Article или BlogPosting с author, datePublished, dateModified, image. Organization и WebSite на главной странице — помогают Google связать сайт с брендом.
• Локальный бизнес: LocalBusiness с address, telephone, openingHours, geo. Критично для локального SEO.
• FAQ: FAQPage с mainEntity — вопросы и ответы могут появляться прямо в выдаче как раскрывающийся блок.

Валидация: Google Rich Results Test и Schema Markup Validator. Частая ошибка — указать price без priceCurrency, или ratingValue без reviewCount. Google игнорирует неполную разметку.

Как проводить технический SEO-аудит

Сканируемость. robots.txt блокирует нужные страницы (или наоборот, не блокирует служебные). Canonical URLs настроены неправильно — дублируются страницы с UTM-метками. Sitemap содержит страницы с noindex. Всё это Screaming Frog или Sitebulb покажут за час сканирования.

Core Web Vitals в масштабе. Google Search Console → Core Web Vitals → смотрим не отдельные страницы, а группы URL (шаблон страницы продукта, шаблон категории, блог). Проблема обычно системная — одна ошибка в шаблоне портит сотни страниц.

JavaScript SEO. Google рендерит JavaScript, но с задержкой (иногда дни для полного рендера). Для критичного контента — SSR или SSG обязательны. Проверяем через Search Console → Inspect URL → View Crawled Page: что видит Googlebot.

Internal linking. Орфанные страницы (нет входящих внутренних ссылок) теряют PageRank. Битые ссылки (404) — сигнал качества.

Что входит в работу

• Документация: отчёт с найденными проблемами, roadmap по приоритетам, тайминги для каждого этапа.
• Доступы: настройка мониторинга (SpeedCurve, Sentry Search Console), передача dashboard.
• Обучение: разбор типичных ошибок для вашей команды (1–2 созвона).
• Поддержка: сопровождение в течение месяца после деплоя — проверка метрик, фикс регрессий.

Свяжитесь с нами — мы оценим ваш проект за 2 дня и покажем, сколько позиций можно вернуть за счёт технического SEO. Опыт работы с проектами уровня сотен тысяч посещений в месяц — гарантируем измеримый результат в Core Web Vitals до/после. Закажите аудит в этой форме — получите персональный чек-лист из 15 пунктов.