Cara import module lokal Node.js yang benar tergantung sistem module yang dipakai proyek. Proyek CommonJS memakai require(‘./file’) dan module.exports, sedangkan proyek ES Module memakai import … from ‘./file.js’ dan export. Kesalahan paling umum adalah lupa menulis ./ untuk file lokal sehingga Node menganggapnya package dari node_modules.
Jawabannya Tergantung Sistem Module yang Dipakai
Node.js tidak bisa menebak sintaks import dari isi file saja. Node membaca kolom type di package.json lebih dulu.
- CommonJS, default Node.js: pakai require() dan module.exports.
- ES Module, aktif bila “type”: “module”: pakai import dan export.
- File lokal selalu memakai path relatif seperti ./helper atau ../config.
Kebutuhan Sebelum Import File Lokal
Siapkan struktur sederhana agar path mudah dilacak, misalnya seperti ini:
- app.js sebagai file utama yang menjalankan import.
- utils/helper.js sebagai module berisi fungsi bantuan.
- config.js sebagai module berisi konfigurasi.
File sumber harus mengekspor sesuatu dulu. Tidak ada package tambahan yang perlu diinstal karena ini fitur bawaan Node.js.
Langkah Import Module Lokal Node Js
- Buat file module, lalu tambahkan module.exports untuk CommonJS atau export untuk ESM.
- Import dari file utama memakai path relatif yang dimulai dari lokasi file pemanggil.
- Jalankan program dengan perintah node app.js, lalu periksa output di terminal.
// utils/helper.js - CommonJS
function sapa(nama) {
return `Halo, ${nama}`;
}
module.exports = { sapa };
// app.js - CommonJS
const { sapa } = require('./utils/helper');
console.log(sapa('Budi'));
// utils/helper.js - ES Module
export function sapa(nama) {
return `Halo, ${nama}`;
}
// app.js - ES Module
import { sapa } from './utils/helper.js';
console.log(sapa('Budi'));
Perbedaan Path dan Extension yang Sering Salah
CommonJS boleh menulis require(‘./helper’) tanpa extension karena Node otomatis mencoba .js, .json, dan .node. ESM tidak melakukan itu, jadi extension .js wajib ditulis.
| Masalah | Penyebab | Solusi |
|---|---|---|
| cannot find module | Path tanpa ./ | Ubah menjadi ./nama-file |
| named export salah | Nama import beda | Samakan nama export dan import |
| __dirname undefined | Kode jalan di ESM | Buat dari import.meta.url dan path |
FAQ
Kenapa require file lokal error cannot find module?
Node menganggap nama polos sebagai package. Tambahkan ./ atau ../ sesuai posisi file.
Apakah import lokal ESM wajib pakai .js?
Ya, path ESM harus lengkap termasuk extension, contohnya ./utils/helper.js.
Bisakah campur require dan import dalam satu proyek?
Bisa dengan dynamic import() dari CommonJS, tetapi lebih aman konsisten memakai satu sistem module.