Когда проект перерастает пару файлов, весь код в одном месте превращается в свалку. ES модули — это штатный способ в JavaScript разложить код по полочкам. Разберём, как они работают, зачем нужны и как не наступить на грабли при их использовании.
Что такое 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' |
Пространство имён |
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



