Cara memperbaiki galat token tak terduga pada JSON

Galat Unexpected token, atau token tak terduga, muncul ketika parser membaca dokumen karakter demi karakter dan tiba pada sesuatu yang tidak sesuai aturan tata bahasa JSON di posisi tersebut. Istilah token merujuk pada unit terkecil yang bermakna, seperti tanda kurung, koma, tanda kutip, angka, atau kata kunci true, false, dan null. Ketika parser mengharapkan salah satu bentuk tertentu namun menemukan karakter lain, ia berhenti dan melaporkan token yang tidak diharapkan itu. Pesan ini sebenarnya sangat membantu, karena selalu menyertakan posisi. Alih-alih menganggap seluruh dokumen sekadar rusak, Anda mendapat petunjuk tepat di mana pembacaan gagal. Memahami bahwa galat ini menandai titik pertama ketidakcocokan membuat Anda tahu ke mana harus mulai memeriksa lebih dulu.

Ada beberapa penyebab umum galat token tak terduga. Yang paling sering adalah tanda kutip tunggal alih-alih ganda, karena JSON hanya menerima kutip ganda untuk kunci dan string. Penyebab lain adalah koma yang salah tempat, seperti koma ganda, koma di awal, atau koma akhir sebelum kurung penutup. Kurung kurawal atau kurung siku yang tidak seimbang juga memicu galat ini, misalnya lupa menutup sebuah objek. Nilai teks yang ditulis tanpa tanda kutip, misalnya sebuah kata biasa yang tidak dibungkus kutip ganda, akan dibaca sebagai token asing. Karakter tersembunyi juga bisa menjadi biang keladi, misalnya tanda petik keriting hasil salin dari editor teks, atau karakter BOM di awal berkas. Karena penyebabnya beragam, mengetahui posisi galat adalah langkah pertama yang paling menentukan.

Alat ini memudahkan pelacakan dengan menunjukkan posisi galat pertama, persis seperti JSON.parse pada mesin JavaScript. Ketika Anda memvalidasi, parser berhenti pada token tak terduga yang pertama ditemukan dan menampilkan alasan singkat beserta baris dan kolomnya. Fokuskan perhatian Anda pada karakter di posisi itu dan tepat sebelumnya, karena galat sering menunjuk ke tempat parser berhenti, bukan selalu ke karakter yang secara logis keliru. Misalnya, kutipan yang tidak ditutup di satu baris bisa membuat parser tersandung beberapa karakter kemudian. Karena alat hanya melaporkan satu galat pada satu waktu, Anda memperbaiki yang pertama, memvalidasi ulang, lalu menangani yang berikutnya bila ada. Pola bertahap ini mengubah pesan yang tadinya membingungkan menjadi daftar perbaikan yang jelas dan terurut.

Setelah menemukan posisinya, perbaikan bergantung pada jenis token yang bermasalah. Jika penyebabnya kutip tunggal, ganti menjadi kutip ganda. Jika ada koma ganda atau koma akhir, hapus koma yang berlebih. Jika sebuah nilai teks tidak memiliki tanda kutip, bungkus dengan kutip ganda. Jika kurung tidak seimbang, tambahkan pasangan penutup yang kurang atau hapus pembuka yang berlebih. Untuk karakter tersembunyi seperti tanda petik keriting atau BOM, ketik ulang bagian yang terdampak agar bersih dari karakter asing. Semua penyuntingan dan pemeriksaan ini Anda lakukan di dalam browser secara lokal, dan teks JSON tidak pernah diunggah ke server mana pun. Dengan begitu Anda bisa memperbaiki respons API atau berkas konfigurasi yang berisi informasi rahasia tanpa khawatir data Anda meninggalkan perangkat.

Perlu ditegaskan bahwa alat menandai dan menjelaskan token tak terduga, tetapi Andalah yang menerapkan perbaikannya. Validator tidak mengubah dokumen secara diam-diam, sehingga kendali penuh tetap di tangan Anda dan tidak ada penyuntingan yang terjadi tanpa persetujuan Anda. Kemampuan melacak galat parsing dengan cepat sangat berharga dalam pekerjaan nyata. Anda dapat memeriksa respons API sebelum kode Anda mengonsumsinya, sehingga bisa membedakan bug pada klien dari data yang memang cacat dari server. Anda juga bisa memvalidasi berkas konfigurasi JSON sebelum deployment agar satu karakter salah tempat tidak menggagalkan seluruh proses. Setelah dokumen bebas galat sintaks, alat masih bisa memvalidasi struktur terhadap JSON Schema bila Anda menyediakannya, memastikan payload tidak hanya terparsing tetapi juga sesuai kontrak yang Anda tetapkan.