# Matriz de cobertura

> Consulta el último resultado por caso de prueba × entorno de un vistazo — navega a la pantalla Coverage, interpreta el layout de la matriz y usa los filtros de suite, estado y búsqueda.

La **matriz de cobertura** te muestra, de un vistazo, el último resultado de cada caso de prueba en cada entorno del proyecto. Responde a la pregunta "¿cuál es el estado actual de cada caso de prueba en cada destino de despliegue?" sin necesidad de abrir ejecuciones individuales.

## Cómo llegar a la pantalla

Abre un proyecto y haz clic en **Coverage** en la barra lateral del proyecto (ícono de grilla). La URL es `/projects/:projectId/coverage-matrix`.

## Cómo interpretar la matriz

La matriz es una tabla donde:

- **Las filas** son los casos de prueba del proyecto, ordenados por número de caso y agrupados bajo encabezados de suite. Los casos sin suite asignada aparecen bajo la banda **Unassigned** (Sin suite).
- **Las columnas** son los entornos del proyecto (ver [Entornos](https://docs.probara.net/es/guides/environments/)). El orden de las columnas sigue el orden de creación de los entornos. Si el proyecto no tiene entornos, no se muestra la matriz: primero crea al menos uno.
- **Cada celda** muestra el resultado más reciente registrado para ese caso de prueba en ese entorno, considerando todas las ejecuciones vinculadas a él. En un caso parametrizado, una ejecución que contiene varios casos de ejecución de ese caso muestra el peor estado entre ellos: Fallido, luego Bloqueado, Reintentar, Sin probar, Omitido y Aprobado. Consulta [Casos de prueba parametrizados](https://docs.probara.net/es/guides/parameterized-test-cases/#ejecuciones).

### Estados de las celdas

| Apariencia de la celda                                                                                   | Significado                                                                                                 |
| -------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| Una celda con un tinte suave y un icono de resultado centrado — visto, cruz, omitir, bloqueo o reintento | El resultado más reciente de este caso en este entorno (`Passed`, `Failed`, `Skipped`, `Blocked`, `Retest`) |
| Un guion gris pequeño                                                                                    | El caso se ejecutó en este entorno, pero no se registró ningún resultado (**Untested**, sin probar)         |
| Una celda vacía                                                                                          | No se ha registrado nunca ningún resultado para este caso en ese entorno (**Not run**, sin ejecutar)        |

El icono es el que comunica el estado y el tinte solo lo refuerza, de modo que la cuadrícula se puede leer sin depender del color; además, cada celda anuncia su estado a un lector de pantalla, incluidas las dos vacías.

Cuando varias ejecuciones están vinculadas al mismo entorno e incluyen el mismo caso de prueba, solo se muestra el resultado con la marca de tiempo de ejecución más reciente. Si dos resultados comparten la misma marca de tiempo, prevalece el que tiene el ID interno mayor.

Los resultados de ejecuciones **sin entorno asignado** nunca se reflejan en la matriz — cada columna solo considera las ejecuciones explícitamente vinculadas a ese entorno.

## Filtros

Sobre la matriz, la barra de filtros te permite acotar las filas visibles. Todos los filtros activos se combinan — las filas deben satisfacer cada filtro activo al mismo tiempo.

### Filtro de suite

Selecciona una o más suites para ver solo sus casos de prueba. Las filas de cualquiera de las suites seleccionadas se incluyen (semántica OR entre las selecciones). Deseleccionar todas las suites elimina el filtro y muestra todos los casos.

- **Selección simple** — comportamiento idéntico al anterior; solo aparecen los casos de esa suite.
- **Selección múltiple** — se muestran juntos los casos de cualquiera de las suites seleccionadas. Por ejemplo, seleccionar "Autenticación" y "Checkout" muestra todos los casos de ambas suites.
- **Borrar la selección** — se muestran todos los casos, independientemente de la suite.

### Filtro de estado (Status)

Filtra las filas según el estado derivado más reciente. Selecciona uno o más estados, incluyendo **Not run** (filas con al menos una celda vacía en algún entorno). Los valores se combinan con OR.

### Barra de búsqueda

La barra de búsqueda te permite encontrar casos de prueba por nombre o ID visible. Escribe cualquier texto para filtrar las filas a los casos cuyo título o ID contenga tu consulta como subcadena (sin distinción de mayúsculas).

**Buscar por** — haz clic en el ícono a la izquierda del campo de búsqueda para elegir contra qué campo se busca:

| Ámbito                 | Qué busca                                                    |
| ---------------------- | ------------------------------------------------------------ |
| **Todo** (por defecto) | Título **o** ID visible                                      |
| **Título**             | Solo el título del caso                                      |
| **ID**                 | Solo el ID visible (el `#<número>` que aparece en la matriz) |

Por ejemplo, escribir `42` con ámbito **ID** encuentra únicamente el caso con ID visible `#42`; escribir `42` con ámbito **Todo** también encuentra cualquier caso cuyo título contenga "42".

La consulta de búsqueda se escribe en la URL tras una breve pausa, por lo que puedes marcar la URL como favorita o compartirla. Borrar el campo elimina el filtro de texto.

Cambiar el ámbito de búsqueda no restablece la consulta actual ni los demás filtros activos.

Todos los filtros activos (Suite + Status + Búsqueda) se reflejan en la URL, por lo que puedes marcarla como favorita o compartirla con el foco aplicado.

El selector de filas por página y el resumen del rango aparecen debajo de la matriz en cuanto hay suficientes casos de prueba para paginar; los controles de anterior/siguiente y de número de página solo aparecen cuando hay más casos de prueba de los que caben en una página. Al cambiar de página, la lista de columnas y los filtros activos permanecen estables — solo cambian las filas.

## Guías relacionadas

- [Entornos](https://docs.probara.net/es/guides/environments/) — crea y gestiona los entornos que aparecen como columnas en la matriz.
- [Panel de ejecución de un run](https://docs.probara.net/es/guides/runs/execution-panel/) — ejecuta casos de prueba y registra los resultados que alimentan las celdas de la matriz.
