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]refer to the last element, but not all JSONPath implementations support this. Filtering expressions must use the correct comparison operators and reference the current item with @. Descendant selectors (..) can return unexpected results if they match more elements than intended. Developers should test JSONPath expressions with various JSON structures, including edge cases like empty arrays, null values, and deeply nested objects. Some JSONPath implementations have subtle differences in how they handle edge cases, so testing is essential.

Ошибки и валидация

При работе с JSONPath может возникать несколько типов ошибок. Некорректный JSON на входе приведёт к ошибке парсинга ещё до вычисления выражения JSONPath. Некорректные выражения JSONPath вернут сообщение об ошибке, указывающее, что не так с синтаксисом. Пустые результаты возвращаются в виде пустого массива, когда выражение не соответствует ни одному значению в JSON-структуре — это нормальное поведение, а не ошибка. Инструмент валидирует как синтаксис JSON, так и синтаксис выражений JSONPath, предоставляя понятные сообщения об ошибках для некорректного ввода. Если ваше выражение JSONPath корректно, но не возвращает результатов, возможно, выражение не соответствует структуре ваших JSON-данных или данные не содержат ожидаемых полей.

Когда использовать этот инструмент, а когда — код

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