Bagaimana Cara Convert ES Module ke CommonJS Node Js agar Require Berjalan

Cara convert ES Module ke CommonJS Node.js adalah mengganti import dengan require(), mengganti export dengan module.exports, lalu memastikan package.json tidak memaksa semua file dibaca sebagai ESM. Langkah yang paling sering terlewat justru pengecekan type dan ekstensi file, karena kode sudah benar pun tetap error kalau Node.js membaca file dengan sistem modul yang salah.

Kebutuhan Sebelum Convert ke CommonJS

Periksa dulu mode modul proyek. File .js ikut pengaturan type di package.json, sedangkan .cjs selalu dibaca sebagai CommonJS dan .mjs selalu dibaca sebagai ES Module.

  • Node.js versi aktif, disarankan Node 18 ke atas agar perilaku require dan import() konsisten.
  • Akses ke package.json untuk memeriksa dan mengubah nilai type.
  • Daftar file berekstensi .js, .cjs, dan .mjs yang akan dikonversi.
  • Catatan sintaks yang wajib diubah: import, export, __dirname, __filename, dan import.meta.

Langkah Convert ES Module ke CommonJS Node Js

  1. Ubah package.json dari “type”: “module” menjadi “type”: “commonjs”, atau hapus properti tersebut bila semua file memang CommonJS.
  2. Ganti import menjadi require() dan export menjadi module.exports.
  3. Ganti __dirname versi ESM dengan bawaan CommonJS, karena CommonJS sudah menyediakannya tanpa kode tambahan.
  4. Jalankan file dengan node index.js dan perbaiki sisa error satu per satu.

Sebelum:

import path from 'path';
import { readData } from './data.js';

export function run() {
  return readData(path.join(process.cwd(), 'data.json'));
}

Sesudah:

const path = require('path');
const { readData } = require('./data.js');

function run() {
  return readData(path.join(process.cwd(), 'data.json'));
}

module.exports = { run };

Perbedaan Sintaks yang Sering Bikin Error

Sintaks ES Module CommonJS
Default export export default run module.exports = run
Named export export function run module.exports = { run }
Dynamic import await import(‘./x.js’) require(‘./x.js’)

Hati-hati saat CommonJS memanggil package ESM murni. require() tidak bisa memuat ESM, solusinya memakai dynamic import() atau mencari versi CommonJS dari package tersebut.

FAQ

Apakah type module harus dihapus dari package.json?

Ya bila seluruh proyek pindah ke CommonJS, ganti dengan “type”: “commonjs” atau hapus propertinya.

Bagaimana mengatasi __dirname is not defined setelah convert?

Error itu tanda file masih dibaca sebagai ESM, periksa kembali type dan ubah ekstensi menjadi .cjs.

Apakah dynamic import masih bisa dipakai di CommonJS?

Bisa, CommonJS mendukung await import() untuk memuat modul ESM secara dinamis.