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()danmodule.exports. - ES Module memakai
importdanexport, aktif penuh bilapackage.jsonberisi"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
importsstabil. - Pastikan struktur folder jelas, misalnya
src/controllers/orderController.jsdansrc/utils/format.js. - Tentukan metode:
imports #*bawaan Node.js untuk proyek JavaScript,pathsditsconfig.jsonuntuk 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.