اختبار JSONPath

الصق نص JSON واكتب تعبير JSONPath وشاهد كل قيمة يحدّدها مع مسارها بالضبط. تتبع الأداة معيار JSONPath (RFC 9535) بما في ذلك المرشّحات مثل [?(@.price < 10)] والشرائح والمحارف البديلة. تُحلَّل الاستعلامات وتُقيَّم بالمرور على بياناتك: لا يُنفَّذ أي شيء ولا يُرفع أي شيء.

تتم المعالجة محليًا في متصفحك. لا يتم رفع بياناتك إلى خوادمنا.

يبقى نص JSON داخل هذه الصفحة: لا يُرفع ولا يُرسل إلى التحليلات أبدًا.

يبدأ بالرمز $ (المستند كله). مثال: $.store.book[0].title

النتيجة

أمثلة

استعلامات يمكنك تجربتها على البيانات النموذجية:

التعبيريحدّد
$.store.book[*].authorكل المؤلفين
$..priceكل الأسعار في أي مستوى
$..book[?(@.price < 10)].titleعناوين الكتب بسعر أقل من 10
$..book[?(@.isbn)].titleعناوين الكتب التي لها ISBN
$.store.book[-1:]الكتاب الأخير
$..book[0,1].titleأول عنوانين
$.store.book[?(length(@.title) > 15)].titleالعناوين الأطول من 15 حرفًا

الصيغة والمنهجية

يُحلَّل التعبير إلى خطوات (أبناء وأحفاد وأسماء وفهارس وشرائح ومرشّحات) ويُقيَّم على بيانات JSON بالمرور عليها وفق RFC 9535. تعود النتائج بترتيب المستند مع مساراتها الموحّدة، مثل $['store']['book'][0].

الصياغةالمعنى
$جذر المستند
@العقدة الحالية داخل مرشّح
.name or ['name']عضو بحسب الاسم
[0] [-1]عنصر مصفوفة بحسب الموضع؛ الرقم السالب يعدّ من النهاية
*كل عضو أو عنصر
..بحث في أي عمق (الأحفاد)
[1:3] [::2]شريحة: من البداية إلى النهاية (غير شاملة) مع خطوة اختيارية
[a,b]اتحاد عدة أسماء أو فهارس
[?(@.x > 1)]مرشّح: يُبقي الأبناء الذين يتحقق فيهم الشرط
&& || !اجمع الشروط بـ و، أو، ليس
length() count() value()دوال: طول نص أو مصفوفة أو كائن؛ عدد العقد؛ القيمة الوحيدة لمسار

تُعرض الأرقام تمامًا كما كُتبت في JSON، وعند تكرار مفتاح تُستخدم القيمة الأخيرة كما تفعل محلّلات JSON.

ملاحظات وقيود

  • لا يُنفَّذ أي شيء. تعبيرات السكربت مثل [(@.length-1)] ودوال التعبيرات النمطية match() وsearch() غير مدعومة وتُعرض كأخطاء.
  • تتبع المقارنات المعيار: القيم من أنواع مختلفة لا تتساوى أبدًا، و< و> تقارنان رقمين أو نصين فقط، والقيمة الغائبة لا تساوي إلا قيمة غائبة أخرى.
  • لا تستطيع المرشّحات مقارنة إلا المسارات التي تحدّد قيمة واحدة (أسماء وفهارس). استخدم اختبارات الوجود مثل ?(@.isbn) لغير ذلك.
  • تتوقف المستندات الكبيرة جدًا أو الاستعلامات التي ستمرّ على أكثر من 5000000 عقدة بخطأ؛ ويُحتفظ بحد أقصى 10000 مطابقة.
  • تختلف مكتبات JSONPath الأخرى في الميزات القديمة غير القياسية (مثل تعبيرات السكربت وغرائب $..)، فقد تختلف النتائج عن أدوات سبقت RFC 9535.

كيفية الاستخدام

  1. الصق نص JSON في المربع الأول.
  2. اكتب تعبير JSONPath، أو اختر استعلامًا نموذجيًا.
  3. اقرأ عدد المطابقات والقيم المطابقة ومسار كل منها.
  4. إذا كان التعبير أو JSON غير صالح فتبيّن الرسالة موضع المشكلة.
  5. انسخ القيم أو المسارات.

الأسئلة الشائعة

هل يُرفع نص JSON الخاص بي؟

لا. يعمل الاستعلام داخل متصفحك على نص لا يغادر الصفحة. لا يُرسل أي شيء تدخله إلى ToolQuarter ولا إلى التحليلات ولا إلى أي خدمة أخرى.

هل من الآمن استخدام تعبير مرشّح من شخص آخر؟

نعم. المرشّح لغة صغيرة من المقارنات تحلّلها هذه الأداة بنفسها؛ ولا يمكنه تنفيذ شيفرة أو استدعاء دوال لم تخترها أو الوصول إلى الشبكة.

ماذا يعني ..؟

مقطع الأحفاد: يجد $..price كل عضو «price» في أي عمق تحت الجذر، وليس الأبناء المباشرين فقط.

لماذا يفشل تعبير السكربت مثل [(@.length-1)]؟

تأتي تعبيرات السكربت من JSONPath قديم غير قياسي وتحتاج إلى تقييم شيفرة، وهو ما لا تفعله هذه الأداة أبدًا. استخدم [-1] للعنصر الأخير، أو مرشّحًا مثل ?(@.price < 10).

أي إصدار من JSONPath تنفّذه الأداة؟

معيار IETF، وهو RFC 9535، مع الأسماء والفهارس والمحارف البديلة والشرائح والاتحادات والمرشّحات ومقطع الأحفاد والدوال length() وcount() وvalue().

آخر تحديث: