Модули в JavaScript: ESM vs CommonJS

Что такое CommonJS

Это старая и долгое время основная модульная система в Node.js.

импорт:

const fs = require('fs')

экспорт:

module.exports = myFunction

Плюсы CommonJS:

• простая и знакомая схема для старых Node.js-проектов
• огромная совместимость с legacy-кодом
• удобно в среде, где всё уже построено вокруг require()

Минусы:

• не является нативным стандартом браузера
• хуже подходит для tree shaking
• синтаксис считается устаревающим для новых проектов

Что такое ESM

Это официальный стандарт модулей в JavaScript, который работает и в браузерах, и в Node.js.

импорт:

import fs from 'fs'

экспорт:

export default myFunction

или

export const sum = (a, b) => a + b

Плюсы ESM 🚀

• стандартный синтаксис JavaScript
• поддерживается браузерами нативно
• лучше работает с современными сборщиками: Vite, Webpack, Rollup
• позволяет эффективнее делать tree shaking и оптимизацию бандла
• удобен для масштабируемых фронтенд- и fullstack-проектов

Минусы:

• в старых Node.js-проектах может потребовать настройки
• смешивание с CommonJS иногда вызывает путаницу
• не все старые библиотеки одинаково удобно подключаются

Главные отличия ESM и CommonJS

• Синхронность: require() загружает модуль синхронно, import работает в рамках стандартной модульной системы
• Стандарт: ESM — официальный стандарт JS, CommonJS — экосистемное решение Node.js
• Совместимость: CommonJS чаще встречается в старом backend-коде, ESM — в новых проектах
• Оптимизация: ESM лучше для tree shaking и современного билд-процесса

Что выбрать 🤔

• Для новых проектов — чаще всего ESM
• Для старых Node.js-сервисов — часто CommonJS, если нет задачи миграции
• Для фронтенда — практически всегда ESM
• Для библиотек — иногда используют dual package, чтобы поддерживать оба формата

Практический вывод 💡

Если вы начинаете новый JavaScript- или Node.js-проект, ESM — предпочтительный выбор. Это современный стандарт, который лучше вписывается в текущую экосистему.
CommonJS всё ещё актуален, особенно в legacy-проектах, но постепенно уступает место ESM.

👀 Если интересна тема разработки, архитектуры и карьеры, стоит посмотреть подборку каналов про IT.

🗣 Подборки каналов
🧠 Каталог ботов и приложений
🗺 Навигация