What is JSONPath and what is it used for?

JSONPath is a query language for JSON, analogous to XPath for XML. It lets you extract values from a JSON document using path expressions. $.store.book[0].title selects the title of the first book. $.store.book[*].author selects all authors. $..price selects all price values at any depth. JSONPath is used in API testing (Postman, REST Assured), data transformation pipelines, AWS IAM policies, Kubernetes JSON patches, and observability tools for filtering JSON log data.

What is the difference between dot notation and bracket notation in JSONPath?

Both access the same values but have different capabilities. Dot notation: $.store.book.title — clean and readable, works for simple key names. Bracket notation: $.store['book']['title'] — required for keys with spaces, special characters, or numeric indices: $['my key']['0']. Bracket notation also supports expressions: $[?(@.price < 10)] (filter), $[0,2] (union), $[0:3] (slice). Mix both: $.store.book[0]['long key name'].

What are JSONPath filter expressions and how do I use them?

Filter expressions select elements that match a condition: $.store.book[?(@.price = (comparisons), && || (logical), =~ (regex match in some implementations). Examples: [?(@.category == 'fiction')] — filter by string equality; [?(@.isbn)] — filter elements that have an isbn property. Not all JSONPath implementations support all filter operators.

Is JSONPath standardized?

JSONPath was originally defined informally by Stefan Goessner in 2007. It was not an official standard until IETF RFC 9535 was published in 2024, which standardizes the syntax and semantics. Many implementations predate RFC 9535 and have minor differences — especially in filter expressions, recursive descent behavior, and how they handle edge cases. When interoperability matters, test your expressions against the specific library you will use (jsonpath-plus, Jayway for Java, jsonpath for Python).

مختبر JSONPath

Q: What are JSONPath filter expressions and how do I use them?

Filter expressions select elements that match a condition: $.store.book[?(@.price = (comparisons), && || (logical), =~ (regex match in some implementations). Examples: [?(@.category == 'fiction')] — filter by string equality; [?(@.isbn)] — filter elements that have an isbn property. Not all JSONPath implementations support all filter operators.

Q: Is JSONPath standardized?

JSONPath was originally defined informally by Stefan Goessner in 2007. It was not an official standard until IETF RFC 9535 was published in 2024, which standardizes the syntax and semantics. Many implementations predate RFC 9535 and have minor differences — especially in filter expressions, recursive descent behavior, and how they handle edge cases. When interoperability matters, test your expressions against the specific library you will use (jsonpath-plus, Jayway for Java, jsonpath for Python).

تعبير JSONPath

إدخال JSON

النتائج

Loading editor...

لم يتم العثور على نتائج

الصياغة	الوصف
$	الكائن أو المصفوفة الجذرية
@	العقدة الحالية (تُستخدم في تعبيرات التصفية)
object.property	عنصر فرعي بصيغة النقطة
['object'].['property']	عنصر فرعي أو عناصر فرعية بصيغة الأقواس
..property	الاستعراض التكراري
*	حرف بدل. يحدد جميع العناصر
[n]	يحدد العنصر رقم n من المصفوفة
[n1,n2]	يحدد عنصري المصفوفة n1 وn2 (اتحاد)
[start:end:step]	عامل شريحة المصفوفة
?(expression)	تعبير التصفية
(expression)	تعبير برمجي

التفاصيل التقنية

كيف يعمل مختبر JSONPath

ما الذي تفعله الأداة

يتيح لك مُختبِر JSONPath الاستعلام عن بيانات JSON المتداخلة باستخدام تعبيرات JSONPath، على نحوٍ مشابه لكيفية عمل XPath مع XML. يعمل هذا المُختبِر كأداة لاختبار تعبيرات JSONPath ومُحدِّد JSON، مما يساعد المطورين على استخراج قيم محددة أو مصفوفات أو كائنات من هياكل JSON المعقدة. عندما تحتاج إلى اختبار jsonpath عبر الإنترنت، تعرض هذه الأداة جميع القيم المطابقة ومساراتها. وهي تدعم صياغة JSONPath بما في ذلك ترميز النقطة ( $.store.book)، وترميز الأقواس ( $['store']['book'])، وأحرف البدل ( $..*)، وتقطيع المصفوفات، وتعبيرات التصفية. تتبع هذه الأداة دلالات jsonpath-plus؛ وتختلف تطبيقات JSONPath، لذا إذا كان تعبيرك يعمل في مكان آخر ولكن ليس هنا، فقد يكون ذلك اختلافًا في اللهجة. كما تعرض القيم المطابقة ومسارات JSONPath معًا، مما يجعل من السهل فهم كيفية تنقّل التعبيرات عبر هياكل JSON.

حالات استخدام شائعة للمطورين

يستخدم المطورون مُختبِرات JSONPath عند التعامل مع استجابات واجهات برمجة التطبيقات (API)، أو ملفات الإعدادات، أو هياكل بيانات JSON المتداخلة والمعقدة. يساعد مُختبِر تعبيرات JSONPath على استخراج حقول محددة من كائنات متداخلة بعمق، أو تصفية المصفوفات وفق شرط، أو العثور على جميع مرات ظهور مفتاح معيّن. يستخدم كثير من المطورين مُختبِرات JSONPath للاستعلام عن بيانات JSON من واجهات REST API، أو تحليل ملفات السجلات، أو التنقّل داخل كائنات إعدادات معقدة. تُعد الأداة قيّمة عند تصحيح تحويلات البيانات، والتحقق من صحة استجابات API، أو فهم مخططات JSON المعقدة. قبل تشغيل استعلامات JSONPath، قد ترغب في تنسيق JSON باستخدام منسّق JSON لتحسين قابلية القراءة. وبالنسبة لملفات الإعدادات، يمكن لأداة محول JSON ↔ YAML المساعدة في التحويل بين الصيغ. وعند فحص بيانات المصفوفات، يمكن لأداة تحويل مصفوفة JSON إلى جدول تصدير النتائج إلى صيغة جدولية لتسهيل التحليل.

تنسيقات البيانات أو أنواعها أو متغيراتها

يوفّر JSONPath عدة طرق للتنقّل داخل هياكل JSON. تدعم الأداة محدِّد الجذر ($)، ومحدِّدات الأبناء (. أو [])، ومحدِّدات الأحفاد ( ..)، وفهرسة المصفوفات ([0]، [-1])، وتقطيع المصفوفات ( [0:3]). تعبيرات JSONPath الشائعة التي يستخدمها المطورون:

$.items[*].id — استخراج جميع حقول id من مصفوفة items
$..id— العثور على جميع حقول id على أي مستوى من التداخل
$['key-with-dash'] — الوصول إلى المفاتيح التي تحتوي على أحرف خاصة
$..book[?(@.price < 10)].title — تصفية الكتب حسب السعر واستخراج العناوين

تُظهر هذه التعبيرات كيف يمكن لـ JSONPath الاستعلام عن المصفوفات المتداخلة، وتصفية الكائنات وفق شرط، واستخراج حقول محددة من هياكل معقدة.

المزالق الشائعة والحالات الطرفية

من الأخطاء الشائعة الخلط بين JSONPath والوصول إلى خصائص كائنات JavaScript، إذ يستخدم JSONPath صياغة مختلفة لتصفية المصفوفات وأحرف البدل. ومن المشكلات الأخرى فهم متى يجب استخدام ترميز النقطة مقابل ترميز الأقواس: يعمل ترميز النقطة مع المفاتيح البسيطة، لكن ترميز الأقواس مطلوب للمفاتيح التي تحتوي على أحرف خاصة أو عند استخدام التعبيرات. قد تكون فهرسة المصفوفات مربكة: فالفهارس السالبة مثل [-1] تشير إلى العنصر الأخير، لكن ليست كل تطبيقات JSONPath تدعم ذلك. يجب أن تستخدم تعبيرات التصفية معاملات المقارنة الصحيحة وأن تشير إلى العنصر الحالي باستخدام @. قد تُرجع محددات الأحفاد (..) نتائج غير متوقعة إذا طابقت عناصر أكثر مما هو مقصود. ينبغي على المطورين اختبار تعبيرات JSONPath مع هياكل JSON متنوعة، بما في ذلك الحالات الحدّية مثل المصفوفات الفارغة، وقيم null، والكائنات المتداخلة بعمق. لدى بعض تطبيقات JSONPath فروق دقيقة في كيفية التعامل مع الحالات الحدّية، لذا يُعد الاختبار أمرًا أساسيًا.

الأخطاء والتحقق

عند العمل مع JSONPath، قد تحدث عدة حالات من الأخطاء. سيؤدي إدخال JSON غير صالح إلى خطأ في التحليل قبل تقييم تعبير JSONPath. وستُرجع تعبيرات JSONPath غير الصالحة رسالة خطأ توضّح ما الخطأ في الصياغة. تُعاد النتائج الفارغة على شكل مصفوفة فارغة عندما لا يطابق التعبير أي قيم في بنية JSON—وهذا سلوك طبيعي وليس خطأ. تتحقق الأداة من صحة صياغة JSON وصياغة تعبير JSONPath معًا، وتوفر رسائل خطأ واضحة للإدخال غير الصحيح. إذا كان تعبير JSONPath صالحًا لكنه لا يُرجع نتائج، فقد لا يطابق التعبير بنية بيانات JSON لديك، أو قد لا تحتوي البيانات على الحقول المتوقعة.

متى تستخدم هذه الأداة بدلًا من الكود

استخدم مُختبِر JSONPath هذا لتطوير الاستعلامات بسرعة، أو لتصحيح التعبيرات المعقدة، أو لاستكشاف هياكل بيانات JSON. وهو مثالي لاختبار تعبيرات JSONPath قبل تنفيذها في الشيفرة، خاصة عند العمل مع واجهات API غير مألوفة أو بيانات متداخلة ومعقدة. تساعد التغذية الراجعة المرئية على تحديد سبب مطابقة التعبيرات لبيانات معينة أو عدم مطابقتها. بالنسبة لشيفرة الإنتاج، استخدم مكتبات JSONPath المدمجة في تطبيقك والتي يمكنها معالجة بيانات JSON بكفاءة. تتفوق أدوات المتصفح في التطوير التفاعلي والاستكشاف، بينما توفر الحلول المعتمدة على الشيفرة الأداء، وأمان الأنواع، والتكامل مع خطوط معالجة البيانات. بالنسبة لمجموعات البيانات الكبيرة أو التطبيقات عالية الأداء، توفر تطبيقات JSONPath الأصلية في لغة البرمجة لديك أداءً أفضل من الأدوات المعتمدة على المتصفح.