كل ما يفعله، وكل ما يمكنك ضبطه

حين يكتب الذكاء الاصطناعي الاختبارات

التغطية في مواجهة مجموعة اختبارات مُولَّدة

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

• تغطية الفروع و MC/DC، مع التلميح لكل فرع ولكل قرار، تفصل السطر نُفِّذ عن القرار جرى اختباره. المجموعة التي تسلك المسار السعيد وحده تُقرأ قرابة 100% على الأسطر وقرابة 50% على الفروع، وهذه الفجوة هي النتيجة. تشغيل اختبارات كلّه أخضر لا يُظهر منها شيئًا.
• الدرجة المركّبة هي وسط توافقي، فلا يستطيع مقياس قوي أن يحجب مقياسًا ضعيفًا — وهذا بالضبط الحساب الذي تحتاجه مجموعة مُولَّدة. أخذ متوسط رقم الأسطر مع رقم الفروع سيدفن الرقم الوحيد الجدير بالنظر.
• تحذيرات الشفرة الميتة تُنشئ مدخلًا في لوحة Problems لكل دالة لها أسطر قابلة للقياس وتغطيتها صفر. والمجموعة التي تذكر دالةً في عنوان اختبار ولا تصل إليها أبدًا لا تُخفق في أي موضع آخر.
• تغطية الفروق مقابل مرجع أساس في git تُضيّق كل ما سبق إلى الأسطر التي تغيّرت للتو — الشفرة التي قبِلتها بعد ظهر اليوم، لا متوسط عمر المستودع كله؛ فمع ذلك المتوسط تظل مجموعة كبيرة قائمة تبدو بصحة جيدة بلا عناء.
• Copy Uncovered Lines يُخرج بالضبط ما لم يُنفَّذ قط، بصيغة Markdown — أي شيء يُلصق مباشرةً في المساعد الذي كتب المجموعة أصلًا.

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

ميزة فريدة لهذا الامتداد

تغطية الأسطر لديك تقول 100%. لكن 312 بايت من ملفك الثنائي لم تُنفَّذ قط.

كل مقياس آخر هنا يُقاس من المصدر: تُجهَّز الشيفرة، ويُشغَّل البناء المجهَّز، ويُحصى ما تفعّل. أما تغطية الشيفرة الهدف فتقيس شيئًا لا تصل إليه أي أداة قائمة على المصدر — كم من الملف الثنائي المبني نُفِّذ فعليًا، ببايتات التعليمات، عبر مراقبة تدفّق التعليمات. يُصدر المترجم شيفرةً لا يقابلها أي سطر في مصدرك: فحوص حدود المصفوفات، وجداول قفز switch، وإفراغ المسجّلات، وروتينات المساعدة في زمن التشغيل للقسمة أو الفاصلة العائمة. لا يظهر شيء من ذلك في مصدرك، لذا لا تستطيع أي أداة قائمة على المصدر — بما فيها هذا الامتداد نفسه، بالنسبة لأي مقياس آخر يقرؤه — أن تخبرك إن كان قد نُفِّذ. وهي أيضًا المقياس الوحيد هنا الذي يجيب عن سؤال هل يغطي هذا لغة التجميع؟، لأن شيفرة التجميع المكتوبة يدويًا لا تُجهَّز أبدًا.

تُسمّي DO-178C ذلك صراحةً: عند المستوى A، يُطلب هذا بالإضافة إلى MC/DC. لا يقرأه أي امتداد آخر لـ VS Code. كيفية الحصول عليه من هدف مضمّن →

القدرات

الأساسيات

