import.meta.url menyimpan URL file yang sedang berjalan, lalu fungsi fileURLToPath() mengubahnya menjadi path sistem. Pola ini menjadi cara menggunakan import.meta.url Node.js untuk menggantikan __dirname yang tidak tersedia di ES Module.
Cara Menggunakan Import Meta Url Node Js untuk Path File
Bedakan dulu sistem modulnya. CommonJS memakai require() dan otomatis menyediakan __dirname. ES Module memakai import/export dan harus membangun path sendiri dari import.meta.url.
Syaratnya file berjalan sebagai ES Module, misalnya package.json berisi "type": "module" atau ekstensi file .mjs.
Langkah pemakaiannya:
1. Impor fileURLToPath dari node:url dan path dari node:path.
2. Ubah import.meta.url menjadi path file dengan fileURLToPath(import.meta.url).
3. Ambil foldernya memakai path.dirname(namaFile).
4. Gabungkan ke file lain memakai path.join() atau path.resolve().
Kode __dirname Pengganti di ES Module
import { fileURLToPath } from 'node:url';
import path from 'node:path';
import fs from 'node:fs';
const __filename = fileURLToPath(import.meta.url);
const __dirname = path.dirname(__filename);
Contoh membaca file data.json di folder yang sama:
const target = path.join(__dirname, 'data.json');
const isi = fs.readFileSync(target, 'utf8');
console.log(isi);
Kesalahan yang sering muncul:
- Memakai
__dirnamelangsung di ES Module sehingga munculReferenceError. - Lupa mengatur
"type": "module"lalu sintaksimportgagal diproses. - Mencampur
require()danimportdalam satu file tanpa penanganan modul yang benar.
Tabel Pola Path dari Import Meta Url
| Kebutuhan | Kode | Catatan |
|---|---|---|
| Folder file aktif | path.dirname(fileURLToPath(import.meta.url)) | Pengganti __dirname |
| File asset sebelahnya | path.join(__dirname, ‘assets/logo.png’) | Aman lintas OS |
| URL file lokal | new URL(‘./config.json’, import.meta.url) | Cocok untuk fetch lokal |
FAQ
Apakah import.meta.url bisa di CommonJS?
Tidak. Properti tersebut hanya tersedia di ES Module, CommonJS tetap memakai __dirname dan __filename.
Kenapa hasil berupa file:/// bukan C:\?
Karena formatnya URL file, bukan path sistem. Ubah dulu memakai fileURLToPath() sebelum dipakai fs atau path.
Kapan pakai new URL dibanding path.join?
Gunakan new URL() untuk referensi file relatif sederhana, gunakan path.join() bila perlu normalisasi path Windows dan Linux.