ما هو JSON؟
JSON (JavaScript Object Notation) صيغة نصية للبيانات المهيكلة تتكون من كائنات ومصفوفات ونصوص وأرقام وقيم منطقية وnull. يعرّفها المعياران RFC 8259 وECMA-404، وهي مستقلة عن لغة البرمجة، وتُعدّ الصيغة الافتراضية لواجهات الويب لأنها مضغوطة وقابلة للقراءة وسهلة التحليل.
كيفية استخدام عارض شجرة JSON
- الصق مستند JSON في منطقة الإدخال.
- تصفّح الشجرة؛ وانقر أسهم الإظهار لتوسيع الفروع أو طيّها.
- انقر شارة المسار بجوار أي قيمة لنسخ مسار JSONPath الخاص بها إلى الحافظة.
مزايا عارض شجرة JSON
- شجرة قابلة للطي مع شارات الأنواع وعدد العناصر/المفاتيح على كل عقدة
- انقر أي عقدة لنسخ مسار JSONPath الخاص بها ($.users[0].email)
- أزرار «توسيع الكل» / «طي الكل»
- إحصاءات عامة: الكائنات والمصفوفات والقيم الطرفية وأقصى عمق
- عرض فوري أثناء اللصق أو التحرير
- التعامل مع المستندات الكبيرة عبر تقسيم الحاويات التي تضم أكثر من 500 عنصر إلى صفحات
مثال على عارض شجرة JSON
استكشاف حمولة متداخلة
الإدخال:
{"order":{"id":1001,"items":[{"sku":"KB-100","qty":2}]}}النتيجة:
$ {1 key}
order {2 keys}
id: 1001 (number)
items [1 item]
[0] {2 keys}
sku: "KB-100" (string)
qty: 2 (number)الأسئلة الشائعة حول عارض شجرة JSON
كيف أنسخ مسار قيمة معينة؟
تعرض كل عقدة مسار JSONPath الخاص بها (مثل $.users[0].email). انقر شارة المسار لنسخه إلى الحافظة.
هل يمكنني طي كل شيء دفعة واحدة؟
نعم — استخدم زرّي «توسيع الكل» / «طي الكل» أعلى الشجرة. تبدأ العقد الأعمق من مستويين مطوية للحفاظ على سهولة قراءة المستندات الكبيرة.
هل هناك حد لحجم المستند؟
المستندات التي يصل حجمها إلى 2 ميغابايت مدعومة. أما الحاويات التي تضم أكثر من 500 عنصر فتعرض أول 500 عنصر فقط للحفاظ على استجابة الصفحة.
هل يعمل مع المصفوفات في الجذر؟
نعم. تُعرض المصفوفات والكائنات وحتى القيم الأولية المفردة، مع إظهار عدد العناصر والأنواع بجوار كل عقدة.
ملاحظات تقنية
يمرّ التحليل عبر الدالة parseJson نفسها التي يستخدمها منسّق JSON: تُزال علامة BOM من بداية النص، ثم تتولى JSON.parse المدمجة في المتصفح العمل، فتعرض الشجرة المستند كما يحتفظ به محرك JavaScript تماماً. ويترتب على ذلك أمران: المفاتيح المكررة تُختزل إلى آخر قيمة لها، والأعداد الصحيحة التي تتجاوز 2^53 − 1 تظهر مقرّبة؛ فهذا العارض لا يجري فحص الأعداد غير الآمنة الذي يقوم به مدقّق JSON.
تُبنى الشجرة من عناصر <details> الأصلية: يبدأ الجذر وأبناؤه المباشرون مفتوحين وتبدأ العقد الأعمق مطوية، ويبدّل زرّا «توسيع الكل» و«طيّ الكل» حالة كل عنصر. وتُشتق المسارات أثناء العرض — فهارس المصفوفات بصيغة [0]، والمفاتيح الشبيهة بالمعرّفات بصيغة .key، وأي مفتاح آخر (مسافات أو شرطات أو أحرف غير لاتينية) بصيغة ["key"] مع تهريب علامات الاقتباس الداخلية. ويُقتطع كل حاوٍ عند أول 500 عنصر على حدة، وتأتي الإحصاءات من اجتياز واحد يبدأ فيه الجذر بالعمق 0.
المراجع
- RFC 8259: The JavaScript Object Notation (JSON) Data Interchange Formatقواعد JSON: الكائنات والمصفوفات والنصوص والأرقام والقيم الثلاث الثابتة، وUTF-8 كترميز للتبادل.
- ECMA-404: The JSON Data Interchange Syntaxصياغة JSON كمعيار من Ecma، متوافقة مع RFC 8259.
- Introducing JSONالوصف الأصلي المختصر لـ JSON مع مخططاته النحوية.