ReferenceError: require is not defined in ES module scope в Node.js
Файл запущен как ES-модуль, а в нём есть require, module.exports или __dirname — в ES-модулях их нет. Есть два пути: переписать эти строки или запустить файл как CommonJS.
Содержание 7
Как выглядит ошибка
file:///home/ivan/myapp/app.js:1
const express = require('express');
…
ReferenceError: require is not defined in ES module scope, you can use import instead
This file is being treated as an ES module because it has a '.js' file extension and '/home/ivan/myapp/package.json' contains "type": "module". To treat it as a CommonJS script, rename it to use the '.cjs' file extension.Вторая строка сообщения — причина: в package.json проекта стоит "type": "module", и все файлы .js считаются ES-модулями. Если этой строки нет, файл стал ES-модулем по другой причине: у него расширение .mjs, или Node.js 22 нашёл в нём import.
Так же выглядят ошибки с другими словами CommonJS:
ReferenceError: module is not defined in ES module scope
ReferenceError: exports is not defined in ES module scope
ReferenceError: __dirname is not defined in ES module scope
ReferenceError: __filename is not defined in ES module scopeСпособ 1. Заменить require на import
| Было в CommonJS | Стало в ES-модуле |
|---|---|
const express = require('express'); | import express from 'express'; |
const { readFile } = require('fs'); | import { readFile } from 'fs'; |
const utils = require('./utils'); | import utils from './utils.js'; |
module.exports = app; | export default app; |
exports.start = start; | export { start }; |
__dirname | import.meta.dirname |
__filename | import.meta.filename |
В import своих файлов расширение .js обязательно — без него будет ошибка Cannot find module.
import.meta.dirname и import.meta.filename появились в Node.js 20.11, в Node.js 18 их нет. Для Node.js 18 папку файла получают так:
import path from 'path';
import { fileURLToPath } from 'url';
const __filename = fileURLToPath(import.meta.url);
const __dirname = path.dirname(__filename);Способ 2. Оставить require через createRequire
Если строк с require много или нужно подключить файл .json, создайте функцию require в начале файла:
import { createRequire } from 'module';
const require = createRequire(import.meta.url);
const config = require('./config.json');Способ 3. Запустить файл как CommonJS
Если весь проект написан на require, а "type": "module" в package.json появился по ошибке, уберите эту строку:
cd /home/ivan/myapp
nano package.jsonЕсли ES-модулями должны остаться другие файлы, переименуйте в .cjs только этот, как советует сообщение:
mv app.js app.cjsИ поменяйте имя файла там, откуда приложение запускается: в ExecStart файла службы, в команде PM2 или в "scripts" файла package.json. Если файл подключают другие файлы, поменяйте имя и в них.
Как проверить
cd /home/ivan/myapp
node app.jsПриложение должно запуститься без строки ReferenceError. Остановите его клавишами 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/modules/esm/module_job.js — добавка in ES module scope, you can use import instead и строка про "type": "module".
- Исходный код Node.js 22.22.1: lib/internal/modules/esm/module_job.js — те же тексты, список слов require, module, exports, __filename, __dirname.
- Документация Node.js 22: ECMAScript modules — различия ES-модулей и CommonJS, createRequire, обязательные расширения, import.meta.dirname с версий 20.11 и 21.2.
Сверено 22 октября 2026 года.
Что почитать дальше
- Cannot use import statement outside a moduleобратная ошибка.
- Cannot find moduleне найден файл или пакет.
- Все ошибки Node.js и npmтаблица по тексту сообщения.