Бесплатный тестер JSONPath онлайн

Что такое тестер JSONPath?

// The expression you build in this tester maps straight onto the
// RFC 9535 reference library used under the hood.
import { query, paths } from 'jsonpath-rfc9535';

const document = {
  store: {
    book: [
      { title: 'Sayings of the Century', author: 'Nigel Rees', price: 8.95 },
      { title: 'Sword of Honour', author: 'Evelyn Waugh', price: 12.99 },
      { title: 'Moby Dick', author: 'Herman Melville', price: 8.99 },
      { title: 'The Lord of the Rings', author: 'J. R. R. Tolkien', price: 22.99 }
    ]
  }
};

// Values: query(document, path) returns the matched values directly.
const titles = query(document, '$.store.book[*].title');
// → ['Sayings of the Century', 'Sword of Honour', 'Moby Dick', 'The Lord of the Rings']

// Filter: books cheaper than 10.
const cheap = query(document, '$.store.book[?(@.price < 10)].title');
// → ['Sayings of the Century', 'Moby Dick']

// Normalized paths: paths(document, path) returns where each match lives.
const authorPaths = paths(document, '$..author');
// → ["$['store']['book'][0]['author']", "$['store']['book'][1]['author']", ...]

// RFC 9535 functions like length() are used INSIDE filters, not as a segment.
const longTitles = query(document, '$.store.book[?length(@.title) > 15]');
// → the two books whose title is longer than 15 characters

Ключевые возможности

Разобранные примеры

$.store.book[*].title

["Sayings of the Century", "Sword of Honour", "Moby Dick", "The Lord of the Rings"]

$.store.book[?(@.price < 10)].title

["Sayings of the Century", "Moby Dick"]

$..author

["Nigel Rees", "Evelyn Waugh", "Herman Melville", "J. R. R. Tolkien"]

$.store.book[0:2].title

["Sayings of the Century", "Sword of Honour"]

$.store.book[?length(@.title) > 15]

[{"title": "Sayings of the Century", "author": "Nigel Rees", "price": 8.95}, {"title": "The Lord of the Rings", "author": "J. R. R. Tolkien", "price": 22.99}]

$.store.book[0]['title','author']

["Sayings of the Century", "Nigel Rees"]

Как пользоваться тестером JSONPath

1. 1

   Вставьте или загрузите свой JSON

   Перетащите JSON в поле ввода, вставьте его или нажмите «Загрузить», чтобы открыть файл .json / .txt с диска. «Форматировать JSON» переформатирует документ. Некорректный JSON помечается на месте сообщением парсера ещё до запроса.

2. 2

   Выберите движок

   RFC 9535 (стандарт IETF 2024 года, без eval) — по умолчанию. Переключитесь на Classic (Goessner), когда запускаете выражение, скопированное из более старого инструмента вроде jsonpath.com, чтобы результаты совпали с тем, что вы там видели.

3. 3

   Введите выражение JSONPath

   Ведущий $ показан за вас. Начните с детского пути вроде .store.book[*].title, индекса вроде [0], рекурсивного спуска вроде ..author или фильтра вроде [?(@.price < 10)]. Результаты обновляются вживую по мере ввода.

4. 4

   Переключите вид результата

   «Значения» показывает JSON-массив совпавших значений. «Пути» показывает нормализованный путь каждого совпадения вида $['store']['book'][0]['title']. «Оба» показывает их рядом, чтобы вы могли сопоставить каждое значение его точному расположению в документе.

5. 5

   Скопируйте результат или поделитесь постоянной ссылкой

   «Копировать результат» помещает вывод в буфер обмена. «Копировать ссылку» кодирует JSON, выражение, движок и вид в хеш URL (без загрузки), чтобы коллега мог воспроизвести точно тот же запрос локально на своей машине.

Частые ошибки JSONPath

store.book[*].title  →  invalid (no root)

$.store.book[*].title  →  selects every title

