كونسول السكربت ومعاينة المخرجات
يعرض الكونسول سجلّ آخر تشغيل مع عدّادات أخطائه وتحذيراته، وتعرض المعاينة رسومًا تخطيطية للمخرجات التي أنتجها التشغيل، تحت الشفرة التي أنتجتها مباشرةً.
Senzoukria · التوثيق · آخر تحديث: سبتمبر 2026
أين تجده
- الموضع
- صفحة البرمجة النصية ← تحت المحرّر
- عنوان الكونسول
- «Output»، ظاهر دائمًا — وليس مشروطًا أبدًا
- العدّادات
- مجموع الأسطر، إضافةً إلى عدّادَي أخطاء وتحذيرات منفصلَين حين توجد
- سطر الخطأ
- يُعرض بصيغة L<line> في رأس الكونسول ويُبرَز في هامش المحرّر
- شموع المعاينة
- اصطناعية، بلا تدريج، ومعيَّرة لكل مخرَج على حدة
ما الذي يفعله
يطبع الكونسول سجلّ آخر تشغيل، سطرًا مرقَّمًا لكل مدخل، ممرَّرًا إلى الأحدث. ويحمل رأسه ملخّص التشغيل — المدّة، وعدد المخرجات، أو الخطأ — فيُجاب عن سؤال «ماذا فعل هذا التشغيل» في مكان واحد. وزرّ Clear يفرّغه؛ وهو معطَّل ما دام تشغيل جاريًا أو حين لا يوجد شيء ليُمسح.
ويُفرَّق بين الفارغ وبين ما لم يُشغَّل قطّ، ويُكتب نصّ الحالة الفارغة بلغة السكربت: فيُقال لـ Python استعمل print()، ويُقال لـ JavaScript استعمل log() أو console.log().
وتحت الكونسول، يُرسم تخطيطيًّا كل مخرَج أعاده التشغيل. ولا يُحسب شيء جديد: فهذه المخرجات نفسها، مرسومة. وكلٌّ مسمًّى بشكله — line أو histogram أو markers — بالكلمة التي يستعملها عمود المرجع بالضبط.
ماذا تعني كل حالة
| الحالة | الافتراضي | ما الذي يغيّره |
|---|---|---|
| لم يُشغَّل قطّ | الحال الابتدائية | يدعو الكونسول إلى تشغيل ويسمّي دالّة التتبّع للغة السكربت. |
| اشتغل، بلا أسطر سجلّ | — | نُفِّذ السكربت ولم يطبع شيئًا؛ والرسالة تقول ذلك بدل أن يبدو معطَّلًا. |
| اشتغل، ورُسمت المخرجات | — | رسم تخطيطي واحد لكل مخرَج، مسمًّى بشكله. |
| اشتغل، ولم يُرسم شيء | — | يبلّغ التشغيل بأن السكربت اشتغل بلا خطأ ولم يرسم شيئًا — تحقّق من أن القيم المعادة أعداد. |
| قيمة معادة غير معروفة | — | القيمة المعادة ليست سلسلة ولا خطوطًا ولا علامات؛ وعمود المرجع في «Indicator: what to return» يسرد الأشكال المقبولة. |
| أخفق | — | يعرض الرأس L<line> قبل الرسالة، ويُبرز المحرّر ذلك السطر. |
كيف يُعثر على السطر المخفِق
خطأ الصياغة الآتي من محرّك JavaScript لا يحمل موضعًا. وبدل التخمين في الحروف المريبة — وهي طريقة اتّهمت ذات مرّة شَرطةً بريئة تمامًا داخل تعليق — يُقاس السطر المخفِق: فتُترجَم الشفرة بادئةً بعد بادئة، وتُغلَق كل بادئة أولًا لتصير تامّة صياغيًّا، ويكون أول سطر تُنتج إضافتُه خطأً حقيقيًّا هو السطر المبلَّغ عنه.
وهذا يكلّف ترجمةً واحدة لكل سطر، ولا يقع إلا بعد وقوع خطأ فعلًا، فلا يُدفع شيء على المسار العادي.
الحدود والمزالق
- الرسوم التخطيطية ليست معاينة رسم بياني: فلا محور ولا مقياس ولا قيمة مقروءة، وكل مخرَج معيَّر على سعته وحده، فرسمان متجاوران لا يقارَنان.
- والفجوات ترفع القلم، تمامًا كما يفعل راسم الرسم — فإحماء متوسّط متحرّك يظهر بدايةً ناقصة، لا خطًّا مستقيمًا عبر العدم.
- والسلسلة تحتاج نقطتين منتهيتين على الأقل لتُظهر شكلًا؛ ونقطة واحدة لا ترسم قطعة.
- وارتفاع الكونسول محدود وهو يتمرّر بنفسه، فلا يدفع سكربت كثير الكلام المحرّرَ خارج الشاشة أبدًا.
صفحات ذات صلة
هذه الصفحة بلغات أخرى
أسئلة شائعة
- يقول الكونسول «No output» لكنّ سكربتي يعمل. لماذا؟
- تلك الرسالة عن السجلّ، لا عن الرسم. فهي تعني أن السكربت لم يطبع شيئًا. وإن كانت الرسوم التخطيطية تحته فارغة أيضًا، فالسكربت لم يُعِد أي مخرَج.
- لماذا يشير الخطأ إلى سطر لا أراه؟
- يحدث ذلك حين تناقض اللغة المعلَنة الشفرة، لأن غلافًا باللغة الأخرى يُلحَق بمصدرك. وخطوة Check في الشريط تشير إلى ذلك وتعرض تبديل اللغة.
- هل تخبرني الرسوم التخطيطية بأن مؤشري صحيح؟
- لا. فهي تخبرك إن كان فارغًا أو مسطَّحًا أو مثقوبًا أو بالشكل الذي توقّعته، على شموع اصطناعية. أما الحكم على سوق فينتمي إلى إعادة التشغيل والاختبار الرجعي، وهما يستعملان بيانات حقيقية.