تنسيق الرسائل وتنسيقها في وحدة التحكّم

Jecelyn Yeen

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

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

تنسيق رسائل وحدة التحكّم

يمكنك استخدام محددات التنسيق لتنسيق رسائل وحدة التحكم.

تبدأ محددات التنسيق بحرف نسبة مئوية (%) وتنتهي بـ "كتابة حرف" الذي يشير إلى نوع البيانات (عدد صحيح، عدد عائم، إلخ.).

على سبيل المثال،

1. فتح وحدة التحكّم

2. أدخِل أمر وحدة التحكّم التالي.

   const tools = 'Chrome DevTools';
   console.warn('%s is awesome.', tools);
   

3. يؤدي الأمر أعلاه إلى إنشاء رسالة Chrome DevTools is awesome..

في ما يلي قائمة بمحدِّدات التنسيق التي تتوافق مع "أدوات مطوري البرامج في Chrome" حاليًا.

تطبيق محددات تنسيقات متعددة

يمكنك استخدام أكثر من محدد تنسيق واحد في الرسالة.

1. أدخِل أمر وحدة التحكّم التالي.

   console.info('The total weight of %i %s and %d %s is %f grams.', 3, 'apples', 2, 'oranges', 432.4);
   

2. يؤدي الأمر أعلاه إلى إنشاء رسالة The total weight of 3 apples and 2 oranges is 432.4 grams..

فهم الإحالات الناجحة للأنواع

سيتم تحويل رسالة الإخراج وفقًا لمحدِّد التنسيق.

1. أدخِل أمر وحدة التحكّم التالي.

   console.log('I have %i apples and %d oranges.', 2, 3.5); 
   

2. يؤدي الأمر أعلاه إلى إنشاء رسالة I have 2 apples and 3 oranges..

3. بدلاً من تسجيل 3.5 oranges، يكون الناتج 3 oranges. وتشير القيمة %d إلى أنّه يجب/سيتم تحويل القيمة إلى عدد صحيح.

في ما يلي مثال على ما يحدث إذا كان نوع الإحالة الناجحة غير صالح.

1. أدخِل أمر وحدة التحكّم التالي.

   console.log('Jane has %i kiwis.', 'two');
   

2. يؤدي الأمر أعلاه إلى إنشاء رسالة Jane has NaN kiwis..

3. وتشير %i إلى أنّه يجب/سيتم تحويل القيمة إلى عدد صحيح، ولكن الوسيطة هي سلسلة. وبالتالي، تعرض NaN (Not-A-Number).

رسائل وحدة التحكّم بالأنماط

هناك طريقتان لتحديد نمط رسائل وحدة التحكّم في "أدوات مطوّري البرامج".

اختيار النمط باستخدام محدد التنسيق

يمكنك استخدام محدد التنسيق %c لتصميم رسائل وحدة التحكم باستخدام CSS.

1. أدخِل أمر وحدة التحكّم التالي.

   const style = 'background-color: darkblue; color: white; font-style: italic; border: 5px solid hotpink; font-size: 2em;'
   console.log("%cHooray", style);
   

2. ينتج عن الأمر أعلاه Hooray مع تطبيق أنماط CSS.

استخدام تسلسلات الهروب من المعهد الأمريكي للمعايير الوطنية (ANSI)

ويمكنك استخدام تسلسلات إلغاء ANSI لتصميم رسائل وحدة التحكُّم.

من الشائع أن يتلوين مطورو Node.js رسائل السجل عبر تسلسلات إلغاء ANSI، وغالبًا ما يكون ذلك بمساعدة بعض مكتبات الأنماط مثل الطباشير والألوان والألوان الزهرية والكلور.

ومع ذلك، يمكنك تصميم الرسالة باستخدام تسلسلات إلغاء ANSI بدون استخدام أي مكتبات. إليك بناء الجملة:

\x1B[𝘗1;…;𝘗nm

أين،

• من 𝘗1 إلى 𝘗n هي تسلسلات فرعية صالحة لمَعلمات SGR (اختيار عرض الرسومات).
• يمكن حذف أي من المعلَمات من 𝘗1 إلى 𝘗n، وفي هذه الحالة يُفترض أن تكون قيمتها صفرًا.
• \x1B[m هو اختصار للرمز \x1B[0m، والذي ستتم إعادة ضبط سمة العرض فيه.

على سبيل المثال،

1. أدخِل أمر وحدة التحكّم التالي.

   console.log('\x1B[41;93;4mHello\x1B[m');
   

2. ينتج عن الأمر أعلاه رسالة Hello بخلفية حمراء ونص أصفر ومسطرة.

في ما يلي قائمة برموز الألوان المتاحة في "أدوات مطوّري البرامج".

في ما يلي قائمة برموز النمط المتوافقة في "أدوات مطوري البرامج".

في ما يلي مثال آخر أكثر تعقيدًا يتضمّن أنماطًا متعددة.

1. أدخِل أمر وحدة التحكّم التالي.

   const hello = '\x1B[41;93;4mHello';
   const space = '\x1B[m ';
   const world = '\x1B[34;102;9mWorld';
   
   console.log(hello + space + world);
   

2. ينتج عن الأمر أعلاه رسالة Hello World بـ 3 أنماط مختلفة.