What is JSONPath and what is it used for?

JSONPath is a query language for JSON, analogous to XPath for XML. It lets you extract values from a JSON document using path expressions. $.store.book[0].title selects the title of the first book. $.store.book[*].author selects all authors. $..price selects all price values at any depth. JSONPath is used in API testing (Postman, REST Assured), data transformation pipelines, AWS IAM policies, Kubernetes JSON patches, and observability tools for filtering JSON log data.

What is the difference between dot notation and bracket notation in JSONPath?

Both access the same values but have different capabilities. Dot notation: $.store.book.title — clean and readable, works for simple key names. Bracket notation: $.store['book']['title'] — required for keys with spaces, special characters, or numeric indices: $['my key']['0']. Bracket notation also supports expressions: $[?(@.price < 10)] (filter), $[0,2] (union), $[0:3] (slice). Mix both: $.store.book[0]['long key name'].

What are JSONPath filter expressions and how do I use them?

Filter expressions select elements that match a condition: $.store.book[?(@.price = (comparisons), && || (logical), =~ (regex match in some implementations). Examples: [?(@.category == 'fiction')] — filter by string equality; [?(@.isbn)] — filter elements that have an isbn property. Not all JSONPath implementations support all filter operators.

Is JSONPath standardized?

JSONPath was originally defined informally by Stefan Goessner in 2007. It was not an official standard until IETF RFC 9535 was published in 2024, which standardizes the syntax and semantics. Many implementations predate RFC 9535 and have minor differences — especially in filter expressions, recursive descent behavior, and how they handle edge cases. When interoperability matters, test your expressions against the specific library you will use (jsonpath-plus, Jayway for Java, jsonpath for Python).

Тестер JSONPath

Q: What are JSONPath filter expressions and how do I use them?

Filter expressions select elements that match a condition: $.store.book[?(@.price = (comparisons), && || (logical), =~ (regex match in some implementations). Examples: [?(@.category == 'fiction')] — filter by string equality; [?(@.isbn)] — filter elements that have an isbn property. Not all JSONPath implementations support all filter operators.

Q: Is JSONPath standardized?

JSONPath was originally defined informally by Stefan Goessner in 2007. It was not an official standard until IETF RFC 9535 was published in 2024, which standardizes the syntax and semantics. Many implementations predate RFC 9535 and have minor differences — especially in filter expressions, recursive descent behavior, and how they handle edge cases. When interoperability matters, test your expressions against the specific library you will use (jsonpath-plus, Jayway for Java, jsonpath for Python).

Вираз JSONPath

Вхідні дані JSON

Результати

Loading editor...

Результатів не знайдено

Синтаксис	Опис
$	Кореневий об’єкт або масив
@	Поточний вузол (використовується у виразах фільтра)
object.property	Дочірній елемент у крапковій нотації
['object'].['property']	Дочірній елемент або елементи у дужковій нотації
..property	Рекурсивний обхід
*	Підстановочний символ. Вибирає всі елементи
[n]	Вибирає n-й елемент із масиву
[n1,n2]	Вибирає елементи масиву n1 і n2 (об’єднання)
[start:end:step]	Оператор зрізу масиву
?(expression)	Вираз фільтра
(expression)	Скриптовий вираз

Технічні деталі

Як працює тестер JSONPath

Що робить інструмент

Тестер JSONPath дозволяє виконувати запити до вкладених JSON-даних за допомогою виразів JSONPath, подібно до того, як XPath працює для XML. Цей тестер jsonpath працює як тестер виразів JSONPath і селектор JSON, допомагаючи розробникам витягувати конкретні значення, масиви або об’єкти зі складних JSON-структур. Коли вам потрібно протестувати jsonpath онлайн, цей інструмент показує всі відповідні значення та їхні шляхи. Він підтримує синтаксис JSONPath, зокрема крапкову нотацію ( $.store.book), дужкову нотацію ( $['store']['book']), підстановки ( $..*), зрізи масивів і вирази фільтрації. Цей інструмент дотримується семантики jsonpath-plus; реалізації JSONPath відрізняються, тож якщо ваш вираз працює в іншому місці, але не тут, це може бути різницею діалекту. Він відображає як знайдені значення, так і шляхи JSONPath, що полегшує розуміння того, як вирази навігають JSON-структурами.

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

Розробники використовують тестери JSONPath під час роботи з відповідями API, конфігураційними файлами або складними вкладеними структурами JSON-даних. Тестер виразів JSONPath допомагає витягувати конкретні поля з глибоко вкладених об’єктів, фільтрувати масиви за предикатом або знаходити всі входження певного ключа. Багато розробників використовують тестери JSONPath, щоб робити запити до JSON-даних із REST API, парсити лог-файли або навігувати складними конфігураційними об’єктами. Інструмент корисний під час налагодження перетворень даних, валідації відповідей API або розуміння складних JSON-схем. Перед виконанням запитів JSONPath ви можете відформатувати JSON за допомогою JSON Formatter для кращої читабельності. Для конфігураційних файлів інструмент JSON ↔ YAML Converter допоможе конвертувати між форматами. Під час аналізу даних масивів інструмент JSON Array to Table може експортувати результати в табличний формат для зручнішого аналізу.

Формати даних, типи або варіанти

JSONPath надає кілька способів навігації JSON-структурами. Інструмент підтримує кореневий селектор ($), дочірні селектори (. або []), селектори нащадків ( ..), індексацію масивів ([0], [-1]) і зрізи масивів ( [0:3]). Поширені вирази JSONPath, які використовують розробники:

$.items[*].id — Витягнути всі поля id з масиву items
$..id— Знайти всі поля id на будь-якому рівні вкладеності
$['key-with-dash'] — Доступ до ключів зі спеціальними символами
$..book[?(@.price < 10)].title — Відфільтрувати книги за ціною та витягнути назви

Ці вирази демонструють, як JSONPath може виконувати запити до вкладених масивів, фільтрувати об’єкти за предикатом і витягувати конкретні поля зі складних структур.

Поширені помилки та крайові випадки

Одна з поширених помилок — плутати JSONPath із доступом до властивостей об’єктів у JavaScript, адже JSONPath використовує інший синтаксис для фільтрації масивів і підстановок. Інша проблема — розуміння, коли використовувати крапкову нотацію, а коли дужкову: крапкова нотація працює для простих ключів, але дужкова потрібна для ключів зі спеціальними символами або під час використання виразів. Індексація масивів може бути підступною: від’ємні індекси на кшталт [-1] посилаються на останній елемент, але не всі реалізації JSONPath це підтримують. Вирази фільтрації мають використовувати правильні оператори порівняння та посилатися на поточний елемент через @. Селектори нащадків (..) можуть повертати неочікувані результати, якщо вони збігаються з більшою кількістю елементів, ніж задумано. Розробникам варто тестувати вирази JSONPath на різних JSON-структурах, включно з крайніми випадками, як-от порожні масиви, значення null і глибоко вкладені об’єкти. Деякі реалізації JSONPath мають тонкі відмінності в обробці крайніх випадків, тому тестування є необхідним.

Помилки та валідація

Під час роботи з JSONPath може виникати кілька типів помилок. Некоректний JSON-ввід призведе до помилки парсингу ще до оцінювання виразу JSONPath. Некоректні вирази JSONPath повернуть повідомлення про помилку із зазначенням проблеми в синтаксисі. Порожні результати повертаються як порожній масив, коли вираз не знаходить жодних значень у JSON-структурі — це нормальна поведінка, а не помилка. Інструмент валідовує як синтаксис JSON, так і синтаксис виразів JSONPath, надаючи зрозумілі повідомлення про помилки для некоректного вводу. Якщо ваш вираз JSONPath коректний, але не повертає результатів, можливо, він не відповідає структурі ваших JSON-даних або дані не містять очікуваних полів.

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

Використовуйте цей тестер JSONPath для швидкої розробки запитів, налагодження складних виразів або дослідження JSON-структур даних. Він ідеально підходить для тестування виразів JSONPath перед впровадженням у код, особливо під час роботи з незнайомими API або складними вкладеними даними. Візуальний зворотний зв’язок допомагає зрозуміти, чому вирази збігаються або не збігаються з конкретними даними. Для продакшн-коду використовуйте бібліотеки JSONPath, інтегровані у ваш застосунок, які можуть ефективно обробляти JSON-дані. Браузерні інструменти чудово підходять для інтерактивної розробки та дослідження, тоді як рішення на рівні коду забезпечують продуктивність, типобезпеку та інтеграцію з конвеєрами обробки даних. Для великих наборів даних або високопродуктивних застосунків нативні реалізації JSONPath у вашій мові програмування забезпечують кращу продуктивність, ніж браузерні інструменти.