Agar Kode Rapi, Terapkan Cara Memisahkan Module Node Js Ini

Cara memisahkan module Node.js yang rapi adalah membuat satu file untuk satu tanggung jawab, lalu menghubungkannya lewat require atau import. Kesalahan yang paling sering terjadi bukan pada sintaks export, melainkan mencampur CommonJS dan ES Module dalam satu proyek tanpa mengecek field type di package.json.

Pisahkan Kode Node.js per Fungsi Sejak Awal

Untuk proyek kecil, struktur ini sudah cukup menjaga kode tetap terbaca.

  • routes/ untuk endpoint Express
  • services/ untuk logika bisnis seperti userService.js
  • utils/ untuk helper kecil seperti format tanggal
  • db.js untuk koneksi database dan app.js sebagai entry point

Jika type tidak diisi, Node.js memakai CommonJS. Jika type berisi module, Node.js memakai ES Module.

Kebutuhan Memisahkan Module Node.js

  • Gunakan satu sistem modul yang konsisten dalam satu proyek.
  • Pisahkan batas modul: konfigurasi, logika bisnis, helper, dan entry point app.js.
  • Siapkan package.json dan tentukan type commonjs atau module sebelum menulis import.
  • Simpan koneksi database, token, dan URL memakai environment variable, bukan nilai hardcode.

Langkah Memisahkan Module Node.js

  1. Buat file modul baru, misalnya math.js, userService.js, atau db.js.
  2. Pindahkan fungsi atau object ke file tersebut, lalu export.
  3. Import kembali di file utama memakai require atau import.
  4. Uji dengan node app.js dan perbaiki path relatif ./ atau ../.
// math.js CommonJS
function tambah(a, b) {
  return a + b;
}
module.exports = { tambah };

// app.js CommonJS
const { tambah } = require('./math');
console.log(tambah(2, 3));
// math.js ES Module
export function tambah(a, b) {
  return a + b;
}

// app.js ES Module
import { tambah } from './math.js';
console.log(tambah(2, 3));
  • Gunakan huruf kecil camelCase untuk nama file, misalnya userService.js.
  • Simpan route di routes, query database di services atau models, helper di utils.
  • Biarkan app.js tipis, hanya inisialisasi dan pemanggilan modul.

Tabel Perbandingan CommonJS dan ES Module

Sistem Modul Cara Export Import Catatan
CommonJS module.exports dan require Mendukung __dirname langsung
ES Module export dan import Gunakan import.meta.url pengganti __dirname

Pada ES Module, __dirname tidak tersedia. Bangun path memakai new URL dengan import.meta.url dan modul path. Hindari circular require antar dua file yang saling memanggil, karena salah satu hasil import bisa terbaca undefined.

FAQ

Kapan file Node.js perlu dipecah jadi modul baru?

Saat satu file menangani lebih dari satu tanggung jawab, misalnya route sekaligus query database.

Kenapa import gagal setelah file dipisah?

Periksa sistem modul di package.json, path relatif, dan ekstensi .js pada ES Module.

Apakah boleh campur require dan import?

Hindari, samakan dulu type module di package.json agar perilaku loader konsisten.