• عرض Coverage لكل ملف مقيس، ومسطرة النظرة العامة، وAnnotated Source؛ وفي هامش المحرر نفسه، افتراضيًا، ما يستحق علامة فحسب — أشرطة MC/DC، ومثلثات «منذ آخر تشغيل»، ونقاط الأسطر المحرَّرة — مع أشرطة على الأسطر غير المغطّاة وحدها أو خريطة حرارية لأعداد الإصابات على بُعد إعداد واحد.
• تغطية لكل سطر من العبارات والفروع والدوال والمناطق وMC/DC ونسخ C++، وفقًا لما يوفره ملف التتبع.
• استيعاب صيغ متعددة ودمج حتمي لعدة عمليات تشغيل مع تسجيل المصدر.
• إعادة تعيين المسارات — مسارات جهاز بناء CI ← مساحة العمل المحلية لديك.
• تغطية الفروقات — تُزيّن فقط الأسطر التي تغيرت مقارنة بمرجع أساسي في git.
• شارات Explorer وعنصر شريط حالة على مستوى التشغيل، ملون حسب الدرجة المركّبة.
• وضع المراقبة — إعادة تحميل تلقائية عند تغيّر ملف التتبع.
• Run Tests with Coverage — يتعرّف على مشغّل الاختبارات من جذر مساحة العمل ويشغّله مع تفعيل التغطية، محمّلًا ما يكتبه.
• ملفات التتبع البعيدة — يجوز أن يكون مدخل coverageFile.paths عنوان https://: يُجلب ملف CI الناتج جلبًا مشروطًا (ETag / Last-Modified)، بالترويسات التي تضبطها في remote.headers، ويُحمَّل كملف محلي، ويُعاد جلبه على مؤقّت عبر remote.refreshMinutes؛ وحين يفشل الجلب تُحمَّل آخر نسخة منزَّلة بدلًا منه.
• المتغيّرات في المسارات — ${workspaceFolder} و${workspaceFolderBasename} و${userHome} و${env:NAME}، ${command:id} و${config:section.key} في كل إعداد مسار؛ والمتغيّر المجهول يُترك كما كُتب، فيظهر الخطأ المطبعي في سجل الاكتشاف بدل أن يختفي.
• مساحات العمل متعددة الجذور — يُكتشف كل مجلد من إعداداته هو (ملف .vscode/settings.json الخاص به أو مدخله في .code-workspace)، وتندمج ملفات تتبعه في تشغيل واحد، ويجمّع عرض Coverage الملفات حسب المجلد، والمجلد الذي يُضاف أو يُزال يعيد تحميل التغطية من تلقاء نفسه.
• مُطلقان آخران لإعادة التحميل — مدخل coverageFile.paths المطلق خارج مساحة العمل يُستطلع، فالملف الذي يظهر هناك يُحمَّل؛ ويسمّي watch.reloadAfterTasks مهامّ (npm: test) يعيد انتهاؤها تحميل التغطية، سواء كان وضع المراقبة مفعّلًا أم لا.
• تقدّم يمكن إلغاؤه — تحميل عشرة ملفات تتبع أو أكثر، أو 8 ميغابايت أو أكثر منها، وكل Generate Full HTML Report يجريان تحت إشعار تقدّم بزر Cancel؛ والإلغاء يُبقي التشغيل السابق محمَّلًا.
• عرض Test Coverage الخاص بـ VS Code نفسه — يُنشر كل تحميل أيضًا عبر واجهة Test Coverage الخاصة بالمحرر (testCoverage.publish)، فتعرض لوحة التغطية في Test Explorer والنسب المئوية لكل ملف في Explorer ومفتاح Show Inline Coverage في المحرر الأرقام نفسها؛ وينشر Show in Test Coverage View عند الطلب ويفتح اللوحة. عندما تكون للاختبارات أسماء (TN: في lcov)، يصفّي العرض تغطية الملف حسب الاختبار.
• قاعدة إعادة تعيين مقترحة — حين يترك التحميل ملفات بلا تطابق (مسارات حاوية أو CI مقابل نسخة محلية)، يستنتج الامتداد قاعدة pathRemap التي تفسّر أكبر عدد منها، ويعرض Apply Suggested Remap في نتيجة التحميل وSuggest Path Remap Rule في لوحة الأوامر؛ ولا يُكتب شيء من دون النقرة.
• أنماط التجاهل — يُسقط fuciniCoverage.ignore (vendor/**، **/*.generated.ts) ملفات كاملة من التشغيل عند التحميل، فيَعُدّ كل عرض وبوابة وتصدير من دونها؛ وتقول نتيجة التحميل كم ملفًا وتسمّي المخرجات كلًّا منها.
• غير مقيس مقابل غير مغطّى — الملف الذي لم يحمّله أي اختبار لا يُحتسب 0% من وراء ظهرك؛ يقول شريط الحالة غير مقيس عنه، ويستطيع unmeasured.mode سرد هذه الملفات في عرض Coverage أو احتساب كلٍّ منها ملفًا غير مغطّى، مع threshold.unmeasuredFiles للتحكّم بعددها.
• ما فعله الدمج، ظاهرًا — مع تحميل عدة ملفات تتبع، يذكر كل صف ملف التقرير الذي جاءت منه أرقامه، وتُحاط الشارة بإطار حيث طغت تلك الأرقام على تقرير أقدم، ويعدّ كل صف ملف تتبع كم من ملفاته طُغي عليها أو طغت على غيرها، والنقر على صف ملف تتبع يُبرز ملفاته في الشجرة (coverageView.mergedMarks).

الدرجة المركّبة والامتثال

متوسط توافقي مرجّح واحد عبر الأسطر والفروع والدوال والمناطق وMC/DC والنسخ. نظرًا لكونه متوسطًا توافقيًا، لا يمكن إخفاء مقياس ضعيف بواسطة مقياس مثالي. تتوافق الأوزان افتراضيًا مع مستويات IEC 61508 / ISO 26262 / DO-178C، ويتم تحديد حكم COMPLIANT / NON-COMPLIANT بواسطة عتبات لكل مقياس بالإضافة إلى وضع قابل للتكوين.

