Alles wat het doet, alles wat je kunt afstemmen

Als een AI de tests schreef

Coverage tegenover een gegenereerde testsuite

Het overzicht maakt het algemene punt. Hier staat het tegenover de functielijst zelf, want een gegenereerde suite faalt in een herkenbare vorm — elke regel aangeraakt, de helft van de beslissingen nooit genomen, en een paar functies die in de testtitels staan maar nooit worden aangeroepen — en vijf van de dingen hieronder maken juist die vorm zichtbaar.

• Branch- en MC/DC-dekking, met de hover per tak en per beslissing, scheiden de regel liep van de beslissing is uitgeoefend. Een suite die alleen het gelukkige pad loopt leest bijna 100% op regels en bijna 50% op branches, en juist dat verschil is de bevinding. Een groene testrun laat er niets van zien.
• De samengestelde score is een harmonisch gemiddelde, zodat een sterke metriek een zwakke niet kan maskeren — precies de rekenkunde die een gegenereerde suite nodig heeft. Het regelgetal met het branchgetal middelen zou juist het ene getal begraven dat de moeite waard is.
• Dode-code-waarschuwingen zetten een melding in het Problems-paneel voor elke functie met meetbare regels en nul dekking. Een suite die een functie in een testtitel noemt en er nooit komt, faalt nergens anders.
• Diff-dekking tegen een git-basisref versmalt al het bovenstaande tot de regels die net zijn veranderd — de code die je vanmiddag hebt geaccepteerd, in plaats van het levenslange gemiddelde van de repository, waarmee een grote bestaande suite er vrolijk gezond uit blijft zien.
• Copy Uncovered Lines geeft precies wat nooit is uitgevoerd, als Markdown — een plak-actie rechtstreeks terug naar de assistent die de suite in de eerste plaats schreef.

Niets hiervan leest een test en velt er een oordeel over, en niets hier moet worden opgevat als die claim: een test met helemaal geen assertions dekt nog steeds elke regel die hij aanraakt. Wat deze dingen meten is het deel dat een reviewer niet in zijn hoofd kan houden — welke code nooit is uitgevoerd.

Uniek voor deze extensie

Je regeldekking zegt 100%. 312 bytes van je binary hebben nooit gedraaid.

Elke andere metriek hier wordt uit de bron gemeten: instrumenteer de code, draai de geïnstrumenteerde build, tel wat afging. Objectcode-dekking meet iets waar geen brongebaseerd hulpmiddel bij kan — hoeveel van de gebouwde binary daadwerkelijk heeft gedraaid, in instructiebytes, door de instructiestroom te observeren. Een compiler stoot code uit die door geen enkele regel van je bron wordt verantwoord: array-grenscontroles, switch-sprongtabellen, registerspills, runtime-hulproutines voor deling of drijvende komma. Niets daarvan verschijnt in je bron, dus geen brongebaseerd hulpmiddel — inclusief deze extensie zelf, voor elke andere metriek die ze leest — kan je zeggen of het draaide. Het is ook de enige metriek hier die de vraag dekt dit assembly? beantwoordt, aangezien handgeschreven assembly nooit wordt geïnstrumenteerd.

DO-178C benoemt dit expliciet: op niveau A is het vereist naast MC/DC. Geen andere VS Code-extensie leest het. Hoe je dit van een embedded target krijgt →

Mogelijkheden

Kern

