Todo lo que hace, todo lo que puede ajustar

Cuando una IA escribió las pruebas

La cobertura frente a una suite de pruebas generada

La visión general plantea el argumento general. Aquí está aplicado a la propia lista de funciones, porque una suite generada falla con una forma característica —cada línea tocada, la mitad de las decisiones nunca tomadas y unas cuantas funciones nombradas en los títulos de las pruebas pero jamás llamadas— y cinco de los puntos de abajo son justo lo que hace visible esa forma.

• La cobertura de ramas y MC/DC, con el hover por arco y por decisión, separa la línea se ejecutó de la decisión se ejercitó. Una suite que solo recorre el camino feliz marca casi el 100% en líneas y casi el 50% en ramas, y ese desfase es el hallazgo. Una ejecución de pruebas en verde no muestra nada de eso.
• La puntuación compuesta es una media armónica, de modo que una métrica fuerte no puede enmascarar a una débil: exactamente la aritmética que hay que aplicarle a una suite generada. Promediar el número de líneas con el de ramas enterraría el único número que interesa mirar.
• Los avisos de código muerto añaden una entrada en el panel Problems para cualquier función con líneas medibles y cobertura cero. Una suite que nombra una función en el título de una prueba y nunca llega a ella no falla en ningún otro sitio.
• La cobertura de diff frente a una referencia base de git reduce todo lo anterior a las líneas que acaban de cambiar: el código que aceptaste esta tarde, y no la media de toda la vida del repositorio, con la que una suite grande ya existente seguirá pareciendo sana tan tranquila.
• Copy Uncovered Lines emite exactamente lo que nunca se ejecutó, en Markdown — o sea, algo que se pega de vuelta directamente en el asistente que escribió la suite en primer lugar.

Nada de esto lee una prueba y la juzga, y nada de lo anterior debe entenderse como esa afirmación: una prueba sin ninguna aserción sigue cubriendo cada línea que toca. Lo que esto mide es la parte que un revisor no puede retener en la cabeza: qué código no se ejecutó nunca.

Único en esta extensión

Su cobertura de líneas dice 100%. 312 bytes de su binario nunca se ejecutaron.

Todas las demás métricas aquí se miden desde el código fuente: instrumentar el código, ejecutar la compilación instrumentada, contar lo que se disparó. La cobertura de código objeto mide algo que ninguna herramienta basada en la fuente puede alcanzar: cuánto del binario construido se ejecutó realmente, en bytes de instrucciones, observando el flujo de instrucciones. Un compilador produce código del que ninguna línea de su fuente da cuenta: comprobaciones de límites de arrays, tablas de salto de switch, volcados de registros, rutinas de ejecución para división o coma flotante. Nada de eso aparece en su fuente, así que ninguna herramienta basada en la fuente —incluida esta extensión, para cualquier otra métrica que lee— puede decir si se ejecutó. Es además la única métrica aquí que responde a ¿esto cubre el ensamblador?, ya que el ensamblador escrito a mano nunca se instrumenta.

DO-178C lo nombra explícitamente: en el nivel A se exige además de MC/DC. Ninguna otra extensión de VS Code lo lee. Cómo obtenerlo de un destino embebido →

Capacidades

Funciones principales

