Memahami Sintaks dan Struktur JSON
JSON (JavaScript Object Notation) ialah format pertukaran data yang ringan, mudah dibaca oleh manusia, dan mudah diproses oleh mesin. Struktur JSON dibina berasaskan dua elemen utama: pasangan nama/nilai (objek) dan senarai nilai yang tertib (tatasusunan). Walaupun sintaksisnya ringkas, kesilapan kecil seperti tertinggal tanda petik atau koma boleh menyebabkan keseluruhan dokumen menjadi tidak sah.
Alat Pemformat JSON direka untuk membantu anda menyusun, mengesahkan, dan mengecilkan data JSON secara langsung dalam pelayar web. Dengan menggunakan alat ini, struktur data yang rumit boleh diformatkan semula supaya lebih mudah dibaca, atau dikecilkan untuk mengurangkan saiz fail semasa penghantaran data.
Pengesahan dan Pembetulan Ralat JSON
Apabila mengendalikan respons API atau fail konfigurasi, ralat sintaks sering berlaku. Alat ini secara automatik menyemak kesahan data anda dan memaparkan status seperti "JSON Sah" atau "JSON tidak sah". Jika terdapat ralat, sistem akan menunjukkan lokasi tepat melalui mesej "baris {line}, lajur {col}" serta menyediakan butang "Pergi ke ralat" untuk navigasi pantas.
Alat ini mampu mengesan dan memperincikan ralat spesifik berikut:
- "Koma tertinggal antara item"
- "Koma berlebihan sebelum kurungan penutup"
- "Kunci objek mesti dibalut dengan tanda petik berganda"
- "Titik bertindih tertinggal selepas nama sifat"
- "Ada rentetan yang tiada tanda petik penutup"
- "JSON ini tamat terlalu awal — nampaknya terpotong"
- "Aksara tidak dijangka di tempat yang sepatutnya ada nilai"
- "JSON ini bersarang terlalu dalam untuk diprose"
- "Kunci pendua
{key}— buang satu sebelum memformat" (alat ini tidak akan menggabungkan atau membuang nilai pendua secara senyap).
Bagi ralat yang dikesan, anda boleh klik "Pratonton pembaikan" untuk membuka tetingkap "Pratonton pembaikan" yang memaparkan perbandingan antara "Asal" dan "Selepas pembaikan". Jika sesuai, klik "Gunakan pembaikan" untuk memulihkan data, di mana mesej "Pembaikan digunakan. Tekan Ctrl/Cmd+Z untuk buat asal." akan dipaparkan. Jika pembaikan gagal, mesej "Input ini tidak dapat dibaiki secara automatik." akan keluar. Untuk dokumen yang sangat besar, anda mungkin melihat mesej "Pratonton dipendekkan — pembaikan melibatkan keseluruhan dokumen.".
Mengendalikan Format Bukan Standard dan JSON-like
Sering kali data yang diterima tidak berformat JSON tulen tetapi menyerupai strukturnya. Pemformat JSON mempunyai keupayaan untuk mengesan format bukan standard dan menawarkan tindakan pembetulan automatik:
| Pengesanan Mesej | Tindakan Pembetulan |
|---|---|
| "Ini kelihatan seperti JSON di dalam blok kod Markdown." | "Apabila digunakan, hanya JSON di dalam blok yang dikekalkan." |
| "Ini kelihatan seperti JSON yang di-escape di dalam rentetan." | "Apabila digunakan, rentetan di-unescape menjadi JSON biasa." |
| "Ini kelihatan seperti kamus gaya Python, bukan JSON." | "Apabila digunakan, tanda petik dan True/False/None ditulis semula sebagai JSON." |
| "Ini kelihatan seperti JSON Lines — satu nilai setiap baris." | "Apabila digunakan, baris-baris digabungkan menjadi satu tatasusunan JSON." |
| "Ini kelihatan seperti JSON yang dibalut callback JSONP." | "Apabila digunakan, pembalut callback dibuang." |
| "Ini kelihatan seperti JSONC — ada komen atau koma hujung. Tukar sintaks kepada JSONC atau gunakan pembaikan." | "Apabila digunakan, komen dan koma hujung dibuang." atau "Apabila digunakan, input digantikan dengan JSON yang telah dibaiki." |
Anda juga boleh menukar pilihan "Sintaks" antara "JSON" dan "JSONC" secara manual mengikut keperluan fail anda.
Navigasi Struktur Data dengan Paparan Pepohon
Untuk dokumen JSON yang besar dan kompleks, membaca kod baris demi baris adalah sukar. Alat ini menyediakan paparan "Pepohon" sebagai alternatif kepada paparan "Kod". Melalui "Pepohon JSON", anda boleh meneroka hierarki data bermula dari nod "root".
Ciri-ciri navigasi dalam paparan pepohon termasuk:
- Carian Pintar: Gunakan kotak input "Cari kunci dan nilai". Hasil carian akan dipaparkan dalam format "
{current}daripada{total}" atau "{current}daripada{total}+" jika dihadkan, serta "Tiada padanan" jika tiada data ditemui. Anda boleh menavigasi menggunakan butang "Padanan sebelumnya" dan "Padanan seterusnya". - Kawalan Nod: Gunakan butang "Kembangkan semua", "Runtuhkan semua", "Kembangkan
{key}", atau "Runtuhkan{key}". - Pengehadan Saiz: Jika JSON tidak sah, paparan pepohon akan menunjukkan "Betulkan JSON untuk melihatnya sebagai pepohon.". Jika data terlalu besar, ia akan memaparkan "JSON ini terlalu besar untuk dipaparkan sebagai pepohon." atau "JSON ini mempunyai terlalu banyak nilai untuk dipaparkan sebagai pepohon.". Apabila mengembangkan nod pada fail besar, paparan dihadkan dengan mesej "JSON ini terlalu besar untuk dikembangkan sepenuhnya — memaparkan
{count}baris pertama." di mana anda boleh klik "Tunjukkan{count}lagi…".
Pengekstrakan Data Menggunakan JSON Pointer dan JSONPath
Apabila anda menemui nilai spesifik dalam paparan pepohon, anda tidak perlu menyalinnya secara manual. Dengan mengklik butang "Pilihan salin untuk {key}", menu konteks akan menyediakan pilihan berikut:
- "Salin nilai": Menyalin nilai mentah daripada kunci tersebut.
- "Salin JSON Pointer": Menyalin rujukan lokasi berdasarkan spesifikasi RFC 6901.
- "Salin JSONPath": Menyalin sintaks pertanyaan untuk pengekstrakan data dalam aplikasi pengaturcaraan.
Selepas memilih, status "Disalin ke papan keratan." akan dipaparkan.
Pengurusan Fail Besar dan Operasi Isih
Alat ini menyokong input teks secara tampalan terus atau melalui muat naik fail .json atau .txt dengan menekan "Buka fail" atau menyeret fail ke kawasan "Letakkan fail.json atau.txt di sini". Apabila fail berjaya dibuka, mesej "{name} dimuatkan ({size})." akan kelihatan.
Beberapa peraturan had pemprosesan dan ralat fail yang perlu diperhatikan:
- Had Saiz Fail: Fail maksimum yang disokong ialah 10 MiB. Jika melebihi had, mesej "Fail terlalu besar — hadnya
{limit}." atau "Input lebih besar daripada{limit}, melebihi apa yang boleh diproses oleh alat ini." akan dipaparkan. - Jenis Fail & Pengekodan: Fail mestilah dalam format UTF-8. Jika tidak, ralat "Fail ini bukan teks UTF-8, jadi ia tidak boleh dibuka di sini." atau "Jenis fail tidak disokong — pilih fail.json atau.txt." akan keluar.
- Ralat Membaca: Jika fail gagal dimuatkan, sistem memaparkan "Tidak dapat membaca fail ini. Cuba pilih semula.".
- Had Masa Semakan: Ambang pemprosesan seumpat (synchronous) adalah pada 250,000 aksara. Jika semakan mengambil masa terlalu lama, ia akan dihentikan dengan mesej "Semakan JSON ini mengambil masa terlalu lama dan telah dihentikan. Cuba dokumen yang lebih kecil.".
- Pemeliharaan Integer: Alat ini mengekalkan nilai integer besar (large integers) tanpa kehilangan ketepatan angka.
Anda juga boleh menyusun kunci objek secara abjad dengan menekan butang "Isih kekunci". Fungsi ini akan "Mengisih kekunci objek secara rekursif mengikut urutan titik kod. Urutan tatasusunan tidak akan berubah.". Selepas selesai, mesej "Kekunci telah diisih — urutan tatasusunan tidak berubah. Tekan Ctrl/Cmd+Z untuk buat asal." akan dipaparkan.
Privasi Data dan Pemprosesan Tempatan
Keselamatan data anda adalah keutamaan kami. JSON anda diproses dalam pelayar anda. Tiada apa-apa yang dimuat naik ke BroBroGo. Semua operasi penukaran, pengesahan, pemformatan, dan pengecilan dilakukan secara lokal pada peranti anda menggunakan sumber pelayar web anda sendiri.
Soalan Lazim (FAQ)
Adakah JSON saya dimuat naik? Tidak. Pemformat berjalan dalam pelayar anda dan tidak memuat naik JSON anda.
Apakah fungsi minify? Minify membuang ruang kosong dan pemisah baris yang tidak diperlukan sambil mengekalkan data JSON yang sama.
Apakah had saiz fail maksimum yang boleh dibuka oleh alat ini? Had maksimum fail yang boleh dibuka dan diproses oleh alat ini ialah 10 MiB.
Bolehkah saya membatalkan tindakan isih kekunci atau pembaikan yang telah dibuat? Ya, anda boleh menekan kombinasi kekunci Ctrl+Z (Windows) atau Cmd+Z (Mac) pada papan kekunci anda untuk mengembalikan data kepada keadaan asal.