re:re:actable
Урок 133 минуты чтения

Code splitting и динамический import()

На этой странице
Кратко

Code splitting — разделение бандла на части (чанки), которые загружаются по мере необходимости, а не все сразу. Основной механизм — динамический import(): он возвращает Promise с модулем, и сборщик (Vite, webpack) автоматически выносит этот модуль в отдельный файл. Так делят код по маршрутам, тяжелым компонентам и редким функциям, уменьшая объем JS при первой загрузке.

Вопрос

Что такое code splitting? Как работает динамический import() и как разделить код в React и Next.js?

Динамический import()

// статический импорт — модуль попадет в основной бандл
import { formatDate } from "./utils/date.js";
 
// динамический — отдельный чанк, загрузка по требованию
button.addEventListener("click", async () => {
  const { exportToPdf } = await import("./export-pdf.js");
  exportToPdf(report);
});
  • import() — выражение, а не инструкция: работает в любом месте кода, в условиях и обработчиках;
  • возвращает Promise с объектом модуля ({ default, ...named });
  • путь может быть вычисляемым, но сборщику нужна подсказка (import(\./locales/${lang}.js`)` создаст чанк на каждый файл папки);
  • работает в обычных скриптах, не только в модулях.

Стратегии разделения

СтратегияПример
По маршрутамкаждая страница — свой чанк
По компонентаммодалка, редактор, график, карта
По функциямэкспорт в PDF, парсер Excel
По условиямполифилы только для старых браузеров, локали по языку
Vendor chunksредко меняющиеся библиотеки отдельно для кеша

React

import { lazy, Suspense } from "react";
 
const Chart = lazy(() => import("./Chart"));
const Settings = lazy(() => import("./pages/Settings"));
 
function Dashboard() {
  return (
    <Suspense fallback={<Spinner />}>
      <Chart data={data} />
    </Suspense>
  );
}

React.lazy требует default-экспорт. Для именованных: lazy(() => import("./Chart").then((m) => ({ default: m.Chart }))).

Next.js

import dynamic from "next/dynamic";
 
const Map = dynamic(() => import("./Map"), {
  ssr: false,                       // только на клиенте (например, Leaflet)
  loading: () => <p>Загрузка карты...</p>,
});

App Router автоматически делит код по маршрутам; Server Components вообще не попадают в клиентский бандл.

Предзагрузка

// начать загрузку заранее, например при наведении
link.addEventListener("mouseenter", () => import("./pages/Settings"), { once: true });
<link rel="modulepreload" href="/assets/settings.js">

Webpack поддерживает «магические комментарии»: import(/* webpackPrefetch: true */ "./Settings").

Что важно помнить

  • Слишком мелкие чанки ухудшают загрузку: много запросов и водопады; делите по смысловым границам.
  • Ленивая загрузка добавляет задержку при первом использовании — показывайте fallback и предзагружайте вероятные переходы.
  • Ошибка загрузки чанка (новый деплой удалил старые файлы) — обрабатывайте через Error Boundary и предлагайте перезагрузку.
  • Code splitting уменьшает стартовый JS и улучшает LCP и INP, но не заменяет удаление ненужного кода (tree shaking).

Мини-шпаргалка

  • Code splitting — делить бандл на чанки по требованию.
  • import() → Promise с модулем, отдельный чанк.
  • React: lazy + Suspense; Next.js: next/dynamic.
  • Делить по маршрутам и тяжелым компонентам.
  • Предзагрузка: import() по наведению, modulepreload.

Документация

MDN: import(), React: lazy, Next.js: Lazy Loading, Vite: Dynamic Import.

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам