Cara mengatasi require of ES Module Node.js paling cepat adalah berhenti memaksa require() untuk memuat package ESM dan ganti baris tersebut dengan await import(). Error ERR_REQUIRE_ESM muncul karena Node.js memblokir require() CommonJS untuk file yang dideklarasikan sebagai ES Module. Perbaikannya bukan install ulang, jadi cek dulu type di package.json dan ekstensi file sebelum mengubah kode.
Penyebab Require of ES Module Muncul di Node.js
Node.js menjalankan dua sistem modul yang berbeda. require() dan module.exports milik CommonJS, sedangkan import dan export milik ES Module. Error terjadi saat keduanya bertabrakan.
- File
.jsdengan"type": "module"dibaca sebagai ESM, sehingga tidak bisa di-require(). - File
.mjsselalu ESM, file.cjsselalu CommonJS, tanpa melihat isipackage.json. - Banyak package versi baru hanya merilis ESM, contohnya
node-fetchv3,chalkv5, dannanoidv4.
Tabel Diagnosis Cepat Require Gagal
Baca pesan ERR_REQUIRE_ESM sampai baris yang menyebut nama file atau package. Itu menentukan apakah kesalahan ada di kode sendiri atau di node_modules.
| Masalah | Penyebab | Solusi |
|---|---|---|
require() of ES Module |
Memanggil package ESM-only | Gunakan dynamic import() |
import not defined |
Pakai import di file CommonJS |
Ubah ke .mjs atau pakai import dinamis |
module.exports is not defined |
Pakai sintaks CJS di file ESM | Ganti ke export default |
__dirname is not defined |
Kode CJS dipindah ke ESM | Buat dari import.meta.url |
Cara Memperbaiki Require of ES Module yang Error
- Cek
package.json. Jika berisi"type": "module", semua.jsadalah ESM. - Cek ekstensi file yang di-require. Jika
.mjsatau milik package ESM-only, jangan pakairequire(). - Ganti pemanggilan statis dengan import dinamis di file CommonJS.
- Jika seluruh proyek sudah memakai
import, ubah proyek ke ESM sekalian agar konsisten.
async function loadChalk() {
const { default: chalk } = await import('chalk');
console.log(chalk.green('Berhasil dimuat'));
}
loadChalk().catch(console.error);
Pertahankan CommonJS dengan dynamic import() bila proyek besar dan memakai __dirname, require.resolve, atau banyak dependency CJS. Pindah penuh ke ESM hanya masuk akal untuk proyek baru atau bila semua dependency sudah mendukung ESM.
FAQ
Apakah require() bisa dipakai untuk package ESM-only?
Tidak, gunakan await import() karena Node.js menolak require() untuk package ESM-only.
Kapan harus ubah type ke module di package.json?
Ubah bila mayoritas kode memakai import/export dan dependency utama sudah mendukung ESM.
Bagaimana memakai import dinamis di file CommonJS?
Bungkus dalam fungsi async, lalu panggil await import('nama-package') dan ambil properti default bila perlu.