• Een Coverage-weergave van elk gemeten bestand, de overzichtsliniaal en Annotated Source; in de eigen gutter van de editor standaard alleen wat een markering waard is — MC/DC-balken, driehoeken sinds de vorige run, stippen op bewerkte regels — met balken op alleen ongedekte regels of een heatmap van trefferaantallen op één instelling afstand.
• Dekking per regel voor statements, branches, functies, regio's, MC/DC en C++-instantiaties, afhankelijk van wat het tracefile levert.
• Inlezen van meerdere formaten en deterministisch samenvoegen van meerdere runs met vastgelegde herkomst.
• Padherschrijving — paden van de CI-buildmachine → je lokale werkruimte.
• Diff-dekking — markeert alleen regels die zijn gewijzigd ten opzichte van een git-basisreferentie.
• Explorer-badges en een statusbalk-item voor de hele run, met kleurcodering op basis van de samengestelde score.
• Watch-modus — automatisch opnieuw laden wanneer een tracefile wijzigt.
• Run Tests with Coverage — herkent de testrunner aan de werkruimtemap en draait hem met dekking aan, en laadt wat hij schrijft.
• Externe tracefiles — een item in coverageFile.paths mag een https://-URL zijn: het CI-artefact wordt conditioneel opgehaald (ETag / Last-Modified), met de headers die je in remote.headers instelt, geladen als een lokaal bestand, en op een timer opnieuw opgehaald met remote.refreshMinutes; wanneer het ophalen mislukt, wordt in plaats daarvan de laatst gedownloade kopie geladen.
• Variabelen in paden — ${workspaceFolder}, ${workspaceFolderBasename}, ${userHome}, ${env:NAME}, ${command:id} en ${config:section.key} in elke padinstelling; een onbekende variabele blijft staan zoals geschreven, zodat een typfout in het detectielog verschijnt in plaats van te verdwijnen.
• Multi-root-werkruimten — elke map wordt gedetecteerd vanuit haar eigen instellingen (haar .vscode/settings.json of haar item in het .code-workspace), haar tracefiles worden tot één run samengevoegd, de Coverage-weergave groepeert de bestanden per map, en een toegevoegde of verwijderde map laadt de dekking vanzelf opnieuw.
• Twee extra herlaadtriggers — een absoluut item in coverageFile.paths buiten de werkruimte wordt gepeild, zodat een bestand dat daar verschijnt wordt geladen; en watch.reloadAfterTasks noemt taken (npm: test) waarvan het einde de dekking opnieuw laadt, of de watch-modus nu aanstaat of niet.
• Voortgang die je kunt annuleren — een lading van tien of meer tracefiles, of van 8 MB of meer, en elke Generate Full HTML Report draaien onder een voortgangsmelding met een knop Annuleren; annuleren laat de vorige run geladen.
• De eigen Test Coverage-weergave van VS Code — elke lading wordt ook gepubliceerd via de Test Coverage-API van de editor (testCoverage.publish), zodat het dekkingspaneel van de Test Explorer, de percentages per bestand in de Verkenner en de eigen schakelaar Show Inline Coverage van de editor dezelfde cijfers tonen; Show in Test Coverage View publiceert op verzoek en opent het paneel. Met benoemde tests (TN: in lcov) filtert de weergave de dekking van een bestand per test.
• Voorgestelde herschrijfregel — wanneer een lading bestanden zonder overeenkomst achterlaat (container- of CI-paden tegenover een lokale checkout), leidt de extensie de pathRemap-regel af die de meeste ervan verklaart, en biedt Apply Suggested Remap aan op het laadresultaat en Suggest Path Remap Rule in het palet; zonder de klik wordt er niets geschreven.
• Ignore-globs — fuciniCoverage.ignore (vendor/**, **/*.generated.ts) laat hele bestanden bij het laden uit de run vallen, zodat elke weergave, poort en export zonder ze telt; het laadresultaat zegt hoeveel en de uitvoer noemt ze elk.
• Ongemeten tegenover ongedekt — een bestand dat geen test heeft geladen wordt niet achter je rug als 0% gescoord; de statusbalk zegt not measured voor zo’n bestand, en unmeasured.mode kan zulke bestanden in de Coverage-weergave opsommen of elk als een ongedekt bestand meetellen, met threshold.unmeasuredFiles om te bewaken hoeveel het er zijn.
• Zichtbaar wat het samenvoegen heeft gedaan — met meerdere tracefiles geladen noemt elke bestandsrij het rapport waaruit haar cijfers komen, is de badge omrand waar die cijfers een ouder rapport hebben overstemd, telt elke tracefile-rij hoeveel van haar bestanden zijn overstemd of andere hebben overstemd, en licht een klik op een tracefile-rij haar bestanden in de boom op (coverageView.mergedMarks).

