Поиск
Ошибки

ReferenceError: require is not defined in ES module scope в Node.js

Файл запущен как ES-модуль, а в нём есть require, module.exports или __dirname — в ES-модулях их нет. Есть два пути: переписать эти строки или запустить файл как CommonJS.

≈ 4 мин чтения
Содержание 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 };
__dirnameimport.meta.dirname
__filenameimport.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.

Источники

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

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

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