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 (--tab) و متغیرهای نامدار --arg.
موارد استفاده رایج
توسعهدهندگان از آن برای نمونهسازی فیلترها پیش از قرار دادنشان در اسکریپتهای shell، پایپلاینهای CI و تکخطیهای Kubernetes یا AWS CLI، برای کاوش پاسخهای بزرگ API و خطوط لاگ، برای تبدیل JSON به CSV با @csv، برای بازشکلدهی payload با map، group_by و reduce و برای یادگیری jq از طریق برگه تقلب داخلی با مثالهای قابل کلیک استفاده میکنند.
ورودیها، خروجیها و پرچمها
ورودی میتواند یک سند JSON یا چند سند پشتسرهم مانند NDJSON باشد؛ با Slurp در یک آرایه قرار میگیرند و با ورودی تهی خودتان آنها را از طریق input و inputs میخوانید. هر نتیجه در یک خط جداگانه چاپ میشود. خروجی خام رشتهها را بدون گیومه چاپ میکند که برای خروجی @csv، @tsv، @base64 و @uri لازم است. مقادیری که با --arg ارسال میشوند در فیلتر بهصورت $name در دسترساند و همیشه رشته هستند.
نکات احتیاطی و محدودیتها
ورودی به ۵ MB محدود است و اجرا پس از ۱۰ ثانیه متوقف میشود تا یک فیلتر بیپایان نتواند صفحه را قفل کند. اعداد با معناشناسی دقت مضاعف jq پردازش میشوند، بنابراین اعداد صحیح بزرگتر از 2^53 ممکن است دقت خود را از دست بدهند. اینجا به quote کردن shell نیازی نیست: در ترمینال فیلتر را داخل نقلقول تکی بگذارید. این playground از ماژولهای jq، وارد کردن از فایلها یا متغیرهای محیطی پشتیبانی نمیکند.