Tambahkan .js di setiap import relatif saat memakai ES Module. Node tidak menebak ekstensi file seperti bundler, jadi import './utils' langsung memicu ERR_MODULE_NOT_FOUND. Ubah jadi import './utils.js', pastikan package.json berisi "type": "module", lalu jalankan ulang dengan node index.js.
Kenapa Node ESM Mewajibkan Ekstensi .js
CommonJS memakai require() dengan resolusi fleksibel. Node boleh mencari ./utils, lalu mencoba ./utils.js, ./utils.json, atau ./utils/index.js secara otomatis.
ESM memakai import dengan aturan ketat. Specifier telanjang seperti express diselesaikan ke node_modules. Path relatif seperti ./utils wajib menunjuk file secara persis, termasuk ekstensinya.
import './utils'gagal karena tidak ada file harfiah bernamautils.import './utils.js'berhasil karena path cocok dengan file di disk.- Aturan ini berlaku untuk
.js,.mjs,.cjs, dan.json.
Tabel Diagnosis Error Ekstensi Import
Baca pesan error dulu sebelum mengubah kode. Cek nilai type di package.json karena itu menentukan Node memakai CommonJS atau ESM.
| Pesan Error | Penyebab | Solusi Cepat |
|---|---|---|
| Cannot find module ./helper | Import tanpa .js |
Ubah ke ./helper.js |
| Cannot find module ./utils | Import folder tanpa index | Ubah ke ./utils/index.js |
| Unknown file extension / type salah | type tidak sesuai sintaks |
Pakai type module untuk ESM |
Cara Memperbaiki Import yang Error
- Buka
package.jsondan pastikan ada"type": "module"bila semua file memakaiimport. - Tambahkan ekstensi pada semua import relatif, contoh
./db.jsdan../utils/format.js. - Samakan sisi export, gunakan
export functionatauexport default, bukanmodule.exports. - Uji ulang dari folder proyek dengan perintah
node index.js.
// Salah
import { hitung } from './utils';
// Benar
import { hitung } from './utils.js';
Pengecualian hanya untuk nama package npm. import express from 'express' tetap tanpa ekstensi. Import direktori juga wajib eksplisit, tulis ./utils/index.js, bukan ./utils.
FAQ
Apakah semua import harus pakai .js di Node ESM?
Hanya import relatif dan absolut file. Nama package tetap ditulis tanpa ekstensi.
Kenapa kode jalan di bundler tapi error di Node murni?
Bundler menambahkan resolusi otomatis, Node ESM tidak melakukannya.
Apakah mengubah type ke commonjs bisa jadi solusi?
Bisa bila proyek memakai require dan module.exports, tetapi campur sintaks dalam satu file tetap error.