Cek JSON Anda

Apa saja yang sebenarnya dilarang JSON

Tata bahasa JSON sengaja dibuat sangat kecil, dan hampir setiap kegagalan validasi adalah salah satu dari segelintir hal yang dipinjam orang dari JavaScript tetapi tidak pernah diadopsi JSON. Koma di akhir setelah elemen terakhir. Tanda kutip tunggal alih-alih ganda. Key tanpa tanda kutip. Komentar — JSON tidak punya, dan memang tidak pernah punya. NaN dan Infinity, yang merupakan angka JavaScript yang valid tetapi bukan JSON yang valid. Dan byte order mark di awal, tak terlihat di editor mana pun, yang ditambahkan sebagian alat Windows saat menyimpan sebagai UTF-8 dan membuat dokumen yang sebenarnya baik gagal di karakter pertamanya.

Ada dua hal yang sah tetapi tetap bisa merepotkan Anda, dan itulah sebabnya “valid” tidak sama dengan “benar”. Key duplikat tidak dilarang oleh spesifikasinya — dan setiap parser menyelesaikannya dengan cara berbeda, kebanyakan mengambil yang terakhir, jadi dokumen dengan key berulang lolos validasi di sini tetapi bermakna berbeda di bahasa pemrograman yang berbeda. Dan angka tidak punya batas presisi yang ditetapkan di JSON, sementara kebanyakan parser membacanya sebagai floating point: bilangan bulat di atas sekitar sembilan kuadriliun dibulatkan diam-diam, dan itulah sebabnya identifier besar sering dibawa sebagai string.

Yang Anda dapatkan adalah baris, kolom, dan karakter persis tempat penguraian berhenti, yang biasanya lebih berguna daripada pesan error-nya sendiri. Parser melaporkan titik di mana dokumen berhenti masuk akal, bukan tempat kesalahan dibuat — kurung kurawal penutup yang hilang dilaporkan di akhir file, dan koma yang hilang dilaporkan di token sesudahnya. Membiasakan diri melihat tepat sebelum posisi yang dilaporkan adalah kebiasaan yang paling menghemat waktu.

Tersusun dengan benar tidak sama dengan isinya benar, dan perbedaan itu penting. Alat ini memastikan bahwa sintaksnya bisa diurai. Apakah dokumen berisi field yang dibutuhkan API Anda, apakah sebuah nilai berada dalam rentang, apakah sebuah tanggal benar-benar tanggal — tidak satu pun dari itu merupakan pertanyaan JSON. Itu validasi skema, yang membutuhkan skema, dan sebuah dokumen bisa sempurna di sini namun langsung ditolak oleh layanan yang Anda kirimi.

Jika Anda butuh hal lain

Untuk memeriksa dokumen terhadap skema, bukan terhadap tata bahasa, JSON Schema adalah standarnya dan ajv adalah implementasi tercepatnya — ia akan memberi tahu bahwa sebuah field wajib tidak ada atau sebuah nilai di luar rentang, yang biasanya justru pertanyaan Anda sebenarnya. check-jsonschema menjalankan pemeriksaan yang sama dari command line dan di CI.

Untuk apa pun di command line, jq adalah alat yang wajib dimiliki: jq empty file.json memvalidasi dan tidak mencetak apa pun jika berhasil, sangat pas untuk skrip, dan jq . memformat. Untuk file yang terlalu besar untuk ditampung di memori, jq --stream dan ijson milik Python mengurai secara bertahap, hal yang tidak bisa dilakukan halaman mana pun yang memuat seluruh dokumen.