Dapat Path File Aktif Lewat Cara Menggunakan Import Meta Url Node Js

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 __dirname langsung di ES Module sehingga muncul ReferenceError.
  • Lupa mengatur "type": "module" lalu sintaks import gagal diproses.
  • Mencampur require() dan import dalam 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.