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

Hadrien Jaubert

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

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

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

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

شريط سطر الأوامر في أسفل "مراقب البروتوكول"

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

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

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

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

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

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

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

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

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

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

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

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

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

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

القائمتان المنسدلتان للقيم المنطقية والعناصر المحدَّدة

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

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

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

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

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

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

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

المَعلمات المُدمَجة

التعرّف على وظيفة الأوامر والمَعلمات في المحرِّر

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

التلميح الوصفي الذي يظهر عند تمرير مؤشر الماوس فوق طلب

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

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

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

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

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

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

نسخ أمر إلى تنسيق JSON

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

الخاتمة

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

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

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

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

استخدِم الخيارات التالية لمناقشة الميزات الجديدة أو التحديثات أو أي شيء آخر مرتبط بـ "أدوات مطوّري البرامج".