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، ولإعادة تشكيل payloads باستخدام map وgroup_by وreduce، ولتعلّم jq عبر الورقة المرجعية المدمجة ذات الأمثلة القابلة للنقر.
المدخلات والمخرجات والأعلام
يمكن أن يكون الإدخال مستند JSON واحدًا أو عدة مستندات متتابعة مثل NDJSON؛ مع Slurp تُلَفّ في مصفوفة واحدة، ومع الإدخال الفارغ تقرؤها بنفسك عبر input وinputs. تُطبع كل نتيجة في سطر منفصل. يطبع الإخراج الخام السلاسل بدون علامات اقتباس، وهذا ضروري لمخرجات @csv و@tsv و@base64 و@uri. القيم الممررة عبر --arg متاحة داخل الفلتر باسم $name وهي دائمًا سلاسل نصية.
المزالق والحدود
الإدخال محدود بـ 5 MB ويتوقف التشغيل بعد 10 ثوانٍ حتى لا يجمّد فلتر لا نهائي الصفحة. تُعالَج الأرقام بدلالات الدقة المزدوجة في jq، لذا قد تفقد الأعداد الصحيحة التي تتجاوز 2^53 دقتها. لا حاجة هنا إلى اقتباس shell: في الطرفية ضع الفلتر بين علامتي اقتباس مفردتين. لا يدعم هذا الـ playground وحدات jq أو الاستيراد من الملفات أو متغيرات البيئة.