Mengumpulkan soalan yang paling kerap ditanya tentang alat di laman ini dan tentang spesifikasi JSON, dikumpulkan mengikut senario, dengan jawapan yang boleh anda gunakan terus dan bukannya kesimpulan yang kabur.
25 artikelAdakah data dimuat naik, berapa besar fail yang berfungsi, adakah apa-apa disimpan secara setempat, mengapa Cina bertukar menjadi escape: sepuluh soalan yang menjelaskan sempadan sebenar alat JSON dalam talian.
Sama ada komen dibenarkan, mengapa koma mengekor menimbulkan ralat, adakah kunci perlu petikan, mengapa 9007199254740993 berubah — dua belas kesimpulan, setiap satu disemak mengikut RFC 8259.
Sama ada pertanyaan laluan patut menggunakan JSONPath atau Pointer, bagaimana memilih antara Patch dan Merge Patch, apa yang boleh disekat oleh Schema, dan bagaimana memilih versi draft — semuanya dijelaskan dalam satu bacaan.
Mengapa fail JSON berukuran puluhan MB tidak akan dibuka, betapa mahalnya pengklonan dalam, bagaimana menghalang pencemaran __proto__, dan di mana XSS masuk — sepuluh kesimpulan bantuan awal disusun mengikut simptom.
Gaya penamaan, format masa, semantik null, bentuk enum, format konfigurasi, organisasi fixture, dan konflik gabungan — dua belas tolak ansur yang benar-benar dipertengkarkan oleh pasukan.
RFC 8259 tidak mempunyai sintaks komen, jadi // dan komen blok menyebabkan JSON.parse melontar ralat. Gunakan JSON5 atau JSONC, medan _comment, penerangan Schema, atau YAML sebagai alternatif.
Koma mengekor sah dalam literal objek JavaScript dan membawa maut dalam JSON. Berikut ialah ralat tepat, tatabahasa RFC 8259 yang menyebabkannya, dan tiga pembetulan yang benar-benar berkesan.
BOM UTF-8 ialah tiga bait tidak kelihatan, jadi JSON.parse gagal pada aksara pertama dan melaporkan baris 1 lajur 1, yang membuatkan fail kelihatan kosong atau terpotong.
JSON hanya mempunyai literal nombor perpuluhan. JSON.stringify menukar NaN dan Infinity menjadi null tanpa amaran, sebab itulah "medan nombor kadangkala null" terus muncul dalam produksi.
Integer melebihi 2^53-1 kehilangan ketepatan dalam JSON.parse. ID snowflake, nombor pesanan dan bigint pangkalan data semuanya terjejas, jadi biarkan mereka sebagai rentetan dari hujung ke hujung.
Escape \u4e2d\u6587 ialah Unicode yang sah, bukan kegagalan pengekodan. Mojibake sebenar kelihatan berbeza, dan membezakan kedua-duanya menentukan apa yang sebenarnya perlu anda betulkan.
Superset ketat mengikut urutan: JSONC menambah komen; JSON5 menambah petikan tunggal, kunci tanpa petikan, koma mengekor dan nombor hex. Memilih yang salah merosakkan API, bukan editor anda.
JSON menandakan sempadan dengan kurungan kurawal dan YAML dengan inden: mesin mendapat JSON, manusia yang menyunting konfigurasi mendapat YAML. Komen, sauh dan struktur berbilang dokumen tidak terselamat.
JSON Pointer ialah alamat unik yang boleh anda simpan sebagai kunci; JSONPath ialah bahasa pertanyaan. Menggunakan yang salah merosakkan kemas kini konfigurasi atau mencipta semula JSONPath yang rosak.
Schema mengawal struktur dan jenis, bukan makna perniagaan. Ia menghalang medan hilang, jenis salah dan enum di luar julat, manakala peraturan seperti amaun melebihi sifar kekal dalam kod.
2020-12 ialah versi semasa dan menambah $defs, prefixItems dan unevaluatedProperties, tetapi banyak alat masih hanya menyokong draft-07. Pilih mengikut apa yang disokong oleh keseluruhan rantai alat anda.
json-schema-to-typescript dan quicktype menghasilkan .d.ts dengan satu arahan, tetapi ia ialah draf: pilihan, gabungan, additionalProperties dan tarikh memerlukan semakan manusia.
Mengoptimumkan dalam urutan yang salah menjadikan setiap pertukaran pustaka tidak berguna. Ukur rangkaian, huraian dan render secara berasingan, kemudian kurangkan huraian, kecilkan muatan dan strim.
JSON.parse menganggap __proto__ sebagai kunci biasa; kerosakan berlaku dalam penggabungan rekursif yang menulis ke Object.prototype, jadi setiap objek mewarisi sifat penyerang.
JSON tidak pernah melaksanakan dengan sendirinya. XSS berlaku pada saat anda menganggapnya sebagai HTML — penggabungan rentetan di pelayan, innerHTML di frontend, atau membenamkan JSON terus ke dalam tag skrip.
Anda tidak perlu membaca polisi privasi untuk mengetahuinya. Buka panel rangkaian, cuba halaman secara luar talian, dan muat semula untuk melihat sama ada sesuatu kekal. Dua minit, tiga semakan, tanpa kepercayaan diperlukan.
Tiada had tetap; kekangan ialah bajet memori tab anda. Fail 20MB biasanya menjadi 60–100MB selepas dihuraikan, dan DOM yang diserlahkan boleh menggandakannya lagi.
Objek tanpa sampul bersih sehingga anda memerlukan metadata; sampul penuh selamat tetapi bertele-tele. Untuk kebanyakan projek guna status HTTP untuk hasil dan sampul stabil untuk data.
Nombor epoch dan rentetan ISO masing-masing mempunyai trade-off, tetapi mencampurkannya itulah yang sebenarnya merosakkan. Guna ISO 8601 dengan offset, simpan UTC, render dalam zon waktu pengguna.
`null` bermaksud medan wujud tanpa nilai; meninggalkannya bermaksud medan tidak wujud. Badan PATCH, penggabungan konfigurasi dan praisi borang ialah tempat perbezaan itu benar-benar terasa.
