Validator sintaks JSON

1. 1Tempel atau unggah JSONTempel JSON Anda ke editor, atau seret berkas .json, .jsonc, .json5, .ndjson, .geojson, atau .webmanifest ke area unggah. JSON yang diperkecil maupun yang diformat sama-sama bisa, dan tidak ada yang diunggah ke mana pun.
2. 2Tekan ValidasiSetiap error sintaks muncul sekaligus dengan baris, kolom, dan offset byte-nya, serta penanda tepat di karakter yang bermasalah. JSON yang valid justru menampilkan tipe akar, ukuran, dan strukturnya.
3. 3Baca juga peringatannyaKunci ganda dan angka yang kehilangan presisi adalah JSON yang sah dan diterima diam-diam oleh semua parser. Keduanya muncul sebagai peringatan dengan JSON Pointer, karena itulah jenis kesalahan yang lolos sampai ke produksi.
4. 4Perbaiki sendiri, atau biarkan alat ini memperbaikinyaKlik salah satu temuan untuk memindahkan kursor ke sana. Jika teksnya JSON5, JSONC, atau dictionary Python alih-alih JSON rusak, alat ini akan mengatakannya dan menawarkan salinan yang sudah diperbaiki untuk diterapkan atau diunduh.

Periksa keabsahan JSON dalam hitungan detik, dengan lokasi error yang tepat, keterangan parser, dan ringkasan struktur untuk debug cepat. Tempel atau unggah JSON lalu tekan Validasi untuk mendapat hasil lolos atau gagal seketika. Saat valid, Anda melihat tipe akar, ukurannya, dan laporan struktur lengkap. Saat tidak, Anda melihat semua error sekaligus — masing-masing dengan baris, kolom, offset byte, dan penanda tepat di karakternya — ditambah peringatan yang tidak ditunjukkan validator lain: kunci ganda dan angka yang diam-diam berubah nilai saat diurai. Semuanya berjalan di perangkat Anda, bukan di server kami — aman untuk payload privat, token, dan skema internal.

• Semua error sekaligus — Parser berhenti di kesalahan pertama. Yang ini menyelaraskan diri kembali dan lanjut, jadi berkas dengan empat puluh kesalahan cukup satu lintasan, bukan empat puluh.
• Lokasi yang sama di mana pun — Baris, kolom, offset byte, dan penanda, dihitung dari byte alih-alih dikorek dari pesan peramban — identik di Chrome, Firefox, dan Safari.
• Kesalahan yang lolos di tempat lain — Kunci ganda dan angka yang kehilangan presisi adalah JSON yang sah. Keduanya juga cara data menghilang tanpa suara, jadi dilaporkan sebagai peringatan.
• Skema, dialek, dan perbaikan — Periksa terhadap JSON Schema, ketahui bahwa berkas Anda sebenarnya JSON5, dan bawa salinan yang sudah diperbaiki dengan sekali tekan.
• Tempel atau unggah — Tempel dari papan klip, seret berkas, atau telusuri. Atur ulang membersihkan masukan dan hasil sekaligus.

Hal paling berguna yang bisa disampaikan sebuah validator adalah di mana harus melihat, dan justru itulah yang paling tidak andal pada kebanyakan validator online. Mereka meneruskan apa kata parser bawaan peramban, dan pesan itu tidak sama di semua peramban.

Diukur pada tiga mesin nyata: parser Safari melaporkan «JSON Parse error: Expected '}'», tanpa posisi, tanpa baris, tanpa kolom. Firefox menyebut baris dan kolom tetapi tanpa offset karakter. Hanya Chrome menyebut ketiganya. Validator yang membaca pesan-pesan itu dengan pola karenanya hanya bekerja benar di satu dari tiga peramban, dan menurun diam-diam di sisanya.

• Baris dan kolom — Dihitung dalam karakter, bukan byte, agar baris yang diawali kata beraksen tidak melaporkan kolom yang berbeda dari editor Anda.
• Offset byte — Yang Anda butuhkan saat berkas ditangani skrip, bukan editor.
• Penanda di bawah kesalahan — Baris yang bermasalah, dengan karakter tepatnya ditandai. Pada baris panjang, cuplikannya dipotong di sekitar kesalahan, bukan di awal.
• JSON Pointer — Di mana kesalahannya berada dalam struktur dokumen — /users/3/email — bukan hanya di dalam teks.

