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 Tester дозволяє писати й оцінювати вирази JSONata над JSON-даними в реальному часі. JSONata — це легка мова запитів і трансформацій для JSON, аналогічна тому, чим XPath і XSLT є для XML. Інструмент миттєво показує результат запиту під час введення, що спрощує інтерактивну розробку та налагодження складних виразів для витягування й перетворення даних.

Поширені сценарії використання для розробників

Розробники використовують тестери JSONata під час створення правил трансформації даних для потоків Node-RED, шарів оркестрації API або serverless-платформ інтеграції, які нативно підтримують 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 автоматично «сплющують» результати з одним елементом, тож вираз, який очікувано має повертати масив, може повернути скаляр, якщо збігся лише один елемент. Мова менш поширена, ніж jq або JSONPath, що може створювати труднощі з підтримкою, якщо члени команди не знайомі з її синтаксисом.

Коли використовувати цей інструмент, а коли — код

Використовуйте цей браузерний інструмент для інтерактивної розробки й тестування виразів JSONata перед розгортанням на платформах на кшталт Node-RED, AWS Step Functions або власних API. Для продакшн-використання вбудуйте npm-пакет jsonata безпосередньо у ваш Node.js-застосунок, де ви отримаєте попередню компіляцію, кешування, реєстрацію власних функцій і коректну обробку помилок, яку браузерне середовище тестування не може забезпечити.