Baca Pesan Error Dulu, Cara Mengatasi SyntaxError Node Js

Cara mengatasi SyntaxError Node.js paling cepat adalah membaca baris pertama pesan error, bukan menebak isi kode. Node.js selalu menulis nama file, nomor baris, dan jenis token yang gagal diproses. Perbaiki titik itu dulu, cek sistem module di package.json, lalu jalankan ulang dengan node –check.

Penyebab SyntaxError Paling Sering di Node.js

SyntaxError berarti kode gagal diproses sebelum dijalankan. Penyebabnya hampir selalu salah ketik atau salah sistem module.

  • Campur require dan import dalam satu proyek tanpa pengaturan type yang benar.
  • Kurung, kurawal, koma, atau tanda kutip tidak seimbang sehingga muncul Unexpected token.
  • File JSON berisi komentar atau koma terakhir, padahal JSON murni tidak mengizinkan keduanya.
  • Memakai sintaks baru di Node.js lama, misalnya optional chaining atau top-level await.
  • Import ES Module tanpa ekstensi file, contoh ./utils seharusnya ./utils.js.

Aturan dasarnya sederhana. CommonJS memakai require dan module.exports. ES Module memakai import dan export. Proyek memakai ES Module hanya jika package.json berisi “type”: “module”.

Tabel Diagnosis Cepat Berdasarkan Pesan Error

Lihat tiga baris teratas stack trace. Baris itu menunjukkan file dan posisi persis yang membuat Node.js berhenti.

Masalah Penyebab Solusi
Unexpected token Kurung, koma, atau kutip kurang Buka baris yang ditunjuk, periksa karakter sebelumnya
Cannot use import statement Proyek CommonJS dipaksa memakai import Tambah type module atau ubah ke require
Unexpected end of input Blok atau fungsi belum ditutup Cek kurawal buka dan tutup sampai akhir file

Cara Memperbaiki SyntaxError Node.js Langkah per Langkah

  1. Jalankan ulang untuk reproduksi error dan catat file serta nomor barisnya.
  2. Buka baris tersebut, lalu periksa satu baris di atasnya karena koma atau kurung sering hilang di sana.
  3. Cek sistem module. Lihat package.json apakah memakai “type”: “module”.
  4. Jika error dari JSON, validasi strukturnya dan hapus komentar serta koma terakhir.
  5. Verifikasi sintaks tanpa menjalankan program memakai perintah berikut.
node --check app.js
node --version

Pola module yang benar dan minimal:

// CommonJS
const fs = require('fs');
module.exports = { baca: () => fs.readFileSync('./data.txt', 'utf8') };
// ES Module, package.json memakai "type": "module"
import fs from 'fs';
export function baca() {
  return fs.readFileSync('./data.txt', 'utf8');
}

FAQ

Kenapa Unexpected token import muncul di Node.js?

Karena file memakai import sementara proyek berjalan sebagai CommonJS tanpa “type”: “module”.

Apakah file JSON bisa pakai komentar?

Tidak, JSON standar menolak komentar dan koma terakhir sehingga harus dihapus.

Kapan cek type module di package.json?

Setiap muncul error import, export, require, atau __dirname karena itu penanda konflik sistem module.