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 Tester

Какво прави инструментът

JSONata Tester ви позволява да пишете и оценявате JSONata изрази спрямо JSON данни в реално време. JSONata е лек език за заявки и трансформация на JSON, аналогичен на това, което XPath и XSLT са за XML. Инструментът показва резултата от заявката мигновено, докато пишете, което улеснява разработването и дебъгването на сложни изрази за извличане и трансформация на данни интерактивно.

Често срещани случаи на употреба от разработчици

Разработчиците използват JSONata tester-и, когато изграждат правила за трансформация на данни за Node-RED потоци, слоеве за оркестрация на API или serverless интеграционни платформи, които поддържат JSONata нативно. Полезен е за прототипиране на сложни заявки, които извличат, филтрират, агрегират и преструктурират JSON данни, преди да бъдат вградени в приложен код. Екипи, които оценяват JSONata като алтернатива на jq или JSONPath, използват tester-а, за да сравняват изразителността и да научат синтаксиса.

Формати на данни, типове или варианти

JSONata поддържа навигация по пътища (account.orders.product), филтриране на масиви ([price > 100]), wildcard descent (**.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 приложение, където получавате предварителна компилация, кеширане, регистрация на персонализирани функции и коректна обработка на грешки, каквито браузърната среда за тестване не може да предостави.