Cek Sistem Modul Dulu untuk Cara Mengatasi Cannot Use Import Statement Outside Module Node Js

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 .js tanpa "type": "module" diperlakukan sebagai CommonJS. Memakai import di sana langsung memicu error.
  • Sintaks import dipakai tanpa konfigurasi ESM, misalnya project baru hasil copy tutorial tanpa mengubah package.json.
  • Kode mencampur require dan import tanpa pemisahan ekstensi. Contohnya server.js memakai require, lalu satu file memakai import.

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.

  1. Cek versi Node dan isi package.json. Jalankan node -v, lalu lihat apakah field type sudah ada.
  2. Tentukan pilihan: pindah penuh ke ESM atau tetap CommonJS. Project baru umumnya lebih mudah memakai ESM.
  3. Sesuaikan ekstensi file. Gunakan .mjs untuk ESM parsial, .cjs untuk CommonJS parsial.
  4. 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.