Pindah dari Require ke Import Lewat Cara Convert Commonjs ke Es Module Node Js

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 -v dan pastikan mendukung ESM stabil.
  • Lihat field "type" di package.json. Tanpa "type": "module", file .js dianggap 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 .js hilang pada path relatif.
  • __dirname is not defined: ganti dengan pola import.meta.url di atas.
  • does not provide an export named: nama named export salah, atau package sumber hanya punya default export.
  • Campur sementara dengan createRequire untuk 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().