Cara Mengatasi Default Export Undefined Node Js tanpa Bongkar Semua File

Perbaikan tercepat untuk default export undefined adalah menyamakan sistem modul antara file sumber dan file pengimpor. Jika file memakai export default, impor dengan import. Jika file memakai module.exports lalu di-require, akses lewat .default hanya saat hasil interop terbungkus objek.

Penyebab Default Export Jadi Undefined di Node.js

Node.js menjalankan dua sistem modul berbeda. CommonJS memakai require dan module.exports. ES Module memakai import dan export. Mencampur keduanya tanpa penyesuaian membuat nilai impor terbaca undefined.

Pengaturan "type": "module" di package.json menentukan cara Node membaca file .js. Tanpa pengaturan itu, Node menganggap .js sebagai CommonJS. File .mjs selalu dibaca sebagai ES Module, sedangkan .cjs selalu CommonJS.

  • File berisi export default tetapi diimpor dengan require() tanpa .default.
  • File berisi module.exports = fn tetapi diimpor dengan import fn from pada setup interop tertentu.
  • Named export diimpor sebagai default, misalnya export const config lalu import config from.
  • Ekspor ganda tertimpa karena module.exports ditulis ulang setelah exports.default.
  • Impor circular membuat modul belum selesai dievaluasi saat dipakai.

Tabel Diagnosis Cepat Undefined

Cetak dulu bentuk impornya dengan console.log(modul). Jika hasilnya { default: [Function] }, masalahnya interop. Jika hasilnya {}, kemungkinan nama ekspor salah atau file salah terbaca.

Masalah Penyebab Solusi
import x undefined Sumber hanya punya named export Ubah ke import { x }
require(x).default undefined Sumber CommonJS biasa Gunakan langsung require(x)
require(x) berisi .default Memanggil ES Module dari CommonJS Akses require(x).default
Semua impor undefined type dan ekstensi tidak cocok Samakan package.json dan ekstensi
Kadang undefined Impor circular Pindah impor ke dalam fungsi

Cara Memperbaiki Default Export Undefined

  1. Periksa file sumber. Pastikan hanya ada satu bentuk ekspor utama.
  2. Samakan sistem modul. Periksa package.json dan ekstensi .js, .mjs, atau .cjs.
  3. Perbaiki sisi impor. Default dipasangkan dengan default, named dipasangkan dengan named.
  4. Tangani interop CommonJS ke ES Module secara eksplisit.
  5. Uji ulang dengan mencetak hasil impor sebelum dipakai.
// util.mjs
export default function hitungTotal(items) {
  return items.reduce((a, b) => a + b, 0);
}

// app.mjs
import hitungTotal from './util.mjs';
console.log(hitungTotal([2, 3]));
// CommonJS memanggil ES Module hasil transpile
const modul = require('./util.js');
const hitungTotal = modul.default || modul;
console.log(hitungTotal([2, 3]));
// Konversi aman dari module.exports
// lama: module.exports = hitungTotal
// baru:
function hitungTotal(items) {
  return items.reduce((a, b) => a + b, 0);
}
module.exports = hitungTotal;

FAQ

Kenapa import default undefined padahal file ada?

File ditemukan, tetapi nama ekspor tidak cocok karena sumber hanya menyediakan named export.

Kapan harus pakai .default setelah require?

Pakai .default hanya bila console.log menunjukkan hasil require terbungkus objek { default: ... }.

Apakah harus ubah semua ke ES Module?

Tidak. Cukup konsisten per batas modul dan perbaiki lapisan interopnya saja.