Поиск
Ошибки

Error [ERR_REQUIRE_ESM]: require() of ES Module not supported в Node.js

Ваш код подключает пакет через require, а пакет выпущен только как ES-модуль. В Node.js 18 так нельзя. Выход — подключить пакет через import(), поставить версию пакета для CommonJS или перейти на Node.js 22.

≈ 4 мин чтения
Содержание 9

Как выглядит ошибка

Пример — пакет node-fetch третьей версии, который подключают строкой const fetch = require('node-fetch');:

…
Error [ERR_REQUIRE_ESM]: require() of ES Module /home/ivan/myapp/node_modules/node-fetch/src/index.js from /home/ivan/myapp/app.js not supported.
Instead change the require of index.js in /home/ivan/myapp/app.js to a dynamic import() which is available in all CommonJS modules.

Первый путь в сообщении — файл пакета, второй — ваш файл, где стоит require. Если require стоит в файле самого проекта, а "type": "module" записан в package.json проекта, сообщение длиннее: Node.js предлагает переименовать файл в .cjs. Тогда смотрите ошибку require is not defined.

Почему так

В package.json пакета стоит "type": "module" — все его файлы .js написаны как ES-модули. Node.js 18 не умеет загружать ES-модуль через require. Узнать версию:

node -v

В Node.js 22.12 и новее require загружает ES-модули сам, и ошибки ERR_REQUIRE_ESM там не будет. Только require вернёт объект модуля: то, что пакет отдаёт по умолчанию, лежит в его поле default — require('node-fetch').default. Исключение — модули с await вне функций: для них Node.js 22 пишет другую ошибку, ERR_REQUIRE_ASYNC_MODULE, и решение то же — способ 1.

Способ 1. Подключить через import()

Функция import() работает и в CommonJS, но возвращает результат не сразу, поэтому её вызывают в функции с async. Было:

const fetch = require('node-fetch');

Стало:

async function main() {
  const { default: fetch } = await import('node-fetch');
  const res = await fetch('https://example.ru/');
  console.log(res.status);
}

main();

Запись { default: fetch } берёт то, что пакет отдаёт по умолчанию. Если пакет отдаёт функции по именам, пишите их: const { имя } = await import('пакет').

Способ 2. Поставить версию пакета для CommonJS

Откройте страницу пакета на npmjs.com или GitHub и найдите в описании, какая версия работает с require. У node-fetch там сказано: третья версия — только ES-модуль, а для require нужна вторая:

npm install node-fetch@2

Число после @ — первое число версии. У другого пакета номер будет свой.

Способ 3. Перевести проект на ES-модули

Добавьте "type": "module" в package.json проекта и замените require на import — таблица замен. Тогда пакет подключается строкой import fetch from 'node-fetch';.

Способ 4. Перейти на Node.js 22

Если приложение подходит для Node.js 22, установите эту версию — как поставить версию новее. В пакетах Ubuntu 26.04 уже Node.js 22.

Как проверить

cd /home/ivan/myapp
node app.js

Приложение должно запуститься без строки ERR_REQUIRE_ESM. Остановите его клавишами Ctrl+C. Если приложение работает службой, перезапустите её:

sudo systemctl restart myapp
sudo journalctl -u myapp -n 50

Если приложение запущено как служба systemd, имя службы в примерах — myapp, папка — /home/ivan/myapp. Подставьте свои.

Тексты ошибок сверены с исходным кодом Node.js 18.19.1 — он ставится из пакетов Ubuntu 24.04 — и Node.js 22.22.1 из пакетов Ubuntu 26.04.

Источники

Сверено 22 октября 2026 года.

Где проверить исправление. Если ошибка случилась на рабочем сайте, исправление спокойнее сначала проверить на отдельном тестовом VPS с Ubuntu, например в Timeweb Cloud Реклама. АО «ТАЙМВЭБ», ИНН 7810353960. erid: CQH36pWzJpoBWKF332yG5h2XQ4cVubfBmkvqAitFqcpzWs. Как зайти на него после заказа — в статье Как подключиться к VPS по SSH.

Что почитать дальше