Entry Point Node.Js Benar: Cara Mengatur Main File Package Json

Isi main dengan path relatif ke file entry yang benar-benar ada, misalnya index.js atau src/index.js. Langkah yang paling sering salah adalah mengubah struktur folder tanpa memperbarui main, sehingga require(nama-package) gagal walau kode tidak berubah.

Fungsi field main di package.json

Field main menentukan file yang dimuat Node.js saat paket diakses lewat nama paket. Contohnya require("nama-paket") akan membaca main, bukan menebak file sendiri.

Untuk proyek CommonJS, main biasanya menunjuk ke file berisi module.exports. Untuk proyek modern, kombinasi exports dan type: module mengatur perilaku import dengan lebih rinci.

main tetap berguna sebagai fallback kompatibilitas. Banyak tool lama, bundler, dan versi Node.js tertentu masih membacanya walau exports sudah ada.

Cara Mengatur Main File Package Json Langkah per Langkah

1. Periksa struktur folder dan pastikan file entry sudah ada. Pilihan umum:

  • index.js untuk proyek kecil satu file.
  • src/index.js untuk kode sumber terpisah dari hasil build.
  • dist/index.js atau lib/index.js untuk paket yang dipublish setelah build.

2. Buka package.json dan isi main dengan path relatif tanpa garis miring di depan.

{
  "name": "contoh-paket",
  "version": "1.0.0",
  "type": "commonjs",
  "main": "src/index.js"
}

3. Sesuaikan dengan sistem module. Gunakan "type": "commonjs" untuk require dan module.exports. Gunakan "type": "module" untuk import dan export.

4. Uji sebelum publish dengan require lokal dari folder lain:

node -e "console.log(require('./src/index.js'))"

Jalankan juga npm pack --dry-run untuk memastikan file entry ikut terbawa ke paket.

Kesalahan Umum dan Cara Ceknya

  • Path salah karena folder diganti, misalnya tertulis index.js padahal file pindah ke src/index.js.
  • Ekstensi hilang, misalnya menulis src/index sehingga resolver tidak menemukan file.
  • File belum dibuat atau belum masuk hasil build, terutama saat main menunjuk ke dist/.
  • Salah sistem module, misalnya file memakai import tetapi type masih CommonJS.

Masalah | Penyebab | Solusi

Tabel berikut merangkum pemeriksaan cepatnya.

Masalah Penyebab Solusi
Cannot find module Path main tidak cocok Samakan main dengan lokasi file
File tidak ikut publish Entry belum dibuild Jalankan build lalu cek npm pack
SyntaxError import/export Type module keliru Sesuaikan type dengan sintaks dipakai

FAQ

Apakah main wajib di semua proyek Node.js?

Tidak. Aplikasi biasa yang dijalankan langsung tidak membutuhkannya, tetapi library yang dipublish sebaiknya memilikinya.

Apa beda main dan exports di package.json?

main adalah entry klasik, sedangkan exports mengatur akses file paket secara lebih ketat dan modern.

Kenapa error cannot find module setelah ubah main?

Umumnya path baru salah atau file belum ada, periksa ejaannya lalu uji ulang dengan node -e.