• Una vista Coverage de cada archivo medido, la regla de vista general y Annotated Source; en el propio margen del editor, de forma predeterminada, solo lo que merece una marca — barras MC/DC, triángulos de desde-la-última-ejecución, puntos de líneas editadas — con barras solo en las líneas sin cubrir o un mapa de calor de recuentos de aciertos a un ajuste de distancia.
• Cobertura por línea de sentencias, ramas, funciones, regiones, MC/DC e instanciaciones C++, según lo que proporcione el archivo de traza.
• Ingesta multiformato y combinación determinista de varias ejecuciones con procedencia registrada.
• Remapeo de rutas — rutas de la máquina de compilación CI → su espacio de trabajo local.
• Cobertura diferencial — decora solo las líneas cambiadas frente a una referencia base de git.
• Insignias de Explorer y un elemento de barra de estado global, coloreado según la puntuación compuesta.
• Modo de vigilancia — recarga automática cuando cambia un archivo de traza.
• Run Tests with Coverage — reconoce el ejecutor de pruebas desde la raíz del espacio de trabajo y lo ejecuta con cobertura activada, cargando lo que escribe.
• Archivos de traza remotos — una entrada de coverageFile.paths puede ser una URL https://: el artefacto de CI se descarga de forma condicional (ETag / Last-Modified), con las cabeceras que configure en remote.headers, se carga como un archivo local y se vuelve a descargar con un temporizador mediante remote.refreshMinutes; cuando una descarga falla, se carga en su lugar la última copia descargada.
• Variables en las rutas — ${workspaceFolder}, ${workspaceFolderBasename}, ${userHome}, ${env:NAME}, ${command:id} y ${config:section.key} en todos los ajustes de ruta; una variable desconocida se deja tal como está escrita, de modo que una errata aparece en el registro de detección en lugar de desaparecer.
• Espacios de trabajo multirraíz — cada carpeta se detecta desde sus propios ajustes (su .vscode/settings.json o su entrada en el .code-workspace), sus archivos de traza se fusionan en una sola ejecución, la vista Coverage agrupa los archivos por carpeta, y una carpeta añadida o quitada recarga la cobertura por sí sola.
• Dos desencadenantes de recarga más — una entrada absoluta de coverageFile.paths fuera del espacio de trabajo se sondea, de modo que un archivo que aparece allí se carga; y watch.reloadAfterTasks nombra tareas (npm: test) cuyo final recarga la cobertura, esté o no activado el modo de vigilancia.
• Progreso que se puede cancelar — una carga de diez o más archivos de traza, o de 8 MB o más, y cada Generate Full HTML Report se ejecutan bajo una notificación de progreso con un botón Cancelar; cancelar deja cargada la ejecución anterior.
• La propia vista Test Coverage de VS Code — cada carga se publica también a través de la API Test Coverage del editor (testCoverage.publish), de modo que el panel de cobertura del Test Explorer, los porcentajes por archivo del Explorer y el conmutador Show Inline Coverage del editor muestran las mismas cifras; Show in Test Coverage View publica a petición y abre el panel. Con pruebas con nombre (TN: en lcov), la vista filtra la cobertura de un archivo por prueba.
• Regla de remapeo sugerida — cuando una carga deja archivos sin coincidencia (rutas de contenedor o de CI frente a un checkout local), la extensión infiere la regla de pathRemap que explica el mayor número de ellos, ofrece Apply Suggested Remap en el resultado de la carga y Suggest Path Remap Rule en la paleta; no se escribe nada sin el clic.
• Globs de exclusión — fuciniCoverage.ignore (vendor/**, **/*.generated.ts) descarta archivos enteros de la ejecución al cargar, de modo que cada vista, control y exportación cuenta sin ellos; el resultado de la carga dice cuántos y la salida nombra cada uno.
• No medido frente a no cubierto — un archivo que ninguna prueba cargó no se puntúa como 0% a sus espaldas; la barra de estado dice no medido para uno de ellos, y unmeasured.mode puede listar esos archivos en la vista Coverage o contar cada uno como un archivo sin cubrir, con threshold.unmeasuredFiles para controlar cuántos hay.
• Lo que hizo la fusión, visible — con varios tracefiles cargados, cada fila de archivo nombra el informe del que proceden sus números, la insignia lleva contorno donde esos números anularon un informe más antiguo, cada fila de tracefile cuenta cuántos de sus archivos fueron anulados o anularon otros, y hacer clic en una fila de tracefile resalta sus archivos en el árbol (coverageView.mergedMarks).

Puntuación compuesta y cumplimiento

Una única media armónica ponderada sobre líneas, ramas, funciones, regiones, MC/DC e instanciaciones. Al ser una media armónica, una métrica débil no puede quedar enmascarada por una perfecta. Los pesos se ajustan por defecto a niveles IEC 61508 / ISO 26262 / DO-178C, y el veredicto COMPLIANT / NON-COMPLIANT se determina mediante umbrales por métrica junto con un modo configurable.

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

Análisis en el editor

• CodeLens de función — % de cobertura por función, haga clic para saltar a su primera línea no cubierta.
• Información de ramas y MC/DC al pasar el cursor — recuentos tomados/no tomados por rama y desgloses de condición/vector por decisión; marcador de margen MC/DC coloreado opcional.
• Avisos de código muerto — aviso en el panel Problems para funciones con líneas medibles y cobertura cero.
• Navegación Next/Previous Uncovered.
• Aviso de discrepancia cuando el contenido de un archivo ya no encaja con su ejecución — actualizado al guardar o al cambiar en disco, con la diferencia exacta al pasar el ratón.
• Desde la última ejecución — un triángulo rojo en cada línea ejecutada en la ejecución anterior y no en esta, uno verde para el caso inverso, con la regla de vista general y los recuentos al pasar el ratón.
• Búferes editados — cada marca, descripción emergente y CodeLens se mueve con el texto al editar, y se retira de una línea reescrita, donde un punto gris dice por qué.
• Modos de margen del editor — editorGutter.mode limita el margen a los hallazgos (off), pone una barra en cada línea que nunca se ejecutó y una ámbar donde una rama nunca se tomó (uncovered), o añade un tono cálido en cada línea ejecutada, más intenso cuantas más veces se ejecutó (heatmap); Choose Editor Gutter Mode... cambia de modo desde la paleta o el menú de la barra de estado.
• Recuentos de aciertos en línea — hitCounts.inline escribe ×12 tras cada línea en la que empieza una sentencia, ×0 incluido; Toggle Inline Hit Counts lo alterna.
• Entradas por línea en Problems — problems.perLine pone un diagnóstico de tipo Information en cada bloque de líneas que nunca se ejecutaron en un documento abierto (una función muerta es una entrada, no cuarenta), y opcionalmente en cada línea con una rama nunca tomada; las entradas siguen a sus líneas mientras edita.
• Tinte de línea y mapa en la barra de desplazamiento — lineHighlight pone un tinte translúcido detrás de las líneas mismas en lugar de (o además de) una marca en el margen, y overviewRuler decide por su cuenta la franja de la barra de desplazamiento: con el margen desactivado, eso es un mapa de los huecos del archivo y nada junto al código.
• Qué archivo de traza cubrió esta línea — con varios informes combinados, la información al pasar el cursor nombra cada uno que cubrió la línea (incluido el nombre de suite del TN: de lcov), y un clic en una fila de archivo de traza en la vista Coverage ilumina las líneas que aportó.

