jq Playground
| מסנן | תיאור |
|---|---|
| הצגה מעוצבת של המסמך כולו | |
| מעבר על כל איבר במערך | |
| קריאת ערך מקונן לפי נתיב | |
| שמירת האיברים התואמים לתנאי בלבד | |
| המרת כל איבר במערך | |
| רשימת המפתחות של אובייקט | |
| המרת אובייקט לזוגות מפתח/ערך | |
| קיבוץ איברים לפי שדה וספירתם | |
| מיון מערך לפי שדה | |
| ספירת איברי מערך | |
| עיצוב שורות כ-CSV (הפעילו פלט גולמי) | |
| קידוד מחרוזת ל-Base64 (הפעילו פלט גולמי) | |
| רשימת הנתיבים של כל הערכים המספריים | |
| איסוף רקורסיבי של כל המספרים | |
| סכימת ערכים באמצעות reduce | |
| קריאת כל הקלטים באמצעות קלט null (נסו כמה מסמכי JSON) |
פרטים טכניים
איך פועל jq Playground
מה עושה הכלי
jq Playground מריץ מסנני jq אמיתיים על ה-JSON שלכם תוך כדי הקלדה. jq 1.8 מהודר ל-WebAssembly ורץ ב-Web Worker, ולכן התוצאות זהות בדיוק לכלי שורת הפקודה, כולל הודעות שגיאה. הדביקו JSON, כתבו מסנן כמו .users[] | select(.age > 30) | .name, והפלט מתעדכן לאחר השהיה קצרה. האפשרויות ממופות ישירות לדגלי jq: פלט גולמי (-r), דחוס (-c), slurp (-s), קלט null (-n), מפתחות ממוינים (-S), הזחה בטאב (--tab) ומשתני --arg בעלי שם.
מקרי שימוש נפוצים
מפתחים משתמשים בו לבניית אב-טיפוס של מסננים לפני שהם נכנסים לסקריפטים של shell, לצינורות CI ולפקודות חד-שורתיות של Kubernetes או AWS CLI, כדי לחקור תגובות API גדולות ושורות לוג, להמיר JSON ל-CSV באמצעות @csv, לעצב מחדש payloads באמצעות map, group_by ו-reduce, וללמוד jq באמצעות דף העזר המובנה עם דוגמאות הניתנות ללחיצה.
קלטים, פלטים ודגלים
הקלט יכול להיות מסמך JSON יחיד או כמה מסמכים משורשרים כמו NDJSON; עם Slurp הם נארזים במערך אחד ועם קלט null אתם קוראים אותם בעצמכם באמצעות input ו-inputs. כל תוצאה מודפסת בשורה משלה. פלט גולמי מדפיס מחרוזות ללא מרכאות, וזה נדרש עבור פלט @csv, @tsv, @base64 ו-@uri. ערכים שמועברים עם --arg זמינים בתוך המסנן כ-$name והם תמיד מחרוזות.
מלכודות ומגבלות
הקלט מוגבל ל-5 MB וההרצה נעצרת לאחר 10 שניות כדי שמסנן אינסופי לא יקפיא את הדף. מספרים מעובדים בסמנטיקה של דיוק כפול של jq, ולכן מספרים שלמים מעל 2^53 עלולים לאבד דיוק. אין צורך כאן במרכאות של shell: בטרמינל עטפו את המסנן במרכאות בודדות. ה-playground הזה אינו תומך במודולים של jq, ביבוא מקבצים או במשתני סביבה.