Parser JSON dibuat untuk menghasilkan nilai, jadi begitu bertemu sesuatu yang tak bisa dipakai ia melempar pengecualian dan berhenti. Itu benar untuk parser dan tidak membantu untuk validator: perbaiki koma yang hilang di baris 12, jalankan lagi, temukan kunci tanpa kutip di baris 40, jalankan lagi.

Validator ini tidak sedang membangun nilai, jadi tidak ada yang perlu ditinggalkan. Saat bertemu token yang tidak cocok di mana pun, ia mencatat kesalahannya lalu menyelaraskan diri — memperlakukan koma yang hilang seolah ada, menutup wadah yang bertemu kurung yang salah — dan terus sampai akhir berkas. Hasilnya adalah daftar lengkap dalam satu lintasan. Pencatatan berhenti di seribu temuan, jauh melewati titik di mana berkas layak diperbaiki manual alih-alih dibuat ulang.

• Pemisah yang hilang — Koma atau titik dua yang hilang diperlakukan sebagai salah ketik dan pemindaian berlanjut, alih-alih merambat menjadi error di setiap anggota berikutnya.
• Kurung tidak berpasangan — Kurung penutup yang tidak cocok dengan pembukanya tetap menutup wadahnya, agar satu kekeliruan tidak mengubah sisa berkas menjadi derau.
• String tak tertutup — String yang kehilangan tanda kutip berhenti di akhir barisnya, bukan menelan sisa dokumen.

JSON mengizinkan kunci yang sama dua kali dalam satu objek. Spesifikasinya menahan diri untuk menyatakan apa yang seharusnya terjadi, dan jawaban praktisnya adalah semua parser arus utama menyimpan kemunculan terakhir dan membuang yang pertama tanpa sepatah kata.

Jadi berkas konfigurasi dengan satu kunci diatur dua kali tetap sah, dan separuhnya tidak melakukan apa pun. Respons API hasil penggabungan dengan field berulang tetap sah, dan satu dari dua nilainya hilang. Karena sah, hal ini tetap peringatan dan bukan kegagalan — putusannya harus sejalan dengan parser yang benar-benar akan memakai berkas itu — tetapi dilaporkan dengan JSON Pointer ke setiap kemunculan dan offset kemunculan pertama, agar Anda bisa melihat keduanya.

• Tepat, bukan kira-kira — Kunci dibandingkan berdasarkan nilai hasil dekodenya, sehingga kunci yang ditulis "a" dan kunci sama yang ditulis dengan escape dikenali benar sebagai kunci yang sama.
• Per objek, bukan per dokumen — Kunci yang sama pada dua objek bersaudara adalah normal dan tidak dilaporkan. Hanya pengulangan di dalam satu objek yang dilaporkan.
• Di kedalaman mana pun — Duplikat dua puluh tingkat di bawah tetap ditemukan, lengkap dengan pointer yang menuju ke sana.

JSON tidak membatasi ukuran maupun presisi sebuah angka, dan hampir semua parser membacanya sebagai bilangan pecahan 64 bit. Di atas 9.007.199.254.740.991 sebuah bilangan bulat tidak lagi dapat diwakili persis, jadi ia dibulatkan — diam-diam, tanpa error dan tanpa peringatan di titik mana pun.

Ini bukan masalah teoretis. ID Snowflake, pengenal gaya Twitter, nomor pesanan, dan nilai pembukuan semuanya berada di rentang itu, dan gejalanya adalah catatan yang tidak ditemukan karena ID-nya kembali meleset beberapa ratus. Validator memeriksa setiap literal angka yang mungkin terpengaruh dan melaporkan nilai persisnya berdampingan dengan nilai yang akan dihasilkan parser.

