Error ERR_MODULE_NOT_FOUND? Cara Mengatasi Extension Js Wajib Import Node Js

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 bernama utils.
  • 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

  1. Buka package.json dan pastikan ada "type": "module" bila semua file memakai import.
  2. Tambahkan ekstensi pada semua import relatif, contoh ./db.js dan ../utils/format.js.
  3. Samakan sisi export, gunakan export function atau export default, bukan module.exports.
  4. 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.