Lewati ke konten
FrAIFlow

Solusi

Mengapa JSON yang tampak valid gagal pada karakter pertama

Anda melihat objek JSON valid tetapi tetap mendapat kesalahan di posisi nol. Kurung kurawal pembuka mungkin bukan karakter pertama: U+FEFF yang tidak terlihat bisa berada di depannya. Simpan sumber sebelum mencoba perbaikan. Halaman masuk HTML, respons kosong, atau berkas yang didekode keliru memerlukan solusi berbeda.

Laporan Stack Overflow tahun 2017 menelusuri kegagalan Node.js serupa ke desimal 65279, yaitu U+FEFF. Pengujian peramban lokal tersimpan adalah bukti terpisah: U+FEFF sintetis yang diikuti {"ok":true} gagal, lalu berhasil diparsing setelah hanya prefiksnya dihapus. Tangkapan layar mencatat pengujian lokal itu, bukan berkas pelapor.

Perbaikan aman yang dapat Anda jalankan

Mulai dari salinan berkas, bukan satu-satunya ekspor Anda. Jika berasal dari permintaan web, periksa status HTTP dan jenis kontennya dahulu: halaman masuk yang diawali <!doctype html> memerlukan perbaikan autentikasi, bukan pembersihan JSON. Untuk berkas lokal, gunakan editor yang dapat menampilkan pengodeannya. Jangan menyimpan menimpa sumber selama penyelidikan.

Setelah berkas didekode menjadi string JavaScript bernama text, gunakan fungsi bantu kecil berikut dalam skrip impor Anda. Fungsi menerima satu penanda awal yang diketahui dan membiarkan bagian lain tetap utuh.

function parseJsonText(text) {
  if (typeof text !== "string") throw new TypeError("Expected text");
  const hadBOM = text.charCodeAt(0) === 0xFEFF;
  const cleaned = hadBOM ? text.slice(1) : text;
  return { value: JSON.parse(cleaned), removedLeadingBOM: hadBOM };
}
const sample = '\uFEFF{"ok":true,"name":"한글"}';
const result = parseJsonText(sample);
console.log(result.removedLeadingBOM); // true
console.log(result.value.ok);          // true
console.log(result.value.name);        // 한글

Pemeriksaan keberhasilan lebih dari “kesalahannya hilang”. Pastikan properti yang diharapkan tersedia dan teks non-Inggris tetap terbaca benar. Jalankan fungsi juga pada JSON biasa: seharusnya berhasil tanpa melaporkan penanda dihapus. Masukan kosong atau objek tidak valid tetap harus memunculkan kesalahan. Tampilkan kesalahan itu kepada pemanggil, bukan mengembalikan objek kosong yang bisa disangka data valid.

Jika titik kode pertama bukan U+FEFF, hentikan jalur perbaikan ini. Misalnya, berkas yang didekode dengan pengodean salah mungkin memuat karakter pengganti atau null berselang-seling. Buka ulang dengan pengodean yang dipilih pengekspor, atau minta ekspor UTF-8 baru. Menghapus karakter tidak dapat membangun kembali byte yang didekode salah.

Perbedaan byte dan karakter tersembunyi

Prefiks tersembunyi / U+FEFF  {"ok":true} / JSON.parse → ditolak
Ilustrasi buatan penulis, bukan tangkapan layar aplikasi.

TextDecoder("utf-8") biasanya menghilangkan BOM UTF-8 di awal. Pilihan ignoreBOM-nya berlawanan dengan dugaan: true memasukkan penanda dalam string hasil dekode. Contoh byte EF BB BF 7B 7D kami menjadi {} dengan perilaku default. Ini bukan deteksi pengodean otomatis.

Periksa pembuatnya

Laporan PowerShell terpisah melibatkan jalur dekode yang salah. Windows PowerShell Out-File dan pengalihan dapat menghasilkan UTF-16LE; perilaku PowerShell lebih baru berbeda. Menghapus teks non-ASCII dapat merusak nama valid tanpa memperbaiki ketidaksesuaian itu. Periksa perintah pembuat dan versinya, lalu dekode atau ekspor ulang dengan benar. Alur kerja pengguna itu tidak direproduksi dalam pengujian kami.

RFC 8259 mensyaratkan UTF-8 untuk JSON yang dipertukarkan di luar ekosistem tertutup dan melarang pembuat menambahkan BOM jaringan. Perbaiki pengekspor jika memungkinkan. Pada batas impor, uji JSON normal, prefiks yang terkonfirmasi, JSON tidak valid, dan nilai non-Inggris. Catat hanya prefiks diagnostik, bukan isi dokumen privat.

Alur BOM UTF-8 EF BB BF menjadi U+FEFF di awal teks, menyebabkan kesalahan parsing; menghapus awalan itu memungkinkan parsing.
Ilustrasi pendukung, bukan tangkapan layar aplikasi.
Hasil Chrome menunjukkan U+FEFF sebelum kurung pembuka dan JSON berhasil diparsing setelah awalan itu dihapus.
Hasil pengujian lokal tersimpan. Buka gambar untuk memeriksa bukti aslinya.
Sumber, contoh, dan bacaan lanjutan