JSONata is a lightweight query and transformation language for JSON data. It allows you to extract, filter, and reshape JSON using expressive path expressions, operators, and built-in functions — similar to XPath for XML.

How do I select a nested field with JSONata?

Use dot notation to navigate nested objects. For example, "Account.Name" selects the Name field inside the Account object. To select across an array of objects, simply chain the path: "Orders.Product.Price" returns all prices from every product in every order.

Can JSONata filter and transform arrays?

Yes. Use square-bracket predicates to filter: "Products[Price > 50]" returns only products with a price above 50. Use the curly-brace syntax to reshape data: "items.{ \"id\": SKU, \"cost\": Price }" maps each item to a new object shape.

What built-in functions does JSONata support?

JSONata includes over 70 built-in functions covering strings ($string, $uppercase, $join), numbers ($sum, $round, $abs), arrays ($count, $sort, $distinct), objects ($keys, $merge), and more. You can also define your own functions using the $lambda syntax.

تستر عبارت JSONata

بدون نتیجه

عبارت JSONata

داده‌های JSON

نتیجه

Loading editor...

بدون نتیجه

جزئیات فنی

تستر JSONata چگونه کار می‌کند

این ابزار چه کاری انجام می‌دهد

تستر JSONata به شما اجازه می‌دهد عبارت‌های JSONata را در لحظه روی داده‌های JSON بنویسید و ارزیابی کنید. JSONata یک زبان سبک برای پرس‌وجو و تبدیل داده‌های JSON است، مشابه نقشی که XPath و XSLT برای XML دارند. این ابزار نتیجهٔ پرس‌وجو را هنگام تایپ فوراً نمایش می‌دهد و توسعه و دیباگ تعاملیِ عبارت‌های پیچیدهٔ استخراج و تبدیل داده را آسان می‌کند.

موارد استفادهٔ رایج برای توسعه‌دهندگان

توسعه‌دهندگان هنگام ساخت قوانین تبدیل داده برای جریان‌های Node-RED، لایه‌های ارکستراسیون API، یا پلتفرم‌های یکپارچه‌سازی serverless که به‌صورت بومی از JSONata پشتیبانی می‌کنند از تسترهای JSONata استفاده می‌کنند. این ابزار برای نمونه‌سازی سریع پرس‌وجوهای پیچیده‌ای که داده‌های JSON را استخراج، فیلتر، تجمیع و بازشکل‌دهی می‌کنند پیش از جاسازی در کد برنامه مفید است. تیم‌هایی که JSONata را به‌عنوان جایگزینی برای jq یا JSONPath ارزیابی می‌کنند از تستر برای مقایسهٔ قدرت بیان و یادگیری نحو استفاده می‌کنند.

قالب‌ها، نوع‌ها یا گونه‌های داده

JSONata از پیمایش مسیر (account.orders.product)، فیلتر کردن آرایه ([price > 100])، نزول با وایلدکارد (**.name)، دستکاری رشته ($substring, $join)، تجمیع عددی ($sum, $average)، عبارت‌های شرطی، توابع تعریف‌شده توسط کاربر ($myFunc := function)، مرتب‌سازی ($sort)، گروه‌بندی و تطبیق regex پشتیبانی می‌کند. برخلاف JSONPath، JSONata می‌تواند ساختار داده را تبدیل کند — نه فقط گره‌ها را انتخاب کند — بنابراین یک زبان کاملِ پرس‌وجو و تبدیل است، نه یک زبان صرفاً پرس‌وجو.

دام‌های رایج و حالت‌های لبه‌ای

JSONata وقتی مسیری تطبیق پیدا نمی‌کند به‌جای خطا مقدار undefined برمی‌گرداند (که به‌صورت «بدون خروجی» نمایش داده می‌شود) و این می‌تواند دیباگ کردن شکست‌های بی‌صدا را دشوار کند. عملیات آرایه در JSONata نتایج تک‌عنصری را به‌صورت خودکار تخت (auto-flatten) می‌کند، بنابراین عبارتی که انتظار می‌رود آرایه برگرداند ممکن است وقتی فقط یک عنصر تطبیق دارد یک مقدار اسکالر برگرداند. این زبان نسبت به jq یا JSONPath کمتر شناخته‌شده است و اگر اعضای تیم با نحو آن آشنا نباشند می‌تواند چالش‌های نگهداشت ایجاد کند.

چه زمانی از این ابزار استفاده کنیم در برابر کُد

از این ابزار مرورگری برای توسعه و تست تعاملی عبارت‌های JSONata پیش از استقرار آن‌ها روی پلتفرم‌هایی مانند Node-RED، AWS Step Functions، یا APIهای سفارشی استفاده کنید. برای استفاده در محیط تولید، بستهٔ npmِ jsonata را مستقیماً در برنامهٔ Node.js خود جاسازی کنید تا از پیش‌کامپایل، کشینگ، ثبت تابع‌های سفارشی و مدیریت خطای درست بهره‌مند شوید؛ قابلیت‌هایی که یک محیط تست مرورگری نمی‌تواند فراهم کند.