صياغة أوامر بروتوكول Chrome Devtools (CDP) بكفاءة باستخدام محرِّر الأوامر الجديد

بروتوكول أدوات مطوّري البرامج في Chrome (CDP) هو بروتوكول لتصحيح الأخطاء عن بُعد (API) يسمح للمطوّرين بالتواصل مع متصفّح Chrome قيد التشغيل. يستخدم "أدوات مطوري البرامج في Chrome" بروتوكول CDP لمساعدتك في فحص حالة المتصفّح والتحكّم في سلوكه وجمع معلومات تصحيح الأخطاء. يمكنك أيضًا إنشاء إضافات Chrome التي تستخدم بروتوكول CDP.

على سبيل المثال، هذا أمر CDP يدرج قاعدة جديدة مع ruleText المحدّد في ورقة أنماط مع styleSheetId معيّن، في الموضع المحدّد من خلال location.

{ 
    command: 'CSS.addRule', 
    parameters: {
        styleSheetId: '2',
        ruleText:'Example', 
        location: {
            startLine: 1,
            startColumn: 1,
            endLine: 1,
            endColumn: 1
        }
    }
}

توفّر لك علامة تبويب درج مراقبة البروتوكول طريقة لإرسال طلبات CDP وعرض جميع طلبات CDP والردود التي ترسلها أدوات مطوّري البرامج وتتلقّىها.

شريط سطر الأوامر في أسفل شاشة البروتوكول.

في السابق، كان من الصعب صياغة الأمر يدويًا، وخاصةً إذا كان الأمر يحتوي على العديد من المعلمات. لم يكن عليك فقط الانتباه إلى فتح الأقواس وعلامات الاقتباس وإغلاقها، بل كان عليك أيضًا تذكُّر معلَمات الأمر، ما سيجعلك تبحث عن مستندات CDP.

لحل هذه المشكلة، قدّمت "أدوات مطوري البرامج" محرِّرًا جديدًا لـ CDP يتمثل أهدافه الرئيسية في:

  • أوامر الإكمال التلقائي: تبسيط إدخال أوامر بروتوكول "أدوات مطوّري البرامج في Chrome" من خلال تزويدك بقائمة الأوامر المتاحة عن طريق ميزة الإكمال التلقائي.
  • الملء التلقائي لمَعلمات الأوامر: الحد من الحاجة إلى التحقق من وثائق CDP للحصول على قائمة معلمات الأوامر المتاحة.
  • تبسيط كتابة المَعلمة. ما عليك سوى ملء قيم المعلمات التي تريد إرسالها.
  • التعديل وإعادة الإرسال. تحسين سرعة النماذج الأولية من خلال جعل تعديل أمر CDP أسرع.

لنلقِ الآن نظرة على الميزات التي يوفّرها هذا المحرِّر الجديد وعلى كيفية الاستفادة منها.

ميزة الإكمال التلقائي

القائمة المنسدلة للإكمال التلقائي.

تعمل ميزة الإكمال التلقائي الآن على تشغيل شريط إدخال الأوامر. يساعدك على كتابة أسماء أوامر CDP التي يمكنك الوصول إليها. ويمكن أن يكون ذلك مفيدًا جدًا للأوامر التي لا تقبل المعلَمات.

مَعلمتا السلسلة والرقم

مع هذا المحرر الجديد، يمكنك الآن تعديل قيم المعلَمات الأساسية بسهولة. لفتح المحرِّر، انقر على الرمز فتح اللوحة اليمنى بجانب إدخال الأمر.

بعد إدخال اسم الأمر، يعرض المحرر لك المعلَمات المقابلة تلقائيًا. ولا يتعين عليك البحث عن الوثائق لمعرفة ما هي المعلمات التي تتوافق مع الأوامر. وعلاوة على ذلك، يعرض المحرر المعلّمات بترتيب معين: المعلمات الإلزامية أولاً (باللون الأحمر) والأخرى الاختيارية (باللون الأزرق).

لإضافة قيمة إلى مَعلمة اختيارية، مرِّر مؤشر الماوس فوق اسمها وانقر على الزرّ +. لإعادة ضبط المَعلمة على القيمة غير المحدّدة، انقر على الزرّ إعادة الضبط على القيمة التلقائية.

زرا "+" و"إعادة الضبط على القيمة التلقائية".

مَعلمات التعداد والمَعلمات المنطقية

عند تعديل التعداد أو المَعلمات المنطقية، ستظهر لك قائمة منسدلة توفّر مجموعة من القيم المحتملة (للتعدادات) أو خيار صحيح أو خطأ مباشر للقيم المنطقية. تقلل هذه الميزة من إمكانية كتابة قيمة خاطئة لمعلمات التعداد وتحافظ على الدقة والبساطة.

القائمتان المنسدلتان المنطقية والتعداد

مَعلمات المصفوفة

