Perbaiki Extra data dengan mengenali JSON Lines
Ketika parser menerima objek pertama lalu gagal pada yang berikutnya, periksa format wadah sebelum mengedit data. Satu dokumen JSON memiliki satu nilai tingkat atas. JSON Lines menyimpan satu nilai JSON lengkap per baris. Dua objek valid bersama belum tentu merupakan satu dokumen valid.
Konversi JSONL ke CSV yang dilaporkan gagal pada baris kedua. Dalam diskusi publik lain, skrip menulis objek terserialisasi secara berdempetan; pelapor mengonfirmasi bahwa menambahkan baris baru setelah setiap objek memperbaiki keluaran berorientasi baris yang dimaksud. Laporan ini tidak berarti setiap kesalahan Extra data adalah JSON Lines.
Pilih pembaca yang sesuai dengan berkas
Buka salinan di editor teks dan lihat beberapa rekaman pertama. Jika setiap objek lengkap berada pada baris fisiknya sendiri, mungkin formatnya JSON Lines. Jika satu objek melintasi beberapa baris, resep ini bukan pembaca yang tepat. Jika objek disambung tanpa pemisah, perbaiki penulisnya atau gunakan parser yang dirancang untuk aliran itu; memisahkan pada kurung kurawal penutup akan merusak objek bersarang dan teks bertanda kutip.
Untuk berkas JSON Lines kecil, fungsi bantu JavaScript ini mempertahankan nomor baris saat parsing gagal. Fungsi mengizinkan satu baris baru terakhir tetapi tidak diam-diam membuang rekaman kosong.
function readJsonLines(text) {
if (text === "") return [];
const lines = text.split(/\r?\n/);
if (lines.at(-1) === "") lines.pop();
return lines.map((line, i) => {
if (!line.trim()) throw new Error(`Blank record on line ${i + 1}`);
try { return JSON.parse(line); }
catch { throw new Error(`Invalid JSON on line ${i + 1}`); }
});
}
const source = '{"id":"001"}\n{"id":"002"}\n';
const records = readJsonLines(source);
console.log(records.length); // 2
const ordinaryJson = JSON.stringify(records, null, 2);
const jsonLines = records.map(item => JSON.stringify(item)).join("\n") + "\n";Pilih ordinaryJson ketika program penerima mengharapkan satu dokumen larik. Pilih jsonLines ketika mengharapkan satu rekaman per baris. Jangan menambahkan koma di antara rekaman yang kedua. Untuk kumpulan rekaman kosong, tulis berkas JSON Lines kosong, bukan satu baris baru yang dihasilkan ekspresi contoh terakhir.
Bandingkan jumlah rekaman hasil parsing dengan jumlah sumber yang diharapkan dan periksa ID pertama serta terakhir. Jika sebuah baris gagal, periksa baris itu pada salinan asli. Melewatkannya bisa membuat konversi “selesai” sambil diam-diam membuang pesanan atau peristiwa log. Melaporkan nomor baris lebih aman daripada mencatat seluruh rekaman jika mengandung informasi privat.
Ketika berkas terlalu besar untuk dimuat dengan nyaman di memori, ganti fungsi bantu berkas kecil ini dengan pembaca baris streaming. Pertahankan pemeriksaan kesalahan dan jumlah rekaman yang sama. JSON Lines menyelesaikan batas rekaman; bukan otomatis meratakan nilai bersarang menjadi kolom CSV.
Batas rekaman adalah bagian format
Fungsi menerima akhir baris LF dan CRLF, bukan CR tunggal. Ekstensi .json saja tidak memastikan format rekaman. Jika tujuan Anda CSV, tentukan pemetaan bidang hilang dan bersarang ke kolom, lalu gunakan penulis CSV untuk menangani koma, tanda kutip, dan baris baru di dalam bidang.
Contoh uji Node v24.19.0 kami memakai {"id":"001"} dan {"id":"002"} pada baris terpisah. Parsing seluruh masukan gagal pada objek kedua; parsing kedua baris menghasilkan dua rekaman, dan JSON.stringify(records) menghasilkan dokumen larik valid. Kata-kata kesalahan dan posisinya berbeda menurut runtime.
Tulis keluaran dengan format yang disengaja
Dokumentasi Python memperingatkan bahwa panggilan dump berulang tidak membuat satu dokumen JSON valid: JSON bukan protokol berbingkai. Ekstensi .json saja tidak menjelaskan apakah berkas berisi satu dokumen atau beberapa rekaman terpisah. Pastikan format yang diharapkan dengan alat pembacanya.
