Error [ERR_REQUIRE_ESM]: require() of ES Module not supported в Node.js
Ваш код подключает пакет через require, а пакет выпущен только как ES-модуль. В Node.js 18 так нельзя. Выход — подключить пакет через import(), поставить версию пакета для CommonJS или перейти на Node.js 22.
Содержание 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.
Источники
- Исходный код Node.js 18.19.1: lib/internal/errors.js — текст ERR_REQUIRE_ESM.
- Исходный код Node.js 18.19.1: lib/internal/modules/cjs/loader.js — ошибка для файлов .js из пакета с "type": "module".
- Исходный код Node.js 22.22.1: lib/internal/errors.js — тексты ERR_REQUIRE_ESM и ERR_REQUIRE_ASYNC_MODULE.
- Документация Node.js 22: CommonJS modules — require() для ES-модулей без флага с версии 22.12, результат с полем default, ERR_REQUIRE_ASYNC_MODULE при await вне функций.
- Исходный код Node.js 22.22.1: src/node_options.h — detect_module и require_module включены по умолчанию.
- node-fetch на GitHub — третья версия только ES-модуль, для CommonJS —
npm install node-fetch@2.
Сверено 22 октября 2026 года.
Что почитать дальше
- require is not defined in ES module scopeтаблица замен require на import.
- Как установить Node.js на Ubuntuверсии из пакетов и с nodejs.org.
- Все ошибки Node.js и npmтаблица по тексту сообщения.