Test coverage visualization
With the help of GitLab CI/CD, you can collect the test coverage information of your favorite testing or coverage-analysis tool, and visualize this information inside the file diff view of your merge requests (MRs). This allows you to see which lines are covered by tests, and which lines still require coverage, before the MR is merged.
GitLab supports two coverage report formats:
How test coverage visualization works
Collecting the coverage information is done by using the GitLab CI/CD artifacts reports feature. You can specify one or more coverage reports to collect, including wildcard paths. GitLab then takes the coverage information in all the files and combines it together. Coverage files are parsed in a background job so there can be a delay between pipeline completion and the visualization loading on the page.
Data expiration
By default, the data used to draw the visualization on the merge request expires one week after creation.
Coverage report from child pipeline
-
Introduced in GitLab 15.1 with a flag named
ci_child_pipeline_coverage_reports
. Disabled by default. -
Enabled on GitLab.com and self-managed and feature flag
ci_child_pipeline_coverage_reports
removed in GitLab 15.2.
If a job in a child pipeline creates a coverage report, the report is included in the parent pipeline’s coverage report.
child_test_pipeline:
trigger:
include:
- local: path/to/child_pipeline_with_coverage.yml