Когда проект перерастает пару файлов, весь код в одном месте превращается в свалку. ES модули — это штатный способ в JavaScript разложить код по полочкам. Разберём, как они работают, зачем нужны и как не наступить на грабли при их использовании.

Digital-студия WNDER

Что такое ES модули и зачем они нужны

ES модули (ESM) — это официальный механизм модулей в JavaScript, появившийся в стандарте ES2015. Раньше разработчики выкручивались как могли: использовали CommonJS в Node.js, AMD в браузере или просто подключали кучу скриптов через теги <script>. Всё это работало, но выглядело как коммуналка с кучей соседей и одним туалетом.

ES модули дают простую идею: каждый файл — это отдельный модуль со своей областью видимости. Всё, что нужно отдать наружу, помечается словом export. Всё, что нужно взять из другого модуля, подключается через import. Всё остальное остаётся внутри и не засоряет глобальное пространство.

Главные плюсы: код проще тестировать, легче переиспользовать, а зависимости видны прямо в начале файла. Открыл файл — сразу понятно, что он тянет извне.

Как подключить модули в браузере

В браузере всё начинается с атрибута type="module" у тега script. Без него браузер не поймёт, что перед ним модуль, и просто выполнит код как обычный скрипт.

<script type="module" src="main.js"></script>

Дальше внутри main.js можно импортировать другие файлы. Например, есть модуль с утилитами:

// utils.js
export function sum(a, b) {
  return a + b;
}

export const PI = 3.14;

И главный файл, который эти утилиты использует:

// main.js
import { sum, PI } from './utils.js';

console.log(sum(2, 3)); // 5
console.log(PI); // 3.14

Обрати внимание на расширение .js в пути. В браузере его указывать обязательно. Это не Node.js, где можно опустить. Браузер не угадывает — ему нужен точный путь.

Ещё один момент: модули в браузере загружаются отложенно (deferred) по умолчанию. Это значит, что DOM уже готов к работе, когда модуль начинает выполняться. Удобно.

Экспорты и импорты: именованные и по умолчанию

В ES модулях есть два вида экспорта: именованный и по умолчанию (default). Именованный — когда экспортируешь несколько сущностей и хочешь, чтобы их можно было импортировать по именам. Default — когда модуль отдаёт что-то одно, главное.

Пример именованного экспорта мы уже видели. Вот как выглядит default:

// user.js
export default function createUser(name) {
  return { name, createdAt: Date.now() };
}

Импорт default-экспорта не требует фигурных скобок, и имя можно выбрать любое:

import createUser from './user.js';

const user = createUser('Алексей');
console.log(user.name); // Алексей

Можно смешивать: импортировать default и именованные экспорты из одного модуля.

import createUser, { ADMIN_ROLE } from './user.js';

Вот краткая таблица для сравнения:

Тип экспорта Синтаксис экспорта Синтаксис импорта Особенность
Именованный export function foo() {} import { foo } from './mod.js' Имя фиксировано
По умолчанию export default function foo() {} import foo from './mod.js' Имя можно любое
Всё сразу export * from './other.js' import * as all from './mod.js' Пространство имён
Правило: не смешивай default и именованные экспорты в одном модуле без острой необходимости. Это сбивает с толку. Если модуль — это одна сущность (класс, функция), используй default. Если набор утилит — только именованные.

ES модули в Node.js: свои нюансы

Node.js долгое время жил на CommonJS (require/module.exports). Сейчас ESM поддерживается, но нужно явно указать, что проект модульный. Самый простой способ — добавить в package.json поле "type": "module".

// package.json
{
  "name": "my-app",
  "version": "1.0.0",
  "type": "module"
}

Если этого не сделать, Node.js будет ругаться на import. Есть и другой путь: использовать расширение .mjs для модульных файлов. Но обычно хватает type: module.

Важное отличие от браузера: в Node.js можно опускать расширение файла при импорте, но лучше так не делать. Явное указание пути избавит от путаницы, особенно если проект собирается сборщиком.

// server.js
import { createServer } from 'http';
import { sum } from './utils.js';

const server = createServer((req, res) => {
  res.end(`Сумма: ${sum(2, 3)}`);
});

server.listen(3000);

Обрати внимание: встроенные модули Node.js импортируются без пути, просто по имени. Сторонние — из node_modules. Свои — по относительному пути.

Практические советы и типичные ошибки

Модули — это не просто import/export. Это дисциплина. Вот несколько советов, которые сэкономят нервы.

  • Один модуль — одна ответственность. Не пихай в файл всё подряд. Если файл разрастается до 500 строк, пора делить.
  • Избегай циклических зависимостей. Когда модуль A импортирует B, а B импортирует A, получается замкнутый круг. JavaScript это переживёт, но результат может быть непредсказуемым. Следи за графом зависимостей.
  • Не используй глобальные переменные. Смысл модулей — изолировать код. Если ты пишешь window.foo = ..., ты ломаешь изоляцию.
  • Используй сборщики. В продакшене браузеру не нужно грузить десятки мелких файлов. Webpack, Vite или Rollup соберут всё в один бандл.
  • Проверяй пути. Относительные пути в браузере и Node.js работают по-разному. Всегда указывай расширение и проверяй, откуда запускается файл.

Ещё одна частая ошибка: попытка использовать import в обычном скрипте без type="module". Браузер выдаст синтаксическую ошибку. Всегда проверяй атрибут.

И последнее: не бойся рефакторить. Модульность — это не раз и навсегда. Если видишь, что структура неудобна, меняй её. Код должен служить тебе, а не наоборот.

Что в итоге

ES модули — это стандартный и удобный способ организации кода в JavaScript. Они работают и в браузере, и в Node.js, позволяют явно управлять зависимостями и изолировать логику. Главное — не забывать про type="module", указывать расширения файлов и следить за тем, чтобы модули не превращались в свалку. Начни с малого: вынеси одну функцию в отдельный файл, подключи её через import. Дальше пойдёт как по маслу.

Студия WNDER