Screenshot pending — add assets/img/statusbar.png (see SCREENSHOTS.md).

التحليل داخل المحرر

• CodeLens للدوال — نسبة التغطية لكل دالة، انقر للانتقال إلى أول سطر غير مغطى فيها.
• التمرير فوق الفروع وMC/DC — عدد مرات الأخذ/عدم الأخذ لكل فرع وتفصيل الشرط/المتجه لكل قرار؛ مؤشر هامش MC/DC ملوّن اختياري.
• تحذيرات الكود الميت — تحذير في لوحة Problems للدوال ذات الأسطر القابلة للقياس والتغطية الصفرية.
• تنقل Next/Previous Uncovered.
• تحذير عدم التطابق عندما لا يعود محتوى الملف ملائمًا لتشغيله — يُحدَّث مع حفظ الملفات أو تغيّرها على القرص، مع الفرق الدقيق عند التحويم.
• منذ آخر تشغيل — مثلث أحمر على كل سطر نُفِّذ في التشغيل السابق ولم يُنفَّذ في هذا، وأخضر للحالة العكسية، مع مسطرة النظرة العامة وأعداد الإصابات عند التحويم.
• المخازن المؤقتة المعدَّلة — كل علامة وتلميح وCodeLens يتحرك مع النص أثناء التحرير وينسحب من سطر أُعيدت كتابته، حيث تقول نقطة رمادية السبب.
• أوضاع هامش المحرر — يُبقي editorGutter.mode الهامش على النتائج وحدها (off)، أو يضع شريطًا على كل سطر لم يُنفَّذ قط وشريطًا كهرمانيًا حيث لم يُسلك فرع قط (uncovered)، أو يضيف ظلًّا دافئًا على كل سطر نُفِّذ، أشدّ حرارةً كلما كثر تنفيذه (heatmap)؛ ويبدّل Choose Editor Gutter Mode... من لوحة الأوامر أو قائمة شريط الحالة.
• أعداد الإصابات المضمّنة — يكتب hitCounts.inline القيمة ×12 بعد كل سطر تبدأ عنده عبارة، بما في ذلك ×0؛ ويبدّله Toggle Inline Hit Counts.
• مدخلات Problems لكل سطر — يضع problems.perLine تشخيص Information على كل كتلة من الأسطر التي لم تُنفَّذ قط في مستند مفتوح (الدالة الميتة مدخل واحد، لا أربعون)، واختياريًا على كل سطر فيه فرع لم يُسلك قط؛ وتتبع المدخلات أسطرها أثناء التحرير.
• تلوين السطر وخريطة شريط التمرير — يضع lineHighlight لونًا شبه شفاف خلف الأسطر نفسها بدلًا من علامة في الهامش (أو إضافة إليها)، ويقرّر overviewRuler بمفرده شأن الشريط في شريط التمرير: مع إيقاف الهامش تكون النتيجة خريطة لفجوات الملف ولا شيء بجوار الشفرة.
• أي ملف تتبّع غطّى هذا السطر — عند دمج عدة تقارير، تسمّي تلميحة عدد مرات التنفيذ كل تقرير غطّى السطر (بما في ذلك اسم المجموعة من سجل TN: في lcov)، والنقر على صف ملف تتبّع في عرض Coverage يضيء الأسطر التي أسهم بها.

• أحمر وكهرماني وأخضر — يلوّن وضع coverage في editorGutter.mode وlineHighlight كل سطر مَقيس بألوان سلّم الألوان؛ وينتقل زر الوضع في شريط الحالة وAlt+G من وضع إلى الذي يليه.
• ألوانك، مع معاينة — سلّم الألوان ودرجات الخريطة الحرارية (heatmap.colors وheatmap.colorsDark) إعدادات، وتعاينها صفحة الإعدادات على محرر فاتح ومحرر داكن فور اختيارها.
• من أي تقرير يأتي الملف — عندما يقيس تقريران الشفرة نفسها، تقرّر قواعد coverageFile.sources، أو Choose Coverage Source for This File...، أيّهما يعرضه كل ملف بدلًا من أن يفوز الأحدث.

التقارير والسجل

