Cara mendapatkan dirname di ES Module Node.js yang benar adalah menggabungkan import.meta.url dengan fileURLToPath() dari modul url dan dirname() dari modul path. Pola ini menggantikan __dirname dan __filename yang tidak tersedia saat kamu memakai import.
Kenapa __dirname Hilang di ES Module
Node.js menyediakan __dirname secara otomatis hanya untuk CommonJS. Sistem ES Module memakai model URL, bukan path file, sehingga variabel tersebut tidak dibuat.
Setelah package.json memakai "type": "module" atau file berekstensi .mjs, semua kode berjalan sebagai ESM. Setiap file mendapat import.meta.url berbentuk file:/// yang perlu diubah menjadi path sistem operasi.
- Gunakan
import.meta.urlsebagai sumber lokasi file aktif. - Ubah URL menjadi path dengan
fileURLToPath()dari modulurl. - Ambil foldernya dengan
dirname()dari modulpath.
Cara Mendapatkan Dirname di ES Module Node Js
Ikuti tiga langkah berikut di file ESM, misalnya index.js:
1. Impor fungsi yang dibutuhkan dari modul bawaan Node.js.
2. Buat pengganti __filename dari import.meta.url.
3. Turunkan __dirname dari hasil tersebut.
import { fileURLToPath } from 'url';
import { dirname, join } from 'path';
const __filename = fileURLToPath(import.meta.url);
const __dirname = dirname(__filename);
console.log(__filename);
console.log(__dirname);
- Butuh folder saja: cukup pakai
__dirnamehasil kode di atas. - Menuju file lain: gunakan
join(__dirname, 'data', 'config.json'). - Windows memakai backslash dan Linux memakai slash,
pathmenanganinya otomatis.
Perbandingan __dirname CommonJS vs ESM
| Sistem Modul | Cara Ambil Path | Catatan |
|---|---|---|
| CommonJS | __dirname langsung |
Tersedia otomatis |
| ESM | dirname(fileURLToPath(import.meta.url)) |
Perlu impor modul bawaan |
| Keduanya | process.cwd() |
Folder kerja terminal, berubah-ubah |
Pakai __dirname untuk membaca file di samping kode sumber, misalnya template, sertifikat, atau upload lokal. Pakai process.cwd() hanya untuk path yang memang relatif terhadap perintah yang dijalankan, seperti argumen CLI.
Kesalahan yang sering muncul adalah memanggil document, window, atau require() di file ESM. Ketiganya tidak berlaku di konteks ini dan memicu ReferenceError.
FAQ
Bisakah __dirname dipakai langsung di ES Module?
Tidak, Node.js tidak menyediakannya di ESM sehingga kamu harus membuatnya manual dari import.meta.url.
Bagaimana mendapatkan path file aktif tanpa dirname?
Gunakan fileURLToPath(import.meta.url), hasilnya setara __filename.
Apakah metode ini butuh package tambahan?
Tidak, url dan path termasuk modul bawaan Node.js.