Cara Menggunakan Alias Import Node Js agar Path Panjang Lebih Rapi

Cara menggunakan alias import Node.js adalah memetakan prefix seperti #utils/* lewat field imports di package.json, lalu mengganti ../../../utils/format.js menjadi #utils/format.js. Tanpa pemetaan ini Node.js tidak mengenali alias dan langsung melempar ERR_MODULE_NOT_FOUND.

Untuk proyek ES Module dengan "type": "module", cara bawaan ini paling aman karena tidak butuh dependency tambahan. Untuk TypeScript, pemetaan yang sama perlu ditulis di tsconfig.json.

Cara Menggunakan Alias Import Node Js Tanpa Error

Alias gagal karena banyak yang hanya mengganti teks import tanpa mendaftarkan aliasnya ke Node.js.

  • CommonJS memakai require() dan module.exports.
  • ES Module memakai import dan export, aktif penuh bila package.json berisi "type": "module".
  • Subpath imports #* didukung kedua sistem modul pada Node.js modern.
  • Contoh masalah: import { formatRupiah } from "../../../utils/format.js" sulit dibaca dan mudah rusak saat file dipindah.
  • Contoh solusi: import { formatRupiah } from "#utils/format.js" selalu menunjuk ke folder yang sama.

Kebutuhan Sebelum Membuat Alias

Periksa tiga hal ini supaya alias langsung jalan.

  • Gunakan Node.js versi 16 ke atas, idealnya versi LTS terbaru agar fitur imports stabil.
  • Pastikan struktur folder jelas, misalnya src/controllers/orderController.js dan src/utils/format.js.
  • Tentukan metode: imports #* bawaan Node.js untuk proyek JavaScript, paths di tsconfig.json untuk TypeScript, atau package alias bila proyek lama tidak bisa diubah strukturnya.

Langkah Membuat Alias Import di Node Js

1. Tambahkan field imports di package.json:

{
  "type": "module",
  "imports": {
    "#utils/*.js": "./src/utils/*.js",
    "#controllers/*.js": "./src/controllers/*.js"
  }
}

2. Ubah import relatif menjadi alias di src/controllers/orderController.js:

import { formatRupiah } from "#utils/format.js";

3. Pertahankan ekstensi .js pada ES Module. Node.js mewajibkannya, termasuk saat memakai alias.

4. Jalankan aplikasi dengan node src/app.js. Jika muncul ERR_MODULE_NOT_FOUND, periksa ejaan prefix #, ekstensi file, dan posisi path relatif terhadap package.json.

Perbandingan Cara Alias yang Sering Dipakai

Metode Fungsi Contoh
Subpath imports Alias bawaan Node.js #utils/format.js
tsconfig paths Alias khusus TypeScript @/utils/format
Package alias Kompatibilitas proyek lama module-alias

Pilih subpath imports bila proyek memakai JavaScript murni. Cara ini tanpa install tambahan, terbaca oleh require dan import, serta minim masalah saat deploy.

FAQ

Apakah alias #* bisa dipakai di require dan import?

Bisa, subpath imports berlaku untuk require("#utils/format.js") dan import ... from "#utils/format.js".

Kenapa alias tetap Cannot Find Module?

Umumnya karena pola di imports salah, ekstensi .js hilang, atau file pemanggil berada di luar cakupan package.json.

Apakah perlu install package tambahan untuk alias?

Tidak perlu untuk Node.js modern, cukup gunakan field imports bawaan.