Error ini muncul karena Node.js menjalankan file .js sebagai CommonJS. Solusi tercepatnya cek package.json. Tambahkan "type": "module" kalau ingin memakai import, atau ubah kode ke require kalau project tetap CommonJS.
Penyebab Cannot Use Import Statement Outside Module di Node.js
Node.js tidak menebak sistem modul dari sintaks. Ia membaca ekstensi file dan field type di package.json.
- File
.jstanpa"type": "module"diperlakukan sebagai CommonJS. Memakaiimportdi sana langsung memicu error. - Sintaks
importdipakai tanpa konfigurasi ESM, misalnya project baru hasil copy tutorial tanpa mengubahpackage.json. - Kode mencampur
requiredanimporttanpa pemisahan ekstensi. Contohnyaserver.jsmemakairequire, lalu satu file memakaiimport.
Tabel Pola Error dan Arah Perbaikan
| Kondisi File | Penyebab | Solusi |
|---|---|---|
| package.json tanpa type module | .js dibaca CommonJS | Tambah type module |
| File .cjs memakai import | .cjs selalu CommonJS | Ubah ke require |
| Node versi lama | ESM belum stabil | Update Node LTS |
Cara Memperbaiki Import Statement Outside Module Langkah demi Langkah
Pilih satu jalur dulu. Jangan mencampur dua sistem modul dalam file yang sama.
- Cek versi Node dan isi
package.json. Jalankannode -v, lalu lihat apakah fieldtypesudah ada. - Tentukan pilihan: pindah penuh ke ESM atau tetap CommonJS. Project baru umumnya lebih mudah memakai ESM.
- Sesuaikan ekstensi file. Gunakan
.mjsuntuk ESM parsial,.cjsuntuk CommonJS parsial. - Jalankan ulang file dengan perintah yang sesuai, misalnya
node index.mjs.
Konfigurasi ESM minimal:
{
"name": "backend-app",
"type": "module"
}
import express from "express";
const app = express();
export default app;
Alternatif bila tetap CommonJS:
const express = require("express");
const app = express();
module.exports = app;
FAQ
Apakah cukup ganti require jadi import?
Tidak. Tanpa "type": "module" atau ekstensi .mjs, Node tetap membaca file sebagai CommonJS.
Kapan memakai .mjs dibanding type module?
Pakai .mjs bila hanya sebagian file memakai ESM, pakai type module bila seluruh project memakai ESM.
Kenapa __dirname error setelah pindah ke import?
ESM tidak menyediakan __dirname. Bangun ulang dari import.meta.url memakai path dan url.