Песочница jq
| Фильтр | Описание |
|---|---|
| Красиво отформатировать весь документ | |
| Перебрать каждый элемент массива | |
| Прочитать вложенное значение по пути | |
| Оставить только элементы, удовлетворяющие условию | |
| Преобразовать каждый элемент массива | |
| Вывести ключи объекта | |
| Преобразовать объект в пары ключ/значение | |
| Сгруппировать элементы по полю и подсчитать их | |
| Отсортировать массив по полю | |
| Подсчитать элементы массива | |
| Форматировать строки как CSV (включите Сырой вывод) | |
| Закодировать строку в Base64 (включите Сырой вывод) | |
| Вывести пути всех числовых значений | |
| Рекурсивно собрать все числа | |
| Просуммировать значения с помощью reduce | |
| Прочитать все входные данные с пустым вводом (попробуйте несколько JSON-документов) |
Технические детали
Как работает песочница jq
Что делает этот инструмент
Песочница jq запускает настоящие фильтры jq для вашего JSON по мере ввода. jq 1.8 скомпилирован в WebAssembly и выполняется в Web Worker, поэтому результаты точно совпадают с результатами консольной утилиты, включая сообщения об ошибках. Вставьте JSON, напишите фильтр вроде .users[] | select(.age > 30) | .name, и после короткой паузы результат обновится. Параметры соответствуют флагам jq: сырой вывод (-r), компактно (-c), slurp (-s), пустой ввод (-n), сортировка ключей (-S), отступ табуляцией (--tab) и именованные переменные --arg.
Типичные сценарии
Разработчики используют её, чтобы отрабатывать фильтры перед добавлением в shell-скрипты, CI-конвейеры и однострочники Kubernetes или AWS CLI, изучать большие ответы API и строки логов, преобразовывать JSON в CSV с помощью @csv, менять структуру данных с помощью map, group_by и reduce, а также изучать jq по встроенной шпаргалке с кликабельными примерами.
Ввод, вывод и флаги
Входными данными может быть один JSON-документ или несколько объединённых документов, например NDJSON; со Slurp они оборачиваются в один массив, а с Пустым вводом вы читаете их сами через input и inputs. Каждый результат печатается на отдельной строке. Сырой вывод печатает строки без кавычек, что нужно для вывода @csv, @tsv, @base64 и @uri. Значения, переданные через --arg, доступны в фильтре как $name и всегда являются строками.
Ловушки и ограничения
Ввод ограничен 5 МБ, а выполнение прерывается через 10 секунд, чтобы бесконечный фильтр не завесил страницу. Числа обрабатываются по семантике двойной точности jq, поэтому целые числа выше 2^53 могут потерять точность. Экранирование для оболочки здесь не нужно: в терминале заключите фильтр в одинарные кавычки. Эта песочница не поддерживает модули jq, импорт из файлов и переменные окружения.