• Rojo, ámbar y verde — el modo coverage de editorGutter.mode y lineHighlight pinta cada línea medida con los colores de la escala de colores; el botón de modo de la barra de estado y Alt+G pasan de un modo al siguiente.
• Sus colores, con vista previa — la escala de colores y los tonos del mapa de calor (heatmap.colors, heatmap.colorsDark) son ajustes, y la página de ajustes los muestra en un editor claro y en uno oscuro a medida que se eligen.
• De qué informe procede un archivo — cuando dos informes miden el mismo código, las reglas de coverageFile.sources, o Choose Coverage Source for This File..., deciden cuál muestra cada archivo en lugar de que gane el más reciente.

Informes e historial

• Generate Full HTML Report — un informe auto-renderizado, de varias páginas, por directorio; Open Annotated Source para un solo archivo.
• Historial local opcional de ejecuciones con una tendencia de cobertura (▲/▼), además de Compare Two History Runs y Compare with Last Run.
• Show Worst-Covered Files / Functions y Copy Uncovered Lines (Markdown).
• Export Fucini JSON — el modelo normalizado completo.
• Export Coverage Report... — la misma ejecución como CSV (por archivo o por función), resumen en Markdown, archivo LCOV, XML de Cobertura, SARIF, o insignia SVG autónoma. Con veinticinco lectores y estos escritores la extensión convierte entre formatos: cargue JaCoCo o llvm-cov JSON y emita el LCOV que leen Codecov, Coveralls y SonarQube, o el XML de Cobertura que ingieren Jenkins, GitLab y Azure DevOps.
• Generate Coverage Badge — un SVG al estilo de shields escrito directamente en el espacio de trabajo (badge.outputPath, de forma predeterminada coverage-badge.svg) para que un README lo incruste con ![coverage](coverage-badge.svg) y sin ningún servicio alojado; badge.metric elige líneas, ramas, MC/DC o la puntuación compuesta, el color sigue los niveles de colorScale.*, y badge.autoUpdate la reescribe tras cada carga.

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

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

Community y Pro, función por función

Dos fichas, un solo código. Community es el nivel gratuito para siempre, y aquel en el que cae la ficha Pro tras su prueba de 14 días; Pro y la prueba son todo, sin límites. La línea está trazada para que el nivel gratuito siempre vea cada hallazgo y pague solo por comodidad, prueba y escala — en VS Code, Fucini Coverage: What Community Includes muestra la misma lista con los recuentos de hoy frente a cada límite.

Una semana dura siete días desde el primer uso que la abrió, y nada que solo lea la cobertura se cuenta. ¿No está listo para una suscripción? Un pase de 7 días es todo lo de la columna derecha durante una semana, pagado una sola vez, sin nada que cancelar.

VS Code y Visual Studio, lado a lado

Un producto, dos editores, un lector: el mismo informe da las mismas cifras, dígito a dígito, en ambos. Coverage Studio para Visual Studio funciona en Visual Studio 2022 y 2026 — Community, Professional y Enterprise y no usa la cobertura de código propia de Visual Studio, que en 2022 es solo de Enterprise; está incluido en todos los planes de pago, y un dispositivo con ambos editores es un puesto. Todo lo de encima de la línea está en ambos; debajo, aquello para lo que Visual Studio no tiene equivalente, y lo que allí está aún por llegar.

Referencia de configuración

Configure en la interfaz de ajustes (busque Fucini Coverage) o en 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.

Una fila que termina en Por carpeta. admite un valor a nivel de carpeta en un espacio de trabajo multirraíz: cada carpeta se detecta con su propio .vscode/settings.json o su entrada en el .code-workspace, y ${workspaceFolder} en ella significa esa carpeta.

Localización

Detección y carga

Escala de color e insignias

Puntuación compuesta (media armónica ponderada)

Umbrales y cumplimiento

Diff, remapeo e informes

Visualización y análisis

Historial

Acciones rápidas de la barra de estado

Todas desactivadas (false) por defecto salvo las dos últimas; actívelas para añadir la acción correspondiente al menú rápido: quickActions.compareWithLastRun, openAnnotatedSource, openAnnotatedSourceToSide, toggleAnnotatedSource, toggleWatch, worstCoveredFiles, worstCoveredFolders, worstCoveredFunctions, nextUncovered, previousUncovered, checkThresholds, copyUncoveredLines, compareHistoryRuns, exportJson, exportReport, generateBadge, showTestCoverage, chooseGutterMode, toggleInlineHitCounts.

Telemetría

Actualizaciones

Licencias