Cara Import Module Lokal Node Js dengan Require dan Import yang Benar

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

  1. Buat file module, lalu tambahkan module.exports untuk CommonJS atau export untuk ESM.
  2. Import dari file utama memakai path relatif yang dimulai dari lokasi file pemanggil.
  3. 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.