# مُنسّق GraphQL

نسّق استعلامات GraphQL وعملياته وتجزئاته ومخططاته باستخدام مُنسّق GraphQL هذا. الصق مستندًا، وستحلله الأداة باستخدام محلل GraphQL وتطبعه بتنسيق قياسي: مسافتان للإزاحة، وحقل واحد في كل سطر، وحذف الفواصل بين الحقول، وتوحيد المسافات حول الوسائط والمتغيرات. وتُعرض أخطاء الصياغة، ليحصل مطورو API على عمليات وSDL واضحة للتوثيق والمراجعة وتصحيح الأخطاء.

## الأسئلة الشائعة

### كيف يعمل مُنسّق GraphQL؟

يحلل المستند إلى شجرة صياغة GraphQL ثم يطبعه مجددًا بتنسيق قياسي. وبما أن المستند يُحلل، يُرفض GraphQL غير الصالح بدلًا من إعادة تنسيقه على نحو خاطئ.

### ما الذي يمكنني تنسيقه؟

الاستعلامات والعمليات والاشتراكات والتجزئات، إضافةً إلى تعريفات المخطط بلغة SDL، مثل كتل type وinput وenum وinterface وunion وschema. ويمكنك الجمع بين عدة تعريفات في مستند واحد.

### كيف يبدو الإخراج؟

تُزاح كل مجموعة اختيار بمسافتين، مع حقل واحد في كل سطر، وتُحذف الفواصل بين الحقول. وتُضاف مسافة بعد كل نقطتين في تعريفات الوسائط والمتغيرات، مثل user(id: $id).

### ماذا يحدث عند وجود خطأ في الصياغة؟

تتوقف الأداة وتعرض رسالة المحلل، مثل Syntax Error: Expected Name, found }. أصلح الموضع المشار إليه ثم أعد التنسيق.

### هل تُحفَظ التعليقات؟

يُبقي المُنسِّق تعليقات الهاش (#) في المواضع التي يستطيع المحلّل إرفاقها بها، مثل ما بعد قوس الإغلاق. وتُعد الأوصاف الموضوعة بين علامتي اقتباس لأنواع المخطط وحقوله جزءًا من المستند، لذا تُحفظ دائمًا.

### هل يتحقق من صحة استعلامي بمقارنته بمخطط؟

لا، فهو يتحقق من صحة البنية فقط. يحدد مخطط الخادم ما إذا كانت الحقول والوسائط موجودة، لذا استخدم عميل GraphQL أو خادمك للتحقق.

### هل يمكنني تنسيق سلسلة استعلام منسوخة من JavaScript؟

الصق مستند GraphQL فقط، من دون علامات اقتباس أو علامات تنصيص عكسية أو وسم gql يحيط به. يجب أولًا إلغاء تهريب الأحرف المهروبة في حمولة JSON.

### هل يمكنني تغيير المسافة البادئة؟

لا، يستخدم المنسّق دائمًا مسافتين ولا يوفّر خيارات. وهذا يتوافق مع التنسيق الذي تستخدمه معظم أدوات GraphQL ووثائقها.

### لماذا تُحاط النتيجة بسياج تعليمات برمجية من graphql؟

يُعاد الإخراج في كتلة تعليمات برمجية من نوع Markdown مع تحديد graphql، لذا يظهر مميزًا بالألوان في Markdown. انسخ الأسطر الواقعة بين السياجين إلى ملف .graphql.

### ما الحد الأقصى لحجم المستند؟

حتى 5 MB لكل عملية؛ تُرفض المدخلات الأكبر مع عرض رسالة. الإخراج مطابق لخيار GraphQL في منسّق التعليمات البرمجية.

إعلانك هنا؟

[راسلنا عبر البريد الإلكتروني](mailto:hi@dennn.is?subject=%D8%A7%D9%84%D8%A5%D8%B9%D9%84%D8%A7%D9%86%20%D8%B9%D9%84%D9%89%20OneClick%20Pro)

[إعلان مجموعة إضافات جاهزة للوكلاء من أجل WordPress.](https://sleekwp.com/?ref=oneclickpro)