__Dirname Error? Cara Mendapatkan Dirname di ES Module Node Js yang Benar

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.url sebagai sumber lokasi file aktif.
  • Ubah URL menjadi path dengan fileURLToPath() dari modul url.
  • Ambil foldernya dengan dirname() dari modul path.

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 __dirname hasil kode di atas.
  • Menuju file lain: gunakan join(__dirname, 'data', 'config.json').
  • Windows memakai backslash dan Linux memakai slash, path menanganinya 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.