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.jsuntuk proyek kecil satu file.src/index.jsuntuk kode sumber terpisah dari hasil build.dist/index.jsataulib/index.jsuntuk 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.jspadahal file pindah kesrc/index.js. - Ekstensi hilang, misalnya menulis
src/indexsehingga resolver tidak menemukan file. - File belum dibuat atau belum masuk hasil build, terutama saat
mainmenunjuk kedist/. - Salah sistem module, misalnya file memakai
importtetapitypemasih 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.