• Bilangan bulat besar — Dibandingkan secara persis, memakai aritmetika presisi sembarang alih-alih nilai pecahan yang justru sedang dipersoalkan.
• Desimal panjang — Desimal yang tidak bisa dipulihkan dari double hasilnya dilaporkan beserta nilai pembulatan yang sebenarnya.
• Luapan dan kekurangan — 1e400 menjadi Infinity dan 1e-400 menjadi nol. Keduanya tidak dapat diwakili di JSON, dan tidak satu pun memicu error di tempat lain.
• Murah saat tidak berlaku — Literal dengan lima belas digit atau kurang tidak mungkin kehilangan apa pun, jadi dilewati sepenuhnya. Hanya yang mungkin terpengaruh yang diperiksa.

Sebagian besar berkas yang dilaporkan sebagai «JSON tidak sah» sama sekali tidak rusak. Berkas itu ditulis dalam sebuah dialek: JSONC, yang menambahkan komentar dan koma akhir, atau JSON5, yang juga mengizinkan kunci tanpa kutip, kutip tunggal, angka heksadesimal, dan NaN. Editor Anda membacanya tanpa keluhan; parser ketat menolaknya.

tsconfig.json, .eslintrc, dan sebagian besar berkas pengaturan editor adalah JSONC. Dictionary yang disalin dari sesi Python mirip JSON tetapi memakai True, False, dan None. Alih-alih menyebut semua itu rusak, validator menyebut apa yang sedang dilihatnya, merinci konstruksi yang bertanggung jawab, dan menawarkan salinan dalam JSON ketat.

• Komentar — Komentar baris maupun blok dikenali — dan hanya di luar string, sehingga URL yang mengandung garis miring ganda tidak tersentuh.
• Koma akhir — Koma sebelum kurung penutup, ditandai pada komanya dan bukan pada kurungnya.
• Tanda kutip dan kunci telanjang — String berkutip tunggal, kunci tanpa kutip, dan tanda kutip tipografis yang ditinggalkan pengolah kata.
• Literal bukan JSON — NaN dan Infinity, angka heksadesimal, tanda plus atau titik desimal di depan, serta True, False, dan None milik Python.

Setiap perbaikan berasal dari temuan yang sudah dilokalisasi pemindai, tidak pernah dari pola yang diterapkan ke seluruh dokumen. Perbedaan itu lebih penting daripada kedengarannya: ekspresi reguler yang membuang komentar juga menghapus garis miring ganda di dalam "https://example.com", dan yang membuang koma akhir juga menghapus koma di dalam "a, b,". Pemindai tahu byte mana yang berada di dalam string dan mana yang tidak, jadi kedua kesalahan itu tidak mungkin terjadi padanya.

Dokumen hasil perbaikan lalu divalidasi ulang sebelum ditawarkan, dan jika masih tidak sah, ia disajikan sebagai perbaikan sebagian dengan sisa kesalahan yang dirinci. Tombol bertuliskan «Sudah diperbaiki» yang mengembalikan sesuatu yang tetap gagal diurai lebih buruk daripada tidak ada tombol sama sekali.

• Yang diperbaiki — Komentar, koma akhir, kutip tunggal dan tipografis, kunci tanpa kutip, angka heksadesimal, plus atau titik di depan, serta True, False, dan None milik Python.
• Yang ditandai sebagai berkurang — NaN dan Infinity tidak punya ejaan JSON. Keduanya menjadi null, dan perubahan itu diumumkan alih-alih dilakukan diam-diam.
• Terapkan atau unduh — Masukkan teks hasil perbaikan langsung kembali ke editor, atau unduh sebagai berkas .json.

Sintaks hanyalah separuh pertanyaan. «Apakah bentuknya benar?» adalah separuh lainnya, dan itulah yang dijawab JSON Schema. Tempel satu di panel dan dokumen diperiksa terhadapnya juga, dengan setiap kegagalan membawa JSON Pointer ke nilai yang bermasalah beserta barisnya.

Draft 2020-12 dan draft-07 sama-sama didukung, dan draft dibaca dari $schema — atau disimpulkan bila skema tidak menyatakannya, yang berlaku bagi hampir semua skema yang ditulis sebelum 2020. Kesimpulan itu penting: bentuk array dari items pada draft-07 berarti hal lain di 2020-12, dan membaca yang satu sebagai yang lain menghasilkan jawaban yang meyakinkan tetapi salah, bukan sebuah error.

