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 defaulttetapi diimpor denganrequire()tanpa.default. - File berisi
module.exports = fntetapi diimpor denganimport fn frompada setup interop tertentu. - Named export diimpor sebagai default, misalnya
export const configlaluimport config from. - Ekspor ganda tertimpa karena
module.exportsditulis ulang setelahexports.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
- Periksa file sumber. Pastikan hanya ada satu bentuk ekspor utama.
- Samakan sistem modul. Periksa
package.jsondan ekstensi.js,.mjs, atau.cjs. - Perbaiki sisi impor. Default dipasangkan dengan default, named dipasangkan dengan named.
- Tangani interop CommonJS ke ES Module secara eksplisit.
- 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.