Cara convert CommonJS ke ES Module Node.js yang paling sering gagal bukan di sintaks import, tapi di konfigurasi module. Set "type": "module" dulu di package.json atau pakai ekstensi .mjs, baru ubah require jadi import dan perbaiki __dirname yang tidak tersedia di ESM.
Kebutuhan Sebelum Convert ke ES Module
Periksa sistem module aktif sebelum menyentuh kode. Node membaca require sebagai CommonJS dan import sebagai ESM, kecuali ekstensi file berkata lain.
- Cek versi Node dengan
node -vdan pastikan mendukung ESM stabil. - Lihat field
"type"di package.json. Tanpa"type": "module", file.jsdianggap CommonJS. - Petakan pemakaian
require,module.exports,__dirname,__filename, dan import JSON. - Siapkan risiko utama: ESM mewajibkan ekstensi file seperti
./util.js, bukan./util. - Waspadai interop default export saat package CommonJS diimpor dari ESM.
Langkah Convert CommonJS ke ES Module Node Js
Kerjakan berurutan supaya error mudah dilacak.
1. Set "type": "module" di package.json, atau ganti file yang dimigrasi menjadi .mjs bila migrasi bertahap.
2. Ubah const fs = require('fs') menjadi import fs from 'fs'. Ubah module.exports = fungsi menjadi export default fungsi atau export { fungsi }.
3. Perbaiki __dirname karena ESM tidak menyediakannya. Buat ulang dari import.meta.url.
4. Jalankan aplikasi dengan node index.js, lalu perbaiki error Cannot use import statement dan require of ES Module not supported satu per satu.
// CommonJS
const path = require('path');
module.exports = path.join(__dirname, 'data.txt');
// ES Module
import path from 'path';
import { fileURLToPath } from 'url';
const __filename = fileURLToPath(import.meta.url);
const __dirname = path.dirname(__filename);
export default path.join(__dirname, 'data.txt');
Tabel Konversi Sintaks Module Node.js
| Pola CommonJS | Padanan ES Module | Catatan |
|---|---|---|
require('./a') |
import './a.js' |
Tambahkan ekstensi file |
module.exports = x |
export default x |
Import tanpa kurawal |
exports.jumlah = fn |
export const jumlah = fn |
Import memakai kurawal |
__dirname |
path.dirname(fileURLToPath(import.meta.url)) |
Perlu modul url dan path |
require('./data.json') |
import data from './data.json' with { type: 'json' } |
Gunakan import attribute |
Cek Error Setelah Migrasi Module
Cannot find module: biasanya ekstensi.jshilang pada path relatif.__dirname is not defined: ganti dengan polaimport.meta.urldi atas.does not provide an export named: nama named export salah, atau package sumber hanya punya default export.- Campur sementara dengan
createRequireuntuk memanggil package CommonJS lama. - Gunakan
await import('./modul.js')bila modul hanya perlu dimuat pada kondisi tertentu.
import { createRequire } from 'module';
const require = createRequire(import.meta.url);
const lama = require('./legacy.cjs');
FAQ
Apakah semua file harus diubah sekaligus?
Tidak. Campur .mjs dan .cjs, lalu migrasikan file daun terlebih dahulu.
Bagaimana require file ESM dari CommonJS?
Pakai dynamic import() karena require() tidak dapat memuat ESM secara sinkron.
Kenapa __dirname error setelah pindah ke import?
ESM tidak menyediakan __dirname bawaan, jadi buat ulang lewat import.meta.url dan path.dirname().