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]), рекурсивный wildcard-спуск (**.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-приложение, где доступны предварительная компиляция, кэширование, регистрация пользовательских функций и корректная обработка ошибок, чего браузерная среда тестирования обеспечить не может.