بالنسبة إلى مَعلمات الصفيفة، يمكنك إضافة قيم إلى الصفيفة يدويًا. مرِّر مؤشر الماوس فوق صف المَعلمة وانقر على الزرّ +.

زر + الذي يضيف عنصر صفيف.

لحذف عناصر الصفائف واحدًا تلو الآخر، انقر على زر السلة بجانب العناصر. يمكنك أيضًا محو جميع المعلمات من الصفيف باستخدام زر الحظر. في هذه الحالة، تتم إعادة ضبط معلَمة الصفيف على [].

الزران "حذف المَعلمة" و"إعادة الضبط على الإعدادات التلقائية".

مَعلمات الكائن

عند إدخال أمر يقبل معلَمات الكائنات، يسرد المحرر مفاتيح هذا الكائن ويمكنك تعديل قيمها مباشرةً. ويمكن استخدام هذا مع جميع أنواع المعلمات المتداخلة.

المعلمات المتداخلة.

التعرّف على الإجراءات التي ينفّذها الأمر والمَعلمات في المحرِّر

هل لم تكن متأكدًا من الغرض من المعلمة أو الأمر؟ يمكنك الآن تمرير مؤشر الماوس فوق أمر أو مَعلمة، وسيظهر لك تلميح وصفي يتضمّن رابطًا يؤدي إلى المستندات المتوفّرة على الإنترنت.

تلميح وصفي يظهر عند تمرير مؤشر الماوس فوق أحد الأوامر.

تحذير قبل إرسال معلَمات غير صحيحة

في السابق، إذا لم تكن تعرف ما إذا كانت قيمة المَعلمة من النوع الصحيح واضطررت إلى الانتظار لقراءة استجابة الخطأ، يكون هذا المحرِّر الجديد مناسبًا لك. ويعرِض لك أخطاءً في الوقت الفعلي إذا لم تتمكن المَعلمة من قبول القيمة التي أدخلتها.

رمز خطأ بجانب مَعلمة ذات قيمة غير صحيحة.

إعادة إرسال طلب

إذا كنت بحاجة إلى تعديل معلَمة الأمر التي أرسلتها للتو، لن تكون بحاجة إلى كتابتها مرة أخرى. لتعديل الأمر وإعادة إرساله، انقر بزر الماوس الأيمن على عنصر في شبكة البيانات واختَر تعديل وإعادة إرسال من القائمة المنسدلة. سيؤدي هذا تلقائيًا إلى إعادة فتح محرِّر CDP وملؤه مسبقًا بالأمر الذي حدّدته.

القائمة المنسدلة لأحد الأوامر في شبكة البيانات مع الخيار "تعديل وإعادة إرسال".

نسخ الأمر بتنسيق JSON

لنسخ أمر CDP بتنسيق JSON إلى الحافظة، انقر على رمز النسخ نسخ. في أقصى يمين شريط الأدوات. بالإضافة إلى ذلك، ضع في اعتبارك أنه إذا أدخلت أمرًا مباشرةً في شريط الإدخال، سيؤدي إلى تعبئة المحرر بسلاسة، والعكس صحيح.

الخلاصة

كان الهدف من فريق أدوات مطوّري البرامج تصميم محرِّر CDP الجديد هو تبسيط كتابة أوامر CDP. يمكن أيضًا استخدام المحرِّر الجديد لعرض المَعلمات إلى جانب الوثائق وتزويدك بطريقة أسهل لإرسال أوامر CDP.

تنزيل قنوات المعاينة

يمكنك استخدام إصدار Canary أو إصدار مطوّري البرامج أو الإصدار التجريبي من Chrome كمتصفّح تلقائي للتطوير. تتيح لك قنوات المعاينة هذه الوصول إلى أحدث ميزات "أدوات مطوري البرامج" واختبار واجهات برمجة التطبيقات المتطورة للأنظمة الأساسية على الويب والعثور على المشاكل في موقعك الإلكتروني قبل المستخدمين.

التواصل مع فريق "أدوات مطوري البرامج في Chrome"

يُرجى استخدام الخيارات التالية لمناقشة الميزات والتغييرات الجديدة في المشاركة أو أي موضوع آخر ذي صلة بـ "أدوات مطوري البرامج".

  • يمكنك إرسال اقتراحات أو ملاحظات إلينا عبر crbug.com.
  • يمكنك الإبلاغ عن مشكلة في "أدوات مطوري البرامج" باستخدام خيارات إضافية   المزيد > مساعدة > الإبلاغ عن مشاكل في "أدوات مطوري البرامج" في "أدوات مطوري البرامج".
  • يمكنك نشر تغريدة على @ChromeDevTool.
  • يمكنك إضافة تعليقات على الميزات الجديدة في فيديوهات YouTube أو نصائح حول أدوات مطوّري البرامج في فيديوهات YouTube حول الميزات الجديدة.