$.store.book[0:2]  →  first TWO books, not three

$.store.book[0:3]  →  first three books (indices 0,1,2)

Classic filter run under RFC 9535  →  parse error or unexpected nodes

Switch engine to Classic (Goessner)  →  reproduces the original result

$.store.book.length()  →  parse error (not a valid RFC 9535 segment)

$.store.book[?length(@.title) > 15]  →  books with a title over 15 chars

$.store.book[?($.price < 10)]  →  wrong scope

$.store.book[?(@.price < 10)]  →  books under 10

$[store][book]  →  invalid bracket selectors

$['store']['book']  →  same as $.store.book

$..price  →  every price anywhere in the tree

$.store.book[*].price  →  only book prices

Кто пользуется этим инструментом

Извлечение полей из ответа API

Вытаскивайте идентификаторы запросов, вложенные атрибуты ресурсов или список имён из JSON-полезной нагрузки без написания кода обхода. Постройте путь здесь на образце ответа, подтвердите в виде «Значения», что он возвращает ровно нужные узлы, затем вставьте проверенное выражение в своё приложение или тест.

Написание проверок для интеграционных тестов

Многие тестовые фреймворки и инструменты контрактного тестирования (REST Assured, Karate, Postman) используют JSONPath для проверок тел ответов. Набросайте путь проверки здесь, убедитесь, что он выбирает нужный узел на реальном ответе, и скопируйте его в свой тест — поймав неверный путь до того, как набор станет красным.

Настройка преобразований данных в конвейерах

Kubernetes, AWS Step Functions, Azure Logic Apps и многие ETL-инструменты принимают JSONPath для адресации полей в полезных нагрузках событий. Прототипируйте точный путь на репрезентативном событии здесь, подтвердите, что он разрешается, и поместите его в конфигурацию конвейера с уверенностью, что он указывает туда, куда вы задумали.

Приватное воспроизведение результата jsonpath.com

Есть выражение из серверного движка, но нельзя вставлять свои данные на сторонний сайт? Переключитесь в режим Classic (Goessner), загрузите свой JSON и воспроизведите тот же результат локально — ни одна полезная нагрузка не покидает браузер, так что проприетарные данные остаются на вашей машине.

Миграция устаревших выражений на RFC 9535

Переходите на систему, заявляющую о соответствии RFC 9535? Запустите устаревшее выражение в режиме Classic, затем переключитесь на движок RFC 9535, чтобы увидеть, разбирается ли оно по-прежнему и совпадает ли с теми же узлами. Сравнение двух движков точно указывает на отличия фильтров, объединений и функций, на которые вы иначе наткнулись бы в продакшене.

Отладка, почему путь возвращает не те узлы

Путь, который выбирает слишком много или слишком мало, трудно понять только по значениям. Переключитесь на вид «Пути», чтобы увидеть нормализованное расположение каждого совпадения — точный индекс массива, точную цепочку членов — и ошибка на единицу в срезе или случайный рекурсивный спуск сразу становятся очевидными.

Обучение или ревью JSONPath

Откройте рабочее выражение на образце данных и пройдите по нему селектор за селектором, переключаясь между «Значения» и «Пути», чтобы обучающийся видел и что выбрано, и где оно находится. Шпаргалка и разобранные примеры дают структурированный справочник для код-ревью или онбординга.

Заметки о движке и алгоритме

Движок RFC 9535 (jsonpath-rfc9535, без зависимостей)

Движок по умолчанию реализует грамматику IETF RFC 9535 напрямую: он токенизирует и разбирает выражение в абстрактное синтаксическое дерево и интерпретирует его против документа. На всём пути нет ни eval, ни конструктора Function, поэтому он невосприимчив к классу ошибок eval-инъекций и работает под строгой Content-Security-Policy.

Классический движок (jsonpath-plus, eval отключён)