Samengestelde score en compliance

Eén enkel gewogen harmonisch gemiddelde over regels, branches, functies, regio's, MC/DC en instantiaties. Omdat het een harmonisch gemiddelde is, kan een zwakke metriek niet worden gemaskeerd door een perfecte. De gewichten zijn standaard afgestemd op niveaus volgens IEC 61508 / ISO 26262 / DO-178C, en het oordeel COMPLIANT / NON-COMPLIANT wordt bepaald door drempelwaarden per metriek plus een instelbare modus.

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

Analyse in de editor

• Function CodeLens — dekkingspercentage per functie, klik om naar de eerste niet-gedekte regel te springen.
• Branch- en MC/DC-hover — aantallen genomen/niet-genomen per tak en conditie-/vectoroverzichten per beslissing; optionele gekleurde MC/DC-marge in de gutter.
• Waarschuwingen voor dode code — waarschuwing in het Problems-paneel voor functies met meetbare regels en nul dekking.
• Navigatie Next/Previous Uncovered (volgende/vorige niet-gedekte regel).
• Afwijkingswaarschuwing wanneer de inhoud van een bestand niet meer past bij zijn run — bijgehouden terwijl bestanden worden opgeslagen of op schijf veranderen, met het exacte verschil bij aanwijzen.
• Sinds de vorige run — een rode driehoek op elke regel die in de vorige run werd uitgevoerd en in deze niet, een groene voor het omgekeerde, met de overzichtsliniaal en de raakaantallen bij aanwijzen.
• Bewerkte buffers — elke markering, hover en CodeLens beweegt mee met de tekst terwijl je bewerkt, en verdwijnt van een herschreven regel, waar een grijs puntje zegt waarom.
• Guttermodi in de editor — editorGutter.mode houdt de gutter bij bevindingen (off), zet een balk op elke regel die nooit liep en een amberkleurige waar een tak nooit is genomen (uncovered), of voegt een warme tint toe op elke uitgevoerde regel, heter naarmate hij vaker liep (heatmap); Choose Editor Gutter Mode... schakelt vanuit het palet of het statusbalkmenu.
• Inline trefferaantallen — hitCounts.inline schrijft ×12 achter elke regel waarop een statement begint, ×0 inbegrepen; Toggle Inline Hit Counts schakelt het om.
• Problems-items per regel — problems.perLine zet een Information-diagnose op elk blok regels dat nooit liep in een open document (een dode functie is één item, niet veertig), en optioneel op elke regel met een tak die nooit is genomen; de items volgen hun regels terwijl je bewerkt.
• Regelkleur en kaart in de schuifbalk — lineHighlight legt een doorschijnende kleur achter de regels zelf in plaats van (of naast) een teken in de gutter, en overviewRuler beslist zelf over het streepje in de schuifbalk: met de gutter uit is dat een kaart van de gaten in het bestand langs de schuifbalk en verder niets naast de code.
• Welk tracefile dekte deze regel — met meerdere samengevoegde rapporten noemt de tooltip met het trefferaantal elk rapport dat de regel dekte (inclusief de suitenaam uit TN: in lcov), en een klik op een tracefile-rij in het Coverage-paneel licht de regels op die het bijdroeg.

• Rood, amber en groen — de modus coverage van editorGutter.mode en lineHighlight kleurt elke gemeten regel in de kleuren van de kleurschaal; de modusknop in de statusbalk en Alt+G gaan van de ene modus naar de volgende.
• Je eigen kleuren, met voorbeeld — de kleurschaal en de tinten van de heatmap (heatmap.colors, heatmap.colorsDark) zijn instellingen, en de instellingenpagina toont ze op een lichte en een donkere editor terwijl je ze kiest.
• Uit welk rapport een bestand komt — met twee rapporten die dezelfde code meten, bepalen regels in coverageFile.sources, of Choose Coverage Source for This File..., welk rapport elk bestand toont, in plaats van dat het nieuwste wint.

Rapportage en geschiedenis

