JSONPath tester أونلاين
شغّل مسارًا وشاهد كل تطابق
يشغّل JSONPath tester أونلاين هذا مسارك على JSON الخاص بك ويسرد كل تطابق بعنوانه الدقيق. تعمل المرشحات والشرائح والرموز البديلة داخل تبويبك.
- مجانيالسعر
- 8المحددات
- لا شيءالتسجيل
- لا شيءالرفع
JSONPath tester
اكتب مسارًا وشاهد كل تطابق ومساره الدقيق
الصق بعض JSON على اليسار للبدء.
صيغة JSONPath بنظرة واحدة
$ | جذر المستند. |
|---|---|
@ | العنصر الحالي، داخل مرشّح. |
.name ["name"] | ابن، بالاسم. |
[*] .* | كل ابن. |
.. | ابحث على أي عمق تحته. |
[0] [-1] | عنصر قائمة، يُعدّ من البداية أو من النهاية. |
[0,2] | عدة عناصر معًا. |
[1:3] [::2] | شريحة: من، حتى دون شمول، وخطوة. |
[?(@.price < 10)] | مرشّح: يُبقي الأبناء الذين يتحقق لهم الشرط. |
&& || ! | و وأو ولا، داخل مرشّح. |
=~ /^a/i | طابق النص بتعبير نمطي. |
length() count() | الدوال: length وcount وmatch وsearch وvalue. |
جاهز. الصق JSON واكتب مسارًا فتظهر التطابقات.
فيمَ يُستخدم JSONPath tester أونلاين
في الواقع، JSONPath لغة صغيرة لانتقاء القيم من JSON. فكّر فيها كـXPath لـJSON. وقد يسحب سطر قصير كل سعر من استجابة ضخمة.
كذلك، يتيح لك JSONPath tester أونلاين هذا تجربة مسار قبل وضعه في الشيفرة. الصق JSON، واكتب المسار، فتظهر التطابقات أثناء الكتابة. ويعرض كل تطابق مساره الكامل أيضًا.
وهذا يفيد في أماكن كثيرة. أيضًا، أدوات API ومجموعات الاختبار والبحث في السجلات وتطبيقات اللا-كود تقبل JSONPath. المسار الخاطئ لا يعيد شيئًا، وعدم وجود شيء يشبه النجاح. لذلك توفّر التجربة أولًا وقتًا.
المحرك مبني من الصفر، ولا ينفّذ نصك كشيفرة أبدًا. يتبع شكل RFC 9535، ويقبل أيضًا الأسلوب القديم الذي يعرفه كثيرون.
يساعد JSONPath أيضًا في تتبع الأخطاء. افترض أن اختبارًا فشل لأن حقلًا ناقص. في الواقع، الصق الاستجابة، وشغّل مسارًا، وانظر في ثوانٍ هل الحقل موجود، وأين. عندها تصلح الاختبار بثقة.
مسارك الأول
يبدأ كل مسار بعلامة الدولار. كذلك، وهي ترمز إلى جذر المستند. بعدها تضيف خطوات. نقطة واسم يختاران ابنًا. وهكذا ينزل $.store.bicycle.color إلى لون الدراجة.
تؤدي الأقواس المربعة العمل نفسه، وتسمح أيضًا بأسماء فيها مسافات أو نقاط. اكتب $["my key"] لتلك الحالات. وتختار الأرقام بين الأقواس عنصر قائمة، ابتداءً من الصفر.
اضغط جرّب مثالًا وانقر شريحة مثال. أيضًا، تملأ الأداة المسار وتشغّله فورًا.
الرموز البديلة والبحث في كل مكان
النجمة تعني كل ابن. يعطي $.store.book[*].author مؤلف كل كتاب. وتعمل النجمة نفسها بعد النقطة، كما في $.store.*.

تعني نقطتان البحث على أي عمق. يجد $..price كل سعر في المستند كله، سواء في كتاب أو على دراجة. في الواقع، وهذه أسرع طريقة لإيجاد قيمة لا تعرف أين تختبئ.
تعود النتائج بترتيب المستند. ويعرض كل منها المسار الدقيق حيث يوجد، فيمكنك نسخه واستخدامه عنوانًا دقيقًا.
تذكّر أيضًا أن النتائج تحتفظ بترتيبها. كذلك، إذا احتوت قائمة عشرة عناصر، عادت التطابقات بالترتيب نفسه. فيمكنك إقرانها بقائمة أخرى بأمان.
الشرائح والاتحادات والفهارس السالبة
يمكنك اختيار عدة عناصر معًا. يأخذ [0,2] الأول والثالث. و[1:3] شريحة. تأخذ العناصر من الفهرس 1 حتى الفهرس 3 دون أن تشمله.

تقبل الشرائح خطوة. يأخذ [::2] كل عنصر ثانٍ. وتعد الأرقام السالبة من النهاية، فـ[-1] آخر عنصر و[-2:] آخر اثنين.
JSONPath filter أونلاين
المرشحات أقوى جزء. أيضًا، تُبقي فقط الأبناء الذين يجتازون اختبارًا. يُبقي $.store.book[?(@.price < 10)] الكتب الأرخص من عشرة. وترمز علامة @ إلى العنصر قيد الاختبار.

اجمع الاختبارات بـو وأو ولا. اختبر وجود مفتاح بكتابته وحده، مثل [?(@.isbn)]. في الواقع، وقارن الأرقام والنص وtrue وfalse وnull.
تحتاج إلى مطابقة نص؟ استخدم تعبيرًا نمطيًا مع =~، كما في [?(@.author =~ /^e/i)]. أو استدعِ دالة مثل length(@.title) أو count(@.*).
رسائل واضحة عندما يكون المسار خاطئًا
لا ينبغي أن يتركك خطأ مطبعي تخمّن. كذلك، عندما يكون المسار غير صالح، تقول الأداة ما الخطأ وتضع علامة تحت الموضع الدقيق. وينال القوس الناقص والتعبير النمطي السيئ والدالة المجهولة جملة خاصة لكل منها.

ثلاث طرق لكتابة مسار
يعرض كل تطابق عنوانه. بدّل اعرض المسارات كـ إلى أقواس أو نقاط أو JavaScript. وصيغة JavaScript، مثل data.store.book[0].title، تدخل مباشرة في شيفرتك.
استخدام JSONPath tester خطوة بخطوة
أربع خطوات تنقلك من JSON الخام إلى مسار تثق به.
- 1
الصق JSON الخاص بك
الصقه، أو افتح ملفًا، أو حمّل مثال المكتبة. تفحصه الأداة أثناء الكتابة.
- 2
اكتب مسارًا
ابدأ بعلامة الدولار. وانقر شريحة مثال إن أردت بداية سريعة.
- 3
اقرأ التطابقات
يعرض كل تطابق قيمته ومساره. ويقول العداد كم عددها.
- 4
انسخ ما تحتاجه
انسخ القيم كقائمة JSON، أو المسارات، واحدًا في كل سطر.
ما الذي يفعله JSONPath tester هذا بشكل مختلف
كثير من المختبِرات تعيد قيمة وتتوقف. وهذه هي الإضافات.
كل تطابق يعرض مساره
ترى العنوان الدقيق لكل إصابة، بأقواس أو نقاط أو JavaScript. انسخ أيًّا منها.
مرشحات حقيقية
استخدم و وأو ولا والمقارنات والتعابير النمطية والدوال داخل مرشّح.
أخطاء مفيدة
علامة تشير إلى الخطأ، وجملة واضحة تقول ما الذي يجب تغييره.
أرقام دقيقة
المعرّفات الطويلة تحتفظ بكل رقم، فلا يعرض التطابق رقمًا مقرّبًا أبدًا.
ورقة مرجع مدمجة
جدول قصير للصيغة يقع تحت الأداة، فلا تغادر الصفحة أبدًا.
لا شيء يغادر تبويبك
كثيرًا ما تحوي بيانات API الحقيقية تفاصيل خاصة. ولأن متصفحك يؤدي العمل، لا يصل شيء منها إلى هذا الموقع.
عادات لكتابة مسارات موثوقة
قد يفشل مسار نجح مع عيّنة في العيّنة التالية. وهذه العادات تساعد.
- ابدأ بأقصر مسار. أضف خطوة واحدة في كل مرة. وعندما ينكسر مسار تعرف أي خطوة سببت ذلك.
- استخدم النقطتين باعتدال. البحث على أي عمق مفيد. لكنه قد يطابق حقولًا لم ترد اختيارها. فضّل مسارًا واضحًا حين تعرفه.
- جرّب ببيانات حقيقية. الصق استجابة حقيقية لا مثالًا مرتبًا. للبيانات الحقيقية مفاتيح ناقصة وقيم غريبة.
- افحص الحالة الفارغة. اسأل ماذا يعيد المسار حين لا يطابق شيء. ويجب أن تتعامل شيفرتك مع قائمة فارغة.
- اختبر وجود المفتاح قبل مقارنته. مرشّح على مفتاح غائب يُسقط العنصر ببساطة. أضف اختبار وجود إذا أردت معرفة السبب.
- ضع علامات اقتباس حول الأسماء ذات الرموز الخاصة. الاسم الذي فيه نقطة أو مسافة يحتاج إلى أقواس وعلامات اقتباس، مثل
["my key"]. - انتبه إلى النوع في المقارنة. الرقم 5 والنص "5" مختلفان. والمرشّح الذي يقارن بينهما يجيب بلا.
- اعرف مكتبتك. تدعم المكتبات المختلفة صيغة مختلفة قليلًا. جرّب هنا ثم افحص مكتبتك للحالات الحدّية.
- استخدم المسار الدقيق للتحديثات. لتغيير قيمة، استخدم المسار الكامل من القائمة لا بحثًا. وهكذا تتجنب لمس القيمة الخاطئة.
- احفظ أفضل مساراتك. احتفظ بقائمة قصيرة في ملاحظاتك. المسار الجيد يستحق إعادة الاستخدام.
أخطاء JSONPath الشائعة التي يكتشفها هذا المختبِر
أيضًا، كل واحد منها لا يعيد شيئًا أو يعيد غير المطلوب. ويُظهره المختبِر فورًا.
نسيان علامة الدولار
يجب أن يبدأ المسار بـ$. يخبرك المختبِر بذلك بدل أن يعيد قائمة فارغة.
قوس ناقص
في الواقع، قوس مفتوح بلا إغلاق يكسر المسار كله. وتبيّن العلامة أين ينتهي.
العد من واحد
تبدأ القوائم من الصفر. فـ
[1]هو العنصر الثاني لا الأول.مقارنة النوع الخاطئ
كذلك، سعر مخزّن كنص لا يجتاز اختبار الأرقام. افحص القيمة في النتائج.
استخدام أقواس السكربت
الصيغة القديمة مثل
[(@.length-1)]تنفّذ شيفرة. وترفضها هذه الأداة للأمان. أيضًا، استخدم فهرسًا سالبًا بدلًا منها.مطابقة الكثير بنقطتين
قد يلتقط البحث العميق مفاتيح متشابهة في أماكن أخرى. اقرأ مسار كل تطابق.
أسئلة شائعة عن JSONPath tester
هل JSONPath tester أونلاين هذا مجاني؟
نعم. لا يكلّف شيئًا، ولا يطلب حسابًا، وليس له حدود. ولأنه يعمل في متصفحك، فلا توجد تكاليف خوادم نحمّلها عليك.
هل يُرفع JSON الخاص بي إلى أي مكان؟
لا. متصفحك ينفّذ المسار. لا شيء يصل إلى هذا الموقع، ولا نحفظ شيئًا. كما أن إغلاق التبويب يمسح كل شيء.
ما هو JSONPath؟
أيضًا، هو لغة استعلام لـJSON. يختار تعبير قصير القيم بالاسم أو الموضع أو الشرط، مثلما تفعل XPath مع XML.
هل يتبع RFC 9535؟
يتبع شكل المعيار، بمرشحاته وشرائحه ودوالّه. ويقبل أيضًا أسلوب Goessner القديم الذي ما زالت مكتبات كثيرة تستخدمه.
ماذا تعني نقطتان؟
تعنيان البحث على أي عمق. يجد <code>$..name</code> كل مفتاح name مهما كان عميقًا.
كيف أرشّح بقيمة؟
استخدم مرشّحًا بين أقواس مربعة. مثلًا يُبقي <code>[?(@.price > 10)]</code> العناصر التي سعرها فوق عشرة. وترمز علامة @ إلى العنصر.
هل أستطيع استخدام تعبير نمطي؟
نعم. اكتب <code>=~</code> ونمطًا بين شرطتين مائلتين، مثل <code>[?(@.name =~ /^a/i)]</code>. وتتجاهل الراية i حالة الأحرف.
لماذا يقول إن تعابير السكربت غير مدعومة؟
في الواقع، الصيغة القديمة بأقواس دائرية داخل المربعة تقيّم شيفرة. نرفضها كي لا يعمل أي شيء. ويؤدي المرشّح أو الفهرس السالب الغرض نفسه.
لماذا لا يعيد مساري شيئًا؟
افحص الأسماء وحالة الأحرف والأقواس. وافحص النوع في المرشّح أيضًا. ابدأ من <code>$</code> وأضف خطوة واحدة في كل مرة.
هل أستطيع استخدام المسار في شيفرتي؟
نعم. كذلك، تقبل معظم المكتبات الصيغة نفسها. جرّب هنا ثم الصق المسار في شيفرتك. وإذا اختلفت مكتبة، فتبيّن ورقة المرجع ما يجب تعديله.
ماذا يحدث مع المفاتيح المكررة؟
يفوز الأول عندما تختار بالاسم. ويمكن للبحث العميق أن يصل إلى الاثنين، لأنه يزور كل إدخال.
هل تظهر الأرقام الكبيرة بدقة؟
نعم. يحتفظ القارئ بكل رقم، فيظهر معرّف من 20 رقمًا كما كتبته.
هل يعمل على الهاتف؟
نعم. أيضًا، تتراص اللوحتان وتلتف شرائح الأمثلة. ومع ذلك فلوحة المفاتيح أريح للتعديل الطويل.
رفقاء مفيدون للعمل مع JSON
تجربة مسار خطوة واحدة. وهذه الأدوات الثلاث تتولى الخطوات المحيطة بها.
اقرأ JSON كشجرة أو جدول ثم عدّله.
افتح الأداة ←جمّل وصغّر وتحقق مع السطر الدقيق لأي خطأ.
افتح الأداة ←قارن مستندي JSON بالمعنى واسرد كل تغيير.
افتح الأداة ←
هل أنت جاهز لتجربة مسار؟
الصق JSON الخاص بك، واكتب مسار JSONPath، واقرأ النتائج. كذلك، المختبِر مجاني، ولا يطلب حسابًا، ويُبقي كل بايت على جهازك.