پرش به محتوای اصلی

راهنمای آزمایشگر JSONPath و JMESPath

زمان مطالعه: ۲ دقیقه

این ابزار چیست؟

برای بیرون کشیدن بخشی از یک JSON بزرگ، مثلاً نام همه‌ی محصولاتی که قیمتشان از حدی بالاتر است، لازم نیست کد بنویسید. JSONPath و JMESPath دو زبان کوتاه پرس‌وجو برای JSON‌اند: JSONPath در ابزارهایی مثل Kubernetes و Postman و JMESPath در خط فرمان AWS و Azure به کار می‌رود.

این آزمایشگر عبارت را همان لحظه روی JSON اجرا می‌کند، نتیجه را نشان می‌دهد و برای JSONPath مسیر دقیق هر مقدار یافت‌شده را هم فهرست می‌کند. یک راهنمای سریع از نحو هر دو زبان هم کنار ابزار هست. همه‌چیز در مرورگر شما اجرا می‌شود.

گام‌به‌گام

  1. نوع پرس‌وجو را انتخاب کنید

    JSONPath یا JMESPath را بردارید؛ نحو این دو با هم فرق دارد.

  2. JSON را بچسبانید

    داده را در «JSON ورودی» بگذارید یا «نمونه‌ی JSON» را بزنید تا داده‌ی آزمایشی بیاید.

  3. عبارت را بنویسید

    در «عبارت پرس‌وجو» عبارت را بنویسید؛ نتیجه با هر تغییر به‌روز می‌شود و خطای نحوی همان‌جا نشان داده می‌شود.

  4. مسیرها را ببینید

    در «مسیرهای مطابق» مسیر کامل هر مقدار یافت‌شده می‌آید؛ برای نوشتن کد یا پیدا کردن جای دقیق داده مفید است.

نمونه‌های کاربردی

  • فیلتر در JSONPath

    عنوان کتاب‌هایی که قیمتشان بیش از ۱۰ است؛ @ به عنصری اشاره می‌کند که در حال بررسی است.

    {"store":{"book":[{"title":"A","price":8},{"title":"B","price":12},{"title":"C","price":15}]}}

    نتیجه: ["B","C"] · مسیرها: $['store']['book'][1]['title'] و $['store']['book'][2]['title']

  • همان پرس‌وجو در JMESPath

    در JMESPath عدد داخل فیلتر میان دو بک‌تیک می‌آید و $ ابتدای عبارت لازم نیست.

    {"store":{"book":[{"title":"A","price":8},{"title":"B","price":12},{"title":"C","price":15}]}}

    نتیجه: ["B","C"]

اشتباه‌های رایج

  • نوشتن عبارت JSONPath در حالت JMESPath یا برعکس: نحو این دو فرق دارد و خطای «خطا در عبارت» می‌گیرید. نوع پرس‌وجو را بررسی کنید.
  • فراموش کردن بک‌تیک دور عدد در JMESPath: price > 10 بدون بک‌تیک خطا می‌دهد؛ مقدار ثابت باید به شکل `10` نوشته شود.
  • انتظار یک مقدار به‌جای آرایه: JSONPath همیشه فهرستی از نتیجه‌ها برمی‌گرداند، حتی اگر فقط یک مورد پیدا شود.
  • شمارش از یک: شماره‌ی عنصرهای آرایه از صفر شروع می‌شود؛ book[1] دومین کتاب است.

JSONPath یا JMESPath؟

JSONPath قدیمی‌تر است و نحوی شبیه XPath دارد: $ ریشه است، .. در همه‌ی عمق‌ها می‌گردد و [?()] فیلتر می‌کند. سال‌ها پیاده‌سازی‌های مختلف رفتار کمی متفاوت داشتند تا اینکه در RFC 9535 استاندارد شد.

JMESPath از ابتدا با مشخصات دقیق و آزمون‌های رسمی ساخته شد و علاوه بر انتخاب، داده را تغییر شکل هم می‌دهد؛ مثلاً با تابع‌هایی مثل sort_by یا ساختن شیء تازه از فیلدهای انتخاب‌شده.

پرسش‌های متداول

تفاوت JSONPath و JMESPath چیست؟
JSONPath با نشانه‌ی $ شروع می‌شود و مسیرهای مطابق را هم برمی‌گرداند. JMESPath زبان تبدیل است: می‌توانید نتیجه را فیلتر، نگاشت و با تابع‌هایی مثل length و sort_by پردازش کنید.
آیا عبارت‌های فیلتر اجرای کد دلخواه هستند؟
خیر. عبارت‌ها با ارزیاب امن کتابخانه اجرا می‌شوند و eval یا Function به‌کار نمی‌رود.
داده‌ام ارسال می‌شود؟
خیر. پردازش کاملاً در مرورگر شما انجام می‌شود.

ابزارهای مرتبط