Error __filename is not defined muncul karena kamu menjalankan kode CommonJS di project ES Module. Perbaikan tercepatnya bukan mengganti Node.js, melainkan membuat ulang __filename dari import.meta.url memakai fileURLToPath. Cara ini gagal terus biasanya karena package.json sudah berisi “type”: “module” tetapi kode masih memakai __filename langsung.
Penyebab __filename Error di Node.js
Node.js memakai dua sistem modul yang berbeda. __filename dan __dirname hanya disuntik otomatis oleh CommonJS. ES Module tidak menyediakannya.
Nilai “type”: “module” di package.json mengubah semua file .js menjadi ES Module. File .mjs juga selalu diperlakukan sebagai ES Module walaupun tanpa pengaturan tersebut.
- Project memakai import dan export, bukan require.
- Terdapat “type”: “module” di package.json.
- Ekstensi file yang error adalah .mjs atau .js di project module.
Diagnosis Cepat Berdasarkan Sistem Modul
Lihat pesan error dan baris yang ditunjuk stack trace. Jika baris itu berisi __filename atau __dirname bersama import, penyebabnya hampir pasti perbedaan sistem modul.
| Masalah | Penyebab | Solusi |
|---|---|---|
| __filename is not defined | File berjalan sebagai ES Module | Buat dari import.meta.url |
| __dirname is not defined | Tidak ada variabel CommonJS | Turunkan dari path.dirname |
| require is not defined | Kode CommonJS di ES Module | Gunakan import atau createRequire |
- Jalankan cat package.json untuk memeriksa kolom type.
- Jalankan node -v untuk memastikan Node.js mendukung ES Module modern.
- Periksa ekstensi file dan stack trace sebelum mengubah kode.
Cara Memperbaiki __filename Is Not Defined
Untuk project ES Module, tambahkan konstruksi manual di bagian atas file yang membutuhkan path.
- Import fileURLToPath dari url dan dirname dari path.
- Ubah import.meta.url menjadi path file dengan fileURLToPath.
- Ambil foldernya memakai dirname bila kamu butuh pengganti __dirname.
- Gunakan variabel tersebut untuk membaca file atau membangun path.
import { fileURLToPath } from 'url';
import { dirname, join } from 'path';
const __filename = fileURLToPath(import.meta.url);
const __dirname = dirname(__filename);
const configPath = join(__dirname, 'config.json');
Alternatifnya, tetap pakai CommonJS bila project masih memakai require dan module.exports. Hapus “type”: “module” atau ubah file terkait menjadi .cjs. Jangan mencampur require dan import dalam satu file tanpa kebutuhan jelas.
FAQ
Apakah __filename bisa dipakai bersama import?
Tidak bisa langsung. Kamu harus membuatnya manual dari import.meta.url.
Apa pengganti __dirname di ES Module?
Gunakan dirname(fileURLToPath(import.meta.url)) dari modul url dan path.