• Generate Full HTML Report — تقرير متعدد الصفحات يُنشأ ذاتيًا لكل دليل؛ وOpen Annotated Source لملف واحد.
• سجل محلي اختياري لعمليات التشغيل مع اتجاه للتغطية (▲/▼)، بالإضافة إلى Compare Two History Runs وCompare with Last Run.
• Show Worst-Covered Files / Functions وCopy Uncovered Lines (Markdown).
• Export Fucini JSON — النموذج المُطبّع الكامل.
• Export Coverage Report... — التشغيل نفسه بصيغة CSV (لكل ملف أو لكل دالة)، أو ملخّص Markdown، أو ملف تتبع LCOV، أو Cobertura XML، أو SARIF، أو شارة SVG مستقلة. بخمسة وعشرين قارئًا وهذه الكاتبات يحوّل الامتداد بين التنسيقات: حمّل JaCoCo أو llvm-cov JSON وأصدر LCOV الذي تقرأه Codecov وCoveralls وSonarQube، أو Cobertura XML الذي تستوعبه Jenkins وGitLab وAzure DevOps.
• Generate Coverage Badge — شارة SVG على طراز shields تُكتب مباشرةً في مساحة العمل (badge.outputPath، افتراضيًا coverage-badge.svg) ليضمّنها README بـ ![coverage](coverage-badge.svg) من دون خدمة مستضافة؛ يختار badge.metric الأسطر أو الفروع أو MC/DC أو الدرجة المركّبة، ويتبع اللون مستويات colorScale.*، ويعيد badge.autoUpdate كتابتها بعد كل تحميل.

Screenshot pending — add assets/img/report.png (see SCREENSHOTS.md).

Screenshot pending — add assets/img/annotated-source.png (see SCREENSHOTS.md).

Community وPro، ميزة بميزة

قائمتان، قاعدة كود واحدة. Community هو المستوى المجاني دائمًا، وهو ما تستقر عليه قائمة Pro بعد تجربتها ذات الأربعة عشر يومًا؛ أما Pro والتجربة فكل شيء دون حدود. رُسم الخط بحيث يظل المستوى المجاني يرى كل نتيجة ولا يدفع إلا مقابل الراحة والدليل والحجم — داخل VS Code يعرض Fucini Coverage: What Community Includes القائمة نفسها مع عدّادات اليوم مقابل كل حد.

يمتد الأسبوع سبعة أيام من أول استخدام افتتحه، ولا يُحتسب أي شيء يقتصر على قراءة التغطية. لست مستعدًا للاشتراك بعد؟ تصريح 7 أيام هو كل ما في عمود الخطط المدفوعة لمدة أسبوع واحد، يُدفع مرة واحدة، دون شيء يحتاج إلى إلغاء.

VS Code وVisual Studio جنبًا إلى جنب

منتج واحد، محرران، قارئ واحد: التقرير نفسه يعطي الأرقام نفسها، إلى الرقم، في كليهما. يعمل Coverage Studio لـ Visual Studio على Visual Studio 2022 و2026 — Community وProfessional وEnterprise ولا يستخدم تغطية الكود الخاصة بـ Visual Studio، التي تقتصر في 2022 على Enterprise؛ وهو مشمول في كل خطة مدفوعة، والجهاز الذي فيه المحرران هو مقعد واحد. كل ما فوق الخط موجود في كليهما؛ وتحته ما لا نظير له في Visual Studio، وما لم يأتِ بعد هناك.

مرجع الإعدادات

قم بالتكوين في واجهة الإعدادات (ابحث عن Fucini Coverage) أو في settings.json.

Download the complete settings reference — a commented settings.json holding every fuciniCoverage.* setting at the same default the packaged extension uses, ready to copy into your workspace or user settings. Regenerated from the extension on every release, so it cannot drift from what the VSIX ships.

الصف الذي ينتهي بـ لكل مجلد. يأخذ قيمة على مستوى المجلد في مساحة عمل متعددة الجذور: يُكتشف كل مجلد بملف .vscode/settings.json الخاص به أو بمدخله في .code-workspace، ويعني ${workspaceFolder} فيه ذلك المجلد.

التوطين

الاكتشاف والتحميل

مقياس الألوان والشارات

الدرجة المركّبة (المتوسط التوافقي المرجّح)

العتبات والامتثال

الفروقات وإعادة التعيين والتقارير

العرض والتحليل

السجل

إجراءات سريعة لشريط الحالة

الكل افتراضيًا false عدا الأخيرين؛ فعّل لإضافة الإجراء المطابق إلى القائمة السريعة: quickActions.compareWithLastRun، openAnnotatedSource، openAnnotatedSourceToSide، toggleAnnotatedSource، toggleWatch، worstCoveredFiles, worstCoveredFolders، worstCoveredFunctions، nextUncovered، previousUncovered، checkThresholds، copyUncoveredLines، compareHistoryRuns، exportJson، exportReport، generateBadge، showTestCoverage، chooseGutterMode، toggleInlineHitCounts.

القياس عن بُعد

التحديثات

الترخيص