re:re:actable
Урок 051 минута чтения

Как работает динамический import?

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

Динамический import() загружает модуль во время выполнения и возвращает Promise. Он полезен для ленивой загрузки, условного импорта, загрузки ESM из CommonJS и уменьшения стартовой стоимости приложения.

Вопрос

Как работает динамический import() и когда его использовать?

Базовый пример

const module = await import('./math.js');
 
console.log(module.sum(2, 3));

В отличие от статического import, динамический можно вызвать внутри условия или функции.

async function loadFormatter(type) {
  if (type === 'html') {
    return import('./format-html.js');
  }
 
  return import('./format-text.js');
}

В CommonJS

CommonJS не может использовать статический import, но может вызвать динамический import().

async function main() {
  const { default: chalk } = await import('chalk');
  console.log(chalk.green('ok'));
}
 
main();

Это полезно, когда CJS-проекту нужно подключить ESM-only пакет.

Когда использовать?

  • редкая тяжелая зависимость;
  • условная загрузка драйвера;
  • CLI-команда с несколькими режимами;
  • совместимость CJS -> ESM;
  • плагины.

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

  • import() возвращает Promise с объектом модуля и работает и в ESM, и в CommonJS.
  • Подходит для ленивой загрузки, условных зависимостей и загрузки ESM из CommonJS.
  • Экспорт по умолчанию доступен как module.default.
  • Путь в import() с переменными затрудняет статический анализ бандлерам.

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

  • import() возвращает Promise.
  • Работает и в ESM, и в CommonJS.
  • Позволяет загружать модуль условно.
  • Может уменьшить стартовое время CLI.
  • Ошибки загрузки нужно ловить через try/catch.

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

MDN: import(), Node.js: import expressions.

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

Поиск

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