Solusi Praktis dengan Import Dinamis untuk Cara Mengatasi Require Of ES Module Node Js

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 .js dengan "type": "module" dibaca sebagai ESM, sehingga tidak bisa di-require().
  • File .mjs selalu ESM, file .cjs selalu CommonJS, tanpa melihat isi package.json.
  • Banyak package versi baru hanya merilis ESM, contohnya node-fetch v3, chalk v5, dan nanoid v4.

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

  1. Cek package.json. Jika berisi "type": "module", semua .js adalah ESM.
  2. Cek ekstensi file yang di-require. Jika .mjs atau milik package ESM-only, jangan pakai require().
  3. Ganti pemanggilan statis dengan import dinamis di file CommonJS.
  4. 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.