• Seluruh kosakata validasi — type, enum, const, batas numerik, panjang dan pola string, batasan array dan objek, required, serta kata kunci dependent.
• Aplikator — allOf, anyOf, oneOf, not, if/then/else, prefixItems, contains, propertyNames, serta unevaluatedProperties dan unevaluatedItems.
• Referensi — $ref, $defs, definitions, $anchor, dan cakupan $id diselesaikan di dalam skema yang Anda berikan. Referensi ke server lain dilaporkan namanya dan tidak pernah diunduh.
• format, sebagaimana didefinisikan spesifikasi — Secara bawaan hanya anotasi, persis seperti kata kedua draft: skema dengan "format": "email" tidak menolak alamat yang salah kecuali Anda memintanya. Ada saklar bagi yang mengharapkan sebaliknya.

Satu nilai JSON per baris adalah cara pipeline log, ekspor BigQuery, body API massal, dan set pelatihan model ditulis. Dibaca sebagai satu dokumen JSON, berkas semacam itu menghasilkan tepat satu error — konten berlebih di awal baris dua — yang secara teknis benar dan sama sekali tidak berguna.

Mode NDJSON memvalidasi setiap rekaman sendiri-sendiri, sehingga kesalahan dilaporkan pada rekaman tempatnya berada. Mode ini ditawarkan otomatis saat berkas tampak berbasis baris, dan ditawarkan alih-alih diterapkan: alat yang diam-diam menafsir ulang masukan Anda adalah alat yang tidak bisa Anda nalar.

• Hasil per rekaman — Setiap kesalahan membawa nomor rekamannya selain baris dan kolom, dan jumlah rekaman yang lolos dilaporkan di sampingnya.
• Baris baru di akhir — Setiap penulis mengakhiri rekaman terakhir dengan baris baru. Baris kosong terakhir itu bukan rekaman, dan memperlakukannya sebagai rekaman menambahkan error palsu pada hampir semua berkas yang ditulis dengan benar.
• Akhir baris Windows — Carriage return yang tertinggal di akhir rekaman jika tidak akan menjadi karakter kontrol di dalam token terakhirnya — satu error per baris pada berkas mana pun yang ditulis di Windows.
• Rekaman kosong — Baris kosong di tengah dilaporkan, bukan dilewati. Format ini tidak punya pemisah, jadi baris kosong berarti sebuah rekaman ditulis kosong.

Sebuah berkas bisa berupa JSON yang benar-benar sempurna dan tetap gagal karena tiga byte tak terlihat. Tanda urutan byte UTF-8 — yang ditulis Out-File PowerShell, StreamWriter .NET, dan ekspor «UTF-8» Excel — duduk di depan kurung kurawal pembuka, dan parser ketat melaporkan token tak terduga di posisi 0 untuk dokumen yang sebenarnya tanpa cela.

UTF-16 lebih buruk, karena itulah yang ditulis Windows PowerShell saat enkode tidak ditentukan sama sekali. Dibaca sebagai UTF-8 ia tampak seperti byte NUL setelah tiap karakter, dan errornya menunjuk ke sesuatu yang tak seorang pun bisa lihat. Keduanya dideteksi dan ditangani di sini, dan enkode yang dipakai dilaporkan agar tidak ada yang terjadi di belakang Anda.

• UTF-8, dengan atau tanpa tanda — Tandanya dikenali, dilepas, dan dilaporkan. Dokumen divalidasi seolah tanda itu tidak pernah ada.
• UTF-16, dengan atau tanpa tanda — Dideteksi dari tandanya, atau dari letak byte NUL — karakter struktural JSON semuanya ASCII, jadi polanya konklusif dan bukan tebakan.
• Byte cacat — Byte yang bukan UTF-8 sah dilaporkan sebagai peringatan, bukan putusan: peramban menggantinya sebelum parser mana pun melihatnya, jadi ia tidak bisa membuat dokumen tidak sah — tetapi berarti berkasnya tidak berada dalam enkode yang diakuinya.
• Sama sekali bukan teks — Gambar yang diganti nama menjadi .json ditolak dengan alasan itu, alih-alih menghasilkan error sintaks di posisi 0 untuk sesuatu yang tidak pernah berupa JSON.

