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
- Jalankan ulang untuk reproduksi error dan catat file serta nomor barisnya.
- Buka baris tersebut, lalu periksa satu baris di atasnya karena koma atau kurung sering hilang di sana.
- Cek sistem module. Lihat package.json apakah memakai “type”: “module”.
- Jika error dari JSON, validasi strukturnya dan hapus komentar serta koma terakhir.
- 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.