• Generate Full HTML Report — een zelf gerenderd, meerpagina's rapport per map; Open Annotated Source voor een enkel bestand.
• Optionele lokale rungeschiedenis met een dekkingstrend (▲/▼), plus Compare Two History Runs en Compare with Last Run.
• Show Worst-Covered Files / Functions en Copy Uncovered Lines (Markdown).
• Export Fucini JSON — het volledige genormaliseerde model.
• Export Coverage Report... — dezelfde uitvoering als CSV (per bestand of per functie), een Markdown-samenvatting, een LCOV-tracebestand, Cobertura-XML, SARIF, of een zelfstandige SVG-badge. Met vijfentwintig lezers en deze schrijvers converteert de extensie tussen formaten: laad JaCoCo of llvm-cov JSON en schrijf de LCOV weg die Codecov, Coveralls en SonarQube lezen, of de Cobertura-XML die Jenkins, GitLab en Azure DevOps inlezen.
• Generate Coverage Badge — een SVG in shields-stijl, rechtstreeks naar de werkruimte geschreven (badge.outputPath, standaard coverage-badge.svg), zodat een README hem kan insluiten met ![coverage](coverage-badge.svg) en zonder gehoste dienst; badge.metric kiest regels, takken, MC/DC of de samengestelde score, de kleur volgt de colorScale.*-niveaus, en badge.autoUpdate schrijft hem na elke lading opnieuw.

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

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

Community en Pro, functie voor functie

Twee vermeldingen, één codebase. Community is de permanent gratis laag, en waar de Pro-vermelding na haar proefperiode van 14 dagen op uitkomt; Pro en de proefperiode zijn alles, onbeperkt. De grens is zo getrokken dat de gratis laag elke bevinding altijd ziet en alleen betaalt voor gemak, bewijs en schaal — in VS Code toont Fucini Coverage: What Community Includes dezelfde lijst met de tellers van vandaag per limiet.

Een week loopt zeven dagen vanaf het eerste gebruik waarmee hij begon, en niets dat alleen coverage leest wordt geteld. Nog niet toe aan een abonnement? Een 7-dagenpas is alles uit de rechterkolom voor één week, één keer betaald, zonder dat je iets hoeft op te zeggen.

VS Code en Visual Studio naast elkaar

Eén product, twee editors, één lezer: hetzelfde rapport geeft in beide dezelfde cijfers, tot op het cijfer. Coverage Studio voor Visual Studio draait op Visual Studio 2022 en 2026 — Community, Professional en Enterprise en gebruikt de eigen code coverage van Visual Studio niet, die in 2022 alleen voor Enterprise is; hij is inbegrepen bij elk betaald plan, en een apparaat met beide editors is één seat. Alles boven de lijn zit in beide; eronder staat waar Visual Studio geen tegenhanger voor heeft, en wat daar nog komt.

Instellingenreferentie

Configureer via de Settings-UI (zoek op Fucini Coverage) of in 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.

Een rij die eindigt op Per map. neemt in een multi-root-werkruimte een waarde op mapniveau aan: elke map wordt gedetecteerd met haar eigen .vscode/settings.json of haar item in het .code-workspace, en ${workspaceFolder} daarin betekent die map.

Lokalisatie

Detectie en laden

Kleurenschaal en badges

Samengestelde score (gewogen harmonisch gemiddelde)

Drempelwaarden en compliance

Diff, padherschrijving en rapporten

Weergave en analyse

Geschiedenis

Snelle acties in de statusbalk

Allemaal standaard op false behalve de laatste twee; schakel in om de bijbehorende actie aan het snelmenu toe te voegen: quickActions.compareWithLastRun, openAnnotatedSource, openAnnotatedSourceToSide, toggleAnnotatedSource, toggleWatch, worstCoveredFiles, worstCoveredFolders, worstCoveredFunctions, nextUncovered, previousUncovered, checkThresholds, copyUncoveredLines, compareHistoryRuns, exportJson, exportReport, generateBadge, showTestCoverage, chooseGutterMode, toggleInlineHitCounts.

Telemetrie

Updates

Licentiëring