Satu kali lintasan atas byte mentah, tanpa mengirim apa pun ke mana pun. Dokumen 22 MB diperiksa dalam sekitar 0,2 detik di laptop biasa — termasuk kunci ganda dan presisi angka — karena pemindainya tidak pernah membangun nilai yang sedang diperiksanya.

• Valid — Putusan hijau dengan tipe akar dan ukuran, plus laporan struktur: total simpul, kedalaman maksimum, jumlah objek, array, dan kunci, ukuran dalam baris dan byte, serta enkode yang dipakai.
• Tidak sah — Putusan merah dengan semua error dirinci — baris, kolom, JSON Pointer, penjelasan ringkas, dan penanda tepat di karakternya — plus tautan ke Format JSON.
• Peringatan — Kunci ganda, angka yang kehilangan presisi, escape surrogate tanpa pasangan, dan penyarangan yang luar biasa dalam, masing-masing dengan lokasinya. Semuanya tidak mengubah putusan, karena parser akan menerimanya.
• Dialek, bila ada — Jika teksnya JSON5, JSONC, atau dictionary Python yang sah, hal itu dinyatakan dengan jelas, beserta pilihan untuk mengonversinya.

JSON tidak sah merusak API, konfigurasi, dan pipeline data, dan biasanya merusaknya jauh dari tempat kesalahannya berada. Memeriksanya sebelum mengirim atau menyimpan menangkap salah ketik, koma yang hilang, koma akhir, dan karakter tanpa escape selagi berkasnya masih di depan Anda. Peringatannya lebih penting lagi: kunci ganda atau pengenal yang dibulatkan tidak menghasilkan error di mana pun, jadi lolos dari semua pengujian dan baru muncul sebagai data hilang berminggu-minggu kemudian. Semua pemeriksaan berjalan lokal, jadi data Anda tetap privat.

• Tangkap error lebih awal — Temukan masalah sintaks sebelum merusak penerapan atau integrasi, dengan baris dan kolom persis alih-alih jejak tumpukan dari server.
• Tangkap yang diam-diam — Kunci ganda dan hilangnya presisi lolos dari semua parser dan semua validator yang ada. Itulah kesalahan yang sampai ke produksi.
• Periksa bentuknya, bukan hanya sintaksnya — JSON Schema mengubah «berhasil diurai» menjadi «sesuai yang diharapkan konsumen», sebelum konsumennya tahu.
• Privasi — Tidak ada yang diunggah. Respons API privat, token akses, dan skema internal bisa diperiksa tanpa meninggalkan perangkat Anda.

Semua yang menentukan sah tidaknya sebuah dokumen bersifat gratis. Semua error alih-alih yang pertama, kunci ganda, peringatan presisi, JSON Schema, deteksi dialek, perbaikan, mode NDJSON, dan laporan struktur lengkap tersedia gratis. Pro menambah skala, bukan fitur.

• Gratis — Satu berkas sekali jalan, hingga 25 MB, plus tempel tanpa batas. Semua pemeriksaan, semua peringatan, validasi skema, dan perbaikan termasuk.
• Pro — Hingga 100 berkas dalam satu lintasan, ukuran dibatasi perangkat Anda dan bukan oleh kami, satu ZIP berisi laporan untuk seluruh batch, serta laporan JSON dan CSV yang bisa dibaca mesin untuk langkah CI atau tiket.
• Mengapa 25 MB — Itu hasil pengukuran, bukan angka bulat. Dokumen 22 MB diperiksa dalam sekitar 0,2 detik, jadi batasnya berada di titik yang masih nyaman bagi ponsel kelas menengah.

• Format JSON
• Perkecil JSON
• Penampil JSON
• Bandingkan JSON
• Urutkan kunci JSON
• Hapus kunci JSON