Pengesah JSON
Semak sama ada JSON sah dan lihat dengan tepat di mana ia gagal.
JSON sah.
Semuanya diproses dalam pelayar anda. Apa yang anda tampal tidak dimuat naik atau disimpan.
Panduan terperinci
Pengesahan JSON: apa yang dikira sah dan cara membaca ralat
Apa yang disemak pengesah (sintaks RFC 8259 sahaja), apa yang sengaja diterima, cara baris dan lajur dilaporkan, dan jadual kesilapan biasa dengan mesej enjin sekelas Chrome.
Angka utama sepintas lalu
- Apa yang disemak
- Sintaks sahaja, menggunakan JSON.parse pelayar
- Tiada skema, tiada jenis, tiada medan wajib.
- Sumber: IETF — RFC 8259
- Nilai peringkat atas
- Sebarang nilai JSON adalah sah
- 5, "text", null, [] dan {} semuanya lulus; RFC 8259 mentakrifkan teks JSON sebagai nilai yang disiri.
- Kunci berulang
- Diterima
- Tatabahasa membenarkannya; RFC 8259 hanya menyatakan nama SEPATUTNYA unik dan kelakuan sebaliknya tidak dapat diramal.
- Kedudukan ralat
- Dilaporkan apabila mesej pelayar mengandungi satu
- Sesetengah mesej (contohnya token tidak dijangka selepas koma) tiada kedudukan, jadi baris dan lajur tidak dapat dipaparkan.
Maksud "sah" di sini
Pengesah menjalankan JSON.parse pada apa yang anda tampal dan menunjukkan sepanduk hijau "JSON Sah" atau mesej merah. Ia dikemas kini semasa anda menaip. Input kosong atau hanya ruang kosong tidak menunjukkan apa-apa. Semuanya berlaku setempat pada halaman.
Maka sah hanya bermakna "teks sepadan dengan tatabahasa JSON", tidak lebih. Ia tidak memberitahu sama ada data mempunyai medan yang dijangka API (itu memerlukan pengesah skema), sama ada nombor muat dalam integer 64-bit, atau sama ada kunci unik. Contoh yang lulus:
5,"hello",null,true: RFC 8259 membenarkan sebarang nilai di peringkat atas.{"a":1,"a":2}: kunci berulang adalah mengikut tatabahasa.{"a":"\ud800"}: escape surrogat tunggal diterima pelayar.1e999: dari segi sintaks ialah nombor, walaupun double JavaScript tidak dapat menyimpannya.- Ruang kosong atau baris kosong di awal dan akhir.
Membaca mesej
Halaman mencetak JSON tidak sah: <mesej pelayar>. Jika mesej itu mengandungi position N tetapi tiada nombor baris, alat menambah "(baris L, lajur C)" yang dikira daripada teks. Enjin keluarga Chrome semasa sudah memasukkan "(line 1 column 8)" dalam mesej, jadi tiada apa ditambah; sesetengah enjin hanya mencetak ofset aksara, dan halaman menukarnya. Mesej tanpa kedua-duanya (contohnya Unexpected token ']', "[1,]" is not valid JSON) hanya menunjukkan token bermasalah dan petikan. Ayat mesej adalah milik pelayar dan tidak diterjemahkan.
| Input | Mesej lazim (enjin sekelas Chrome) |
|---|---|
{"a":1,} |
Expected double-quoted property name in JSON at position 7 (line 1 column 8) |
{'a':1} |
Expected property name or '}' in JSON at position 1 |
{a:1} |
Expected property name or '}' in JSON at position 1 |
[1 2] |
Expected ',' or ']' after array element at position 3 |
{"a" 1} |
Expected ':' after property name at position 5 |
{"a":1}} |
Unexpected non-whitespace character after JSON at position 7 |
{"a":"x⏎y"} (pemisah baris mentah) |
Bad control character in string literal at position 7 |
{"a":"\x41"} |
Bad escaped character |
{"a":5.} |
Unterminated fractional number |
{"a":-} |
No number after minus sign |
[1,] |
Unexpected token ']' (tiada kedudukan) |
{"a":.5}, {"a":+1} |
Unexpected token (tiada kedudukan): . dan + di hadapan tidak dibenarkan |
[1] dengan BOM di hadapan |
Unexpected token pada aksara tidak kelihatan |
Membetulkan ralat dengan cekap
- Pergi ke baris dan lajur yang dilaporkan; kesilapan sebenar biasanya di situ atau sebelum sedikit.
- Cari suspek biasa: koma di hujung, petikan tunggal, kunci tanpa petikan, komen, koma tertinggal antara item, pemisah baris mentah dalam rentetan.
- Jika kedudukan menunjuk ke penghujung sekali, ada kurungan atau petikan yang tidak pernah ditutup lebih awal.
- Jika aksara pertama bermasalah tetapi nampak biasa, mungkin ada tanda tertib bait (BOM) atau ruang tanpa pemisah (U+00A0); kedua-duanya bukan ruang kosong JSON. Ruang kosong JSON hanyalah ruang, tab, suap baris dan pemulangan bawa.
- Betulkan satu perkara dan baca mesej baharu; sepanduk dikemas kini serta-merta.
Petua: Dokumen yang lulus di sini masih boleh merosakkan pengguna lain. Penghurai dalam bahasa lain mungkin menolak surrogat tunggal, menolak nombor di luar julat integernya, atau gagal pada kunci berulang. Apabila penting, uji dengan penghurai yang benar-benar anda gunakan.
Kesilapan biasa
- Menampal objek JavaScript (kunci tanpa petikan, petikan tunggal, komen) atau
True/NonePython dan menjangka JSON. - Menganggap "sah" sebagai "data betul": pengesah tidak menyemak makna.
- Mengesahkan fail JSON Lines (satu objek setiap baris) sebagai satu dokumen; ia gagal selepas objek pertama. Sahkan setiap baris secara berasingan.
- Menampal HTML atau halaman log masuk yang dipulangkan dan bukan JSON; mesej menyebut
<sebagai token tidak dijangka.
Alat berkaitan
Cantikkan dengan pemformat JSON, kecilkan dengan pemadat JSON, teroka data sah dalam pemapar JSON, atau periksa token dengan penyemak tamat tempoh JWT.
Soalan lazim
Bagaimana cari ralat dalam JSON saya?
Keputusan di bawah kotak menyatakan JSON sah, atau memberi baris dan lajur masalah pertama, seperti koma lebihan atau petikan tunggal.
Adakah JSON saya dihantar ke pelayan?
Tidak. Semuanya berlaku dalam pelayar anda. Apa yang anda tampal tidak dimuat naik, dilog atau disimpan — penting apabila dokumen mengandungi kunci, token atau data peribadi.
Mengapa JSON saya dilaporkan tidak sah?
Punca paling biasa ialah koma di hujung, petikan tunggal dan bukan petikan berganda pada kunci dan rentetan, serta pemisah baris yang tidak dilepaskan di dalam rentetan. Mesej ralat memberikan baris dan lajur masalah pertama.
Adakah ia mengubah data saya?
Tidak. Dokumen dihurai dan disiri semula, jadi hanya ruang kosong berubah. Susunan kunci dikekalkan dan nilai tidak disentuh.
Bolehkah ia mengendalikan dokumen besar?
Boleh, dalam had memori pelayar anda. Dokumen beberapa megabait tidak menjadi masalah; fail yang sangat besar mungkin menyebabkan halaman berhenti seketika semasa menghurai.
Sumber rujukan
- IETF — RFC 8259, The JSON Data Interchange Format — Grammar, top-level values, duplicate names.
- ECMA-404 — The JSON data interchange syntax
- MDN — JSON.parse()
Panduan ini menerangkan peraturan yang diterbitkan dalam bahasa mudah. Ia bukan nasihat kewangan, undang-undang atau rasmi — peraturan boleh berubah, jadi sahkan dengan agensi yang dipautkan di atas sebelum membuat keputusan.