jq Playground
| Фільтр | Опис |
|---|---|
| Форматувати весь документ | |
| Пройти по кожному елементу масиву | |
| Прочитати вкладене значення за шляхом | |
| Залишити лише елементи, що відповідають умові | |
| Перетворити кожен елемент масиву | |
| Показати ключі об’єкта | |
| Перетворити об’єкт на пари ключ/значення | |
| Згрупувати елементи за полем і підрахувати їх | |
| Відсортувати масив за полем | |
| Підрахувати елементи масиву | |
| Форматувати рядки як CSV (увімкніть сирий вивід) | |
| Закодувати рядок у Base64 (увімкніть сирий вивід) | |
| Показати шляхи до всіх числових значень | |
| Рекурсивно зібрати всі числа | |
| Підсумувати значення за допомогою reduce | |
| Прочитати всі входи через порожній вхід (спробуйте кілька JSON-документів) |
Технічні деталі
Як працює jq Playground
Що робить інструмент
jq Playground запускає справжні фільтри 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 можуть втрачати точність. Екранування для оболонки тут не потрібне: у терміналі беріть фільтр в одинарні лапки. Цей playground не підтримує модулі jq, імпорт із файлів і змінні середовища.