Классический движок (Goessner) — это jsonpath-plus, зафиксированный на исправленном релизе (>= 10.4.0) и сконструированный с опцией eval, явно установленной в false. Это сохраняет совместимость с диалектом Goessner, закрывая при этом векторы удалённого выполнения кода, отслеживаемые как CVE-2024-21534 и CVE-2025-1302, которые затрагивали путь фильтрации библиотеки на основе eval по умолчанию.

Генерация нормализованного пути

Каждое совпадение сообщается с его нормализованным путём RFC 9535 — канонической формой в скобочной нотации с одинарными кавычками ($['store']['book'][0]['title']) и индексами массива как голыми целыми числами. Нормализованные пути стабильны и уникальны для узла, так что эквивалентные выражения дают идентичные пути, на что виды «Пути» и «Оба» опираются для однозначной идентификации результата.

Ленивая загрузка чанков движка

Оба движка загружаются как отдельные чанки JavaScript только при первом выборе, поэтому начальная страница остаётся лёгкой, а движок, который вы не используете, никогда не скачивается. Переключение движков немедленно пересчитывает текущее выражение против текущего документа без перезагрузки страницы.

Локальное чтение файлов и форматирование JSON

Кнопка «Загрузить» использует браузерный API FileReader, чтобы прочитать файл .json или .txt во ввод полностью на стороне клиента — файл никогда не передаётся. «Форматировать JSON» разбирает и пересериализует ввод с отступом в два пробела, выявляя ошибки разбора на месте, так что некорректный JSON ловится до вычисления.

Постоянные ссылки через хеш URL (никогда не передаются)

Состояние для обмена кодируется во фрагменте location.hash, неся JSON, выражение, активный движок и вид результата. Браузеры никогда не включают фрагмент в HTTP-запросы, поэтому серверы go-tools.org получают ноль данных при открытии постоянной ссылки; восстановление происходит полностью на устройстве получателя.

Лучшие практики JSONPath

Выбирайте движок под вашу цель

Если ваша целевая система заявляет о соответствии RFC 9535, пишите и проверяйте против движка RFC 9535. Если вы воспроизводите или сопровождаете выражение из более старого инструмента или библиотеки, используйте Classic (Goessner). Проверка против неверного диалекта — самая частая причина, по которой путь, работавший в тестере, отказывает в продакшене.

Проверяйте видом «Пути», а не только «Значения»

Вид «Значения» говорит, что совпало; вид «Пути» говорит, где. Когда запрос возвращает на вид правильные значения, он всё ещё может выбирать их из неверного расположения — случайный рекурсивный спуск или слишком широкая подстановка. Проверьте нормализованные пути, чтобы убедиться, что выражение попадает ровно в те узлы, которые вы задумали.

Помните о невключаемой верхней границе среза

[0:2] выбирает индексы 0 и 1, а не от 0 до 2 — верхняя граница не включается, как в Python и JavaScript. Ошибки на единицу в срезах — самый частый баг JSONPath. Используйте вид «Пути», чтобы прочитать точный индекс каждого выбранного элемента и подтвердить границу перед отправкой.

Предпочитайте явный путь рекурсивному спуску, когда можете

$..price удобен, но совпадает с каждой ценой где угодно в документе, включая те, что вы не задумывали. Когда вы знаете структуру, пропишите путь ($.store.book[*].price), чтобы запрос оставался точным и предсказуемым по мере роста данных. Оставьте .. для действительно нерегулярных или неизвестных форм.

Сохраняйте единообразие пробелов и кавычек в фильтрах

RFC 9535 в точности следует своей грамматике для выражений-фильтров, тогда как классический диалект свободнее. Пишите фильтры чисто — заключайте строковые литералы в одинарные кавычки ('fiction'), оставляйте пробелы вокруг операторов и не полагайтесь на снисходительный разбор — чтобы одно и то же выражение вычислялось одинаково независимо от того, какой движок или библиотека в итоге его запустят.

Частые вопросы