Error Unexpected token berarti file package.json bukan JSON valid, jadi npm berhenti sebelum install. Catat angka baris di pesan npm ERR, lalu perbaiki koma, kurung, atau tanda kutip di sekitar baris itu. File valid lagi, perintah npm langsung jalan normal.
Penyebab Package Json Unexpected Token Paling Sering
npm membaca package.json dengan parser JSON yang ketat. Satu karakter salah membuat seluruh file gagal dibaca.
- Koma, kurung kurawal, atau tanda kutip tidak seimbang, misalnya koma tertinggal setelah item terakhir.
- Edit manual package.json tanpa validasi JSON, terutama saat menambah script atau dependency.
- Konflik merge Git yang tersisa di file, seperti baris HEAD, =====, atau >>>.
- Encoding atau karakter tersembunyi, misalnya file disalin dari editor dan membawa karakter tak terlihat.
Tabel Diagnosis Cepat Unexpected Token
Baca pesan error sampai akhir karena npm selalu menyebut karakter dan posisi masalahnya.
| Pesan Error | Penyebab | Solusi |
|---|---|---|
| Unexpected token , | Koma ganda atau koma sisa | Hapus koma berlebih |
| Unexpected token } | Objek belum lengkap | Lengkapi kurung dan koma |
| Unexpected token ] | Array dependencies rusak | Periksa tanda array |
Bedakan error JSON parse dengan error module. JSON parse muncul sebelum install berjalan. Error module biasanya muncul setelah install, dengan pesan Cannot find module.
Cara Memperbaiki Package Json Unexpected Token
Ikuti urutan ini agar tidak menghapus file yang sebenarnya masih bisa diperbaiki.
- Catat baris error dari terminal. Contoh pesan npm ERR! Unexpected token } in JSON at position 412 menunjukkan area rusak.
- Buka package.json dan cek sekitar baris tersebut. Periksa lima baris di atas dan bawahnya.
- Validasi dengan Node dan npm pkg get. Jalankan perintah berikut satu per satu:
node -e "JSON.parse(require('fs').readFileSync('package.json','utf8')); console.log('JSON OK')"
npm pkg get name
4. Perbaiki koma, kutip, dan kurung. Pola benar untuk objek terakhir tanpa koma seperti ini:
{
"name": "backend-api",
"version": "1.0.0",
"scripts": {
"start": "node index.js"
}
}
5. Jalankan ulang npm install setelah validasi menampilkan JSON OK. Jangan hapus node_modules dulu karena masalahnya ada di file, bukan di folder install.
FAQ
Apakah harus hapus node_modules untuk error ini?
Tidak, perbaiki isi package.json dulu lalu validasi ulang.
Perintah apa untuk cek valid tidaknya package.json?
Jalankan node -e dan npm pkg get name.
Kenapa error muncul setelah git pull?
Biasanya ada penanda konflik merge yang merusak format JSON.