คำถามที่พบบ่อย เครื่องมือจัดรูปแบบและตรวจสอบ JSON

Q: JSON formatter คืออะไร?

A: JSON formatter เป็นเครื่องมือที่รับข้อมูล JSON ดิบ ย่อขนาด หรือจัดรูปแบบไม่ดี และจัดรูปแบบใหม่ด้วยการย่อหน้า การขึ้นบรรทัดใหม่ และการเว้นวรรคที่เหมาะสมเพื่อให้มนุษย์อ่านได้ JSON formatter ส่วนใหญ่ยังมีการตรวจสอบความถูกต้อง การเน้นไวยากรณ์ การตรวจจับข้อผิดพลาด และบางครั้งมีคุณสมบัติเพิ่มเติมเช่นการเรียงลำดับคีย์ การย่อขนาด และการนำทางแบบ tree view เครื่องมือ JSON formatter ออนไลน์ฟรี ของเรารวมการจัดรูปแบบและการตรวจสอบไว้ในเครื่องมือเดียว ให้ผลลัพธ์ที่สะอาดทันทีพร้อมรายงานข้อผิดพลาดอย่างละเอียด

Q: ทำไม JSON ของฉันถึงไม่ถูกต้อง?

A: JSON ไม่ถูกต้องเมื่อละเมิดกฎที่เข้มงวดของข้อกำหนด JSON สาเหตุที่พบบ่อยที่สุดได้แก่:

• เครื่องหมายจุลภาคต่อท้าย หลังรายการสุดท้ายใน object หรือ array
• ขาดเครื่องหมายอัญประกาศคู่ รอบคีย์ object หรือค่าสตริง
• ใช้เครื่องหมายอัญประกาศเดี่ยว แทนเครื่องหมายอัญประกาศคู่ (เครื่องหมายอัญประกาศเดี่ยวไม่ถูกต้องใน JSON)
• อักขระพิเศษที่ไม่ได้ escape เช่น backslash หรือเครื่องหมายอัญประกาศภายในสตริงที่ไม่ได้ escape
• ค่าที่ไม่ถูกต้อง เช่น undefined, NaN หรือ Infinity (ซึ่งไม่มีในข้อกำหนด JSON)
• วงเล็บปีกกาหรือวงเล็บเหลี่ยมไม่ตรงกัน ที่ {/} หรือ [/] ไม่ได้จับคู่กันอย่างเหมาะสม

ใช้ JSON validator เพื่อระบุตำแหน่งและลักษณะของข้อผิดพลาดทางไวยากรณ์ที่แน่นอน validator ส่วนใหญ่รายงานบรรทัด คอลัมน์ และข้อความแสดงข้อผิดพลาดที่อธิบายสำหรับปัญหาแรกที่พบ

Q: ความแตกต่างระหว่าง JSON และ JavaScript object คืออะไร?

A: ในขณะที่ไวยากรณ์ JSON มาจากไวยากรณ์ JavaScript object literal พวกมันไม่ใช่สิ่งเดียวกัน ความแตกต่างสำคัญได้แก่:

1. คีย์ต้องอยู่ในเครื่องหมายอัญประกาศคู่ -- JSON ต้องการ {"key": "value"} ในขณะที่ JavaScript อนุญาต {key: "value"} (ไม่มีเครื่องหมายอัญประกาศ) และ {'key': 'value'} (เครื่องหมายอัญประกาศเดี่ยว)
2. ค่าสตริงต้องใช้เครื่องหมายอัญประกาศคู่ -- JSON อนุญาตเฉพาะเครื่องหมายอัญประกาศคู่สำหรับสตริง JavaScript ยอมรับทั้งเครื่องหมายอัญประกาศเดี่ยวและคู่
3. ไม่มีเครื่องหมายจุลภาคต่อท้าย -- JSON ห้ามเครื่องหมายจุลภาคต่อท้ายหลังรายการสุดท้าย JavaScript อนุญาต
4. ชนิดข้อมูลที่จำกัด -- JSON รองรับเฉพาะ string, number, boolean, null, object และ array JavaScript objects สามารถมีฟังก์ชัน, undefined, Date, Map, Set และประเภทพิเศษอื่นๆ
5. ไม่มีความคิดเห็น -- JSON ไม่รองรับความคิดเห็น JavaScript objects ในซอร์สโค้ดสามารถมีความคิดเห็นได้

นี่หมายความว่าคุณไม่สามารถเขียน JavaScript object แล้วเรียกมันว่า JSON ได้เฉยๆ -- มันต้องถูก serialize ด้วย JSON.stringify() หรือเขียนตามกฎ JSON ที่เข้มงวด

Q: JSON มีความคิดเห็นได้หรือไม่?

A: ไม่ ข้อกำหนด JSON อย่างเป็นทางการ (RFC 8259) ไม่รองรับความคิดเห็น JSON ถูกออกแบบให้เป็นรูปแบบการแลกเปลี่ยนข้อมูลที่น้อยที่สุดและไม่ขึ้นกับภาษา และความคิดเห็นถูกยกเว้นโดยเจตนาเพื่อให้ parser เรียบง่ายและสอดคล้องกันข้ามภาษา

หากคุณต้องการความคิดเห็น คุณมีตัวเลือกไม่กี่อย่าง:

• JSONC (JSON with Comments) -- ใช้โดย VS Code และเครื่องมืออื่นๆ สำหรับไฟล์กำหนดค่า JSONC อนุญาตความคิดเห็นแบบบรรทัด // และความคิดเห็นแบบบล็อก /* */
• YAML หรือ TOML -- รูปแบบการกำหนดค่าทางเลือกที่รองรับความคิดเห็นโดยตรง
• ข้อมูลเมตาตามแบบแผน -- ใช้คีย์เช่น "_comment" หรือ "//" ใน object JSON ของคุณเพื่อเก็บบันทึกที่มนุษย์อ่านได้ โปรดทราบว่าสิ่งนี้เพิ่มข้อมูลให้กับ payload ของคุณ
• ตัดความคิดเห็นก่อน parse -- ใช้ขั้นตอนการประมวลผลล่วงหน้าเพื่อลบความคิดเห็นก่อนส่ง JSON ไปยัง parser ที่เข้มงวด

Q: จะตรวจสอบ JSON ออนไลน์ได้อย่างไร?

A: การตรวจสอบ JSON ออนไลน์นั้นตรงไปตรงมา:

1. คัดลอกข้อมูล JSON ของคุณ
2. วางลงใน เครื่องมือตรวจสอบ JSON
3. คลิกปุ่มตรวจสอบหรือจัดรูปแบบ
4. เครื่องมือจะรายงานว่า JSON ถูกต้องหรือแสดงข้อผิดพลาดพร้อมตำแหน่งและคำอธิบายของปัญหาที่แน่นอน

เครื่องมือตรวจสอบ JSON ที่ดีควร:

• ตรวจสอบไวยากรณ์ตามข้อกำหนด JSON อย่างเป็นทางการ (RFC 8259)
• แสดงหมายเลขบรรทัดและคอลัมน์ของข้อผิดพลาด
• ให้ข้อความแสดงข้อผิดพลาดที่อธิบายว่าเกิดอะไรขึ้น
• จัดรูปแบบและ beautify JSON ในเวลาเดียวกัน (เป็นทางเลือก)
• เน้นไวยากรณ์ด้วยรหัสสีสำหรับชนิดข้อมูลที่แตกต่างกัน

สำหรับข้อมูลขนาดใหญ่หรือละเอียดอ่อน เครื่องมือตรวจสอบออนไลน์จำนวนมากประมวลผลทุกอย่างทางฝั่งไคลเอนต์ในเบราว์เซอร์ของคุณ หมายความว่าข้อมูลของคุณไม่เคยออกจากเครื่องของคุณ

Q: JSON แบบย่อขนาด (minified) หมายถึงอะไร?

A: JSON แบบย่อขนาดคือ JSON ที่ลบช่องว่างที่ไม่จำเป็นทั้งหมดออก -- ช่องว่าง แท็บ การขึ้นบรรทัดใหม่ และการย่อหน้าถูกตัดออก ผลลัพธ์คือข้อความบรรทัดเดียว (หรือน้อยมาก) ที่กะทัดรัด:

{"users":[{"id":1,"name":"Alice","roles":["admin"]}],"total":1}

JSON แบบย่อขนาดถูกใช้ในการผลิตด้วยเหตุผลหลายประการ:

• ขนาดไฟล์เล็กลง -- สามารถลดขนาด payload ได้ 30-50% หรือมากกว่า
• การถ่ายโอนผ่านเครือข่ายเร็วขึ้น -- ข้อมูลที่น้อยลงในการส่งหมายถึงความหน่วงที่ต่ำลง
• ลดค่าใช้จ่ายแบนด์วิดท์ -- สำคัญอย่างยิ่งสำหรับ API ที่มีการเข้าชมสูงและแอปพลิเคชันมือถือ

ข้อแลกเปลี่ยนคือ JSON แบบย่อขนาดนั้นมนุษย์อ่านไม่ได้เลย ใช้ เครื่องมือ JSON pretty print เพื่อจัดรูปแบบ JSON แบบย่อขนาดกลับเป็นโครงสร้างที่อ่านได้สำหรับการดีบักหรือตรวจสอบ

Q: จะ pretty print JSON ใน command line ได้อย่างไร?

A: เครื่องมือ command line หลายตัวสามารถ pretty print JSON ได้:

ด้วย jq (เป็นที่นิยมที่สุด ติดตั้งแยกต่างหาก):

cat file.json | jq .

ด้วย Python (มีในตัวบนระบบส่วนใหญ่):

python -m json.tool file.json

ด้วย Node.js:

node -e "const d = require('./data.json'); console.log(JSON.stringify(d, null, 2));"

ด้วย curl (pretty printing การตอบกลับของ API):

curl https://api.example.com/data | jq .

เครื่องมือ jq ได้รับการแนะนำสำหรับผลลัพธ์ที่มีสี ความสามารถในการ query และการจัดการข้อผิดพลาดที่แข็งแกร่ง

Q: JSON Schema คืออะไร?

A: JSON Schema เป็นคำศัพท์ที่ช่วยให้คุณใส่คำอธิบายประกอบและตรวจสอบเอกสาร JSON มันกำหนดโครงสร้าง ชนิดข้อมูล และข้อจำกัดที่เอกสาร JSON ต้องปฏิบัติตาม คิดว่ามันเป็นสัญญาหรือข้อกำหนดสำหรับข้อมูล JSON ของคุณ

ความสามารถหลักของ JSON Schema:

• การตรวจสอบประเภท -- ระบุว่าค่าต้องเป็น string, number, boolean, array, object หรือ null
• ฟิลด์ที่จำเป็น -- ทำเครื่องหมายคุณสมบัติบางอย่างเป็นบังคับ
• ข้อจำกัดของค่า -- ตั้งค่าต่ำสุด/สูงสุด รูปแบบสตริง (regex) และค่าที่อนุญาต (enums)
• การตรวจสอบ array -- ควบคุมความยาว array, ประเภทของรายการ และความเป็นเอกลักษณ์
• การตรวจสอบแบบซ้อน -- กำหนด schema สำหรับ object และ array ที่ซ้อนกัน
• การตรวจสอบแบบมีเงื่อนไข -- ใช้กฎที่แตกต่างกันตามค่าของฟิลด์อื่น

ตัวอย่าง JSON Schema:

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "required": ["name", "email"],
  "properties": {
    "name": { "type": "string", "minLength": 1 },
    "email": { "type": "string", "format": "email" },
    "age": { "type": "integer", "minimum": 0, "maximum": 150 }
  }
}

JSON Schema ถูกใช้ทั่วไปในการตรวจสอบ body คำขอ API, ไฟล์กำหนดค่า และสัญญาการแลกเปลี่ยนข้อมูลระหว่างบริการ