PackageTrack
Sign in Get early access

coverage

Coverage data manipulation and formatting

1.15.1 11M downloads/mo #15 most downloaded on pub.dev dart-lang/tools

What this package is like to depend on

Last release 2 months ago

09 Jun 2026

Ships unpredictably

gaps range from 1 weeks to 11 months

Most releases are documented

notes for 88 of 101 stable releases

Nothing withdrawn

no release was ever pulled

12 years old

101 releases · first in 2014

1 release in the last 12 months

see the full history below

Release timeline

101 releases · Feb 2014 to Jun 2026
2015 2017 2019 2021 2023 2025
Release Pre-release

Releases

latest 60 of 101
  1. 1.15.1 09 Jun 2026
    Release notes
    • Allow package_config 3.x.x.
    Open source →
    Release notes
    • Allow package_config 3.x.x.
    Open source →
  2. 1.15.0 09 Jul 2025
    Release notes
    • Expose filterIgnored function, which filters the coverage data according to // coverage:ignore-... comments. Previously this filtering functionality was only available when loading coverage data from json using parseJson etc.
    Open source →
  3. 1.14.1 05 Jun 2025
    Release notes
    • Remove dependency on package:pubspec_parse.
    • Silence a rare error that can occur when trying to resume the main isolate because the VM service has already shut down. This was responsible for a ~0.1% flakiness, and is safe to ignore.
    Open source →
  4. 1.14.0 25 May 2025
    Release notes
    • Require Dart ^3.6.0
    • Partial support for workspace packages in test_wth_coverage.
    • Deprecate test_wth_coverage's --package-name flag, because it doesn't make sense for workspaces.
    • Change the default --port to 0, allowing the VM to choose a free port.
    Open source →
  5. 1.13.1 01 May 2025
    Release notes
    • Fix a bug where the VM service can be shut down while some coverage collections are still happening.
    Open source →
  6. 1.13.0 30 Apr 2025
    Release notes
    • Introduced support for minimum coverage thresholds using --fail-under flag in format_coverage.
    • Fix a bug where we attempt to resume an isolate after the VM service has been shut down.
    Open source →
  7. 1.12.0 10 Apr 2025
    Release notes
    • Introduced support for specifying coverage flags through a YAML file.
    • Fix a bug where coverage collection could hang forever if the package under test used background isolates that were never shut down.
    Open source →
  8. 1.11.1 05 Dec 2024
    Release notes
    • Update package:vm_service constraints to '>=12.0.0 <16.0.0'.
    Open source →
  9. 1.11.0 10 Nov 2024
    Release notes
    • Fix a bug where the tool would occasionally try to resume an isolate after the VM service had been disposed.
    Open source →
  10. 1.10.0 16 Oct 2024
    Release notes
    • Fix a bug where tests involving multiple isolates never finish.
    Open source →
  11. 1.9.2 30 Aug 2024
    Release notes
    • Fix repository link in pubspec.
    Open source →
  12. 1.9.1 28 Aug 2024
    Release notes
    • Remove outdated VM service version checks.
    • Move to dart-lang/tools.
    Open source →
  13. 1.9.0 01 Aug 2024
    Release notes
    • Require Dart ^3.4
    • Fix bug where some ranges were able to bypass the --scope-output filters.
    • Add --ignore-files option allowing to exclude files from coverage reports using glob patterns
    Open source →
  14. 1.8.0 06 May 2024
    Release notes
    • Copy collect_coverage's --scope-output flag to test_with_coverage.
    Open source →
  15. 1.7.2 13 Dec 2023
    Release notes
    • Update package:vm_service constraints to '>=12.0.0 <15.0.0'.
    Open source →
  16. 1.7.1 25 Oct 2023
    Release notes
    • Update package:vm_service constraints to '>=12.0.0 <14.0.0'.
    Open source →
  17. 1.7.0 18 Oct 2023
    Release notes
    • Require Dart 3.0.0
    • Update package:vm_service constraints to '^12.0.0'.
    • Add coverableLineCache parameter to collect. This allows the set of coverable lines to be cached between calls to collect, avoiding the need to force compile the same libraries repeatedly. This is only useful when running multiple coverage collections over the same libraries.
    Open source →
  18. 1.6.4 02 Oct 2023
    Release notes
    • allow omitting space between // and coverage in coverage ignore comments
    • allow text after coverage ignore comments
    • throw FormatException when encountering unbalanced ignore comments instead of silently erroring
    • Update package:vm_service constraints to '>= 9.4.0 <12.0.0'.
    Open source →
  19. 1.6.3 06 Feb 2023
    Release notes
    • Require Dart 2.18
    • Update package:vm_service constraints to '>=9.4.0 <12.0.0'.
    Open source →
  20. 1.6.2 12 Jan 2023
    Release notes
    • Update package:vm_service constraints to '>=9.4.0 <11.0.0'.
    Open source →
  21. 1.6.1 20 Sep 2022
    Release notes
    • Handle SentinelExceptions thrown by vm_service.
    Open source →
  22. 1.6.0 08 Sep 2022
    Release notes
    • Update to vm_service 9.4.0.
    • Use IsolateRef.isolateGroupId to speed up coverage collection.
    • Ignore uncoverable abstract methods.
    • Fix bug where 'ingore-line' comments etc are applied even if they're inside string literals.
    • Change the LICENSE file to the standard Dart BSD license.
    Open source →
  23. 1.5.0 30 Jun 2022
    Release notes

    • Support passing extra arguments to test_with_coverage which are then passed to package:test.

      Example: dart run coverage:test_with_coverage -- --preset CI

    Open source →
  24. 1.4.0 21 Jun 2022
    Release notes
    • Added HitMap.parseJsonSync which takes a cache of ignored lines which can speedup calls when checkIgnoredLines is true and the function is called several times with overlapping files in the input json.
    • Bump the version of vm_service to 9.0.0.
    Open source →
  25. 1.3.2 16 May 2022
    Release notes
    • Fix test_with_coverage listening to an unsupported signal on windows.
    • Fix --reportOn on windows using incorrect path separators.
    Open source →
  26. 1.3.1 12 May 2022
    Release notes
    • Fix running dart pub global run coverage:test_with_coverage or dart run coverage:test_with_coverage
    Open source →
  27. 1.3.0 11 May 2022
    Release notes
    • Bump the minimum Dart SDK version to 2.15.0
    • Add a --package flag, which takes the package's root directory, instead of the .package file. Deprecate the --packages flag.
    • Deprecate the packagesPath parameter and add packagePath instead, in HitMap.parseJson, HitMap.parseFiles, createHitmap, and parseCoverage.
    • Add a new executable to the package, test_with_coverage. This simplifies the most common use case of coverage, running all the tests for a package, and generating an lcov.info file.
    • Use the libraryFilters option in getSourceReport to speed up coverage runs that use scopedOutput.
    Open source →
  28. 1.2.0 24 Mar 2022
    Release notes
    • Support branch level coverage information, when running tests in the Dart VM. This is not supported for web tests yet.
    • Add flag --branch-coverage (abbr -b) to collect_coverage that collects branch coverage information. The VM must also be run with the --branch-coverage flag.
    • Add flag --pretty-print-branch to format_coverage that works similarly to pretty print, but outputs branch level coverage, rather than line level.
    • Update --lcov (abbr -l) in format_coverage to output branch level coverage, in addition to line level.
    • Add an optional bool flag to collect that controls whether branch coverage is collected.
    • Add a branchHits field to HitMap.
    • Add support for scraping the service URI from the new Dart VM service message.
    • Correctly parse package_config files on Windows when the root URI is relative.
    Open source →
  29. 1.1.0 18 Jan 2022
    Release notes
    • Support function level coverage information, when running tests in the Dart VM. This is not supported for web tests yet.
    • Add flag --function-coverage (abbr -f) to collect_coverage that collects function coverage information.
    • Add flag --pretty-print-func (abbr -f) to format_coverage that works similarly to pretty print, but outputs function level coverage, rather than line level.
    • Update --lcov (abbr -l) in format_coverage to output function level coverage, in addition to line level.
    • Add an optional bool flag to collect that controls whether function coverage is collected.
    • Added HitMap.parseJson, FileHitMaps.merge, HitMap.parseFiles, HitMap.toJson, FileHitMapsFormatter.formatLcov, and FileHitMapsFormatter.prettyPrint that switch from using Map<int, int> to represent line coverage to using HitMap (which contains both line and function coverage). Document the old versions of these functions as deprecated. We will delete the old functions when we update to coverage version 2.0.0.
    • Ensure createHitmap returns a sorted hitmap. This fixes a potential issue with ignore line annotations.
    • Use the reportLines flag in vm_service's getSourceReport RPC. This typically halves the number of RPCs that the coverage collector needs to run.
    • Require Dart >=2.14.0
    Open source →
  30. 1.0.4 20 Dec 2021
    Release notes
    • Updated dependency on vm_service package from >=6.1.0 <8.0.0to >=8.1.0 <9.0.0.
    Open source →
  31. 1.0.3 26 May 2021
    Release notes
    • Updated dependency on vm_service package from ^6.1.0 to >=6.1.0 <8.0.0.
    Open source →
  32. 1.0.2 19 Mar 2021
    Release notes
    • Fix an issue where the --packages argument wasn't passed to format_coverage.
    Open source →
  33. 1.0.1 02 Mar 2021
    Release notes
    • Allow the chrome sourceUriProvider to return null.
    Open source →
  34. 1.0.0 28 Feb 2021
    Release notes
    • Migrate to null safety.
    • Removed support for SDK 1.x.x.
    Open source →
  35. 0.15.2 08 Feb 2021
    Release notes
    • Update args, logging, and package_config deps to allow the latest stable releases.
    Open source →
  36. 0.15.1 20 Jan 2021
    Release notes
    • Updated dependency on vm_service package from >=1.0.0 < 5.0.0 to >=1.0.0 <7.0.0.
    Open source →
  37. 0.15.0 14 Jan 2021
    Release notes
    • BREAKING CHANGE: Eliminate the --package-root option from bin/run_and_collect.dart and bin/format_coverage.dart as well as from runAndCollect and the Resolver constructor.
    Open source →
  38. 0.14.2 10 Nov 2020
    Release notes
    • Fix an issue where --wait-paused with collect would attempt to collect coverage if no isolates have started.
    Open source →
  39. 0.14.1 10 Sep 2020
    Release notes
    • Updated dependency on vm_service package from >=1.0.0 < 5.0.0 to >=1.0.0 <6.0.0.
    Open source →
  40. 0.14.0 04 Jun 2020
    Release notes

    • Add flag --check-ignore that is used to ignore lines from coverage depending on the comments.

      Use // coverage:ignore-line to ignore one line. Use // coverage:ignore-start and // coverage:ignore-end to ignore range of lines inclusive. Use // coverage:ignore-file to ignore the whole file.

    Open source →
  41. 0.13.11 04 Jun 2020
    Release notes
    • Revert breaking change in 13.10
    Open source →
  42. 0.13.10 03 Jun 2020
    Release notes

    • Add flag --check-ignore that is used to ignore lines from coverage depending on the comments.

      Use // coverage:ignore-line to ignore one line. Use // coverage:ignore-start and // coverage:ignore-end to ignore range of lines inclusive. Use // coverage:ignore-file to ignore the whole file.

    Open source →
  43. 0.13.9 09 Mar 2020
    Release notes
    • Don't crash on empty JSON input files.
    • Loosen the dependency on the vm_service package from >=1.0.0 <4.0.0 to >=1.0.0 <5.0.0.
    Open source →
  44. 0.13.8 02 Mar 2020
    Release notes
    • Update to package_config 1.9.0 which supports package_config.json files and should be forwards compatible with 2.0.0.
    • Deprecate the packageRoot argument on Resolver.
    Open source →
  45. 0.13.7 28 Feb 2020
    Release notes
    • Loosen the dependency on the vm_service package from >=1.0.0 <3.0.0 to >=1.0.0 <4.0.0.
    Open source →
  46. 0.13.6 10 Feb 2020
    Release notes
    • Now consider all .json files for the format_coverage command.
    Open source →
  47. 0.13.5 01 Feb 2020
    Release notes
    • Update parseChromeCoverage to merge coverage information for a given line.
    • Handle source map parse errors in parseChromeCoverage. Coverage will not be considered for Dart files that have corresponding invalid source maps.
    Open source →
  48. 0.13.4 24 Jan 2020
    Release notes
    • Add parseChromeCoverage for creating a Dart based coverage report from a Chrome coverage report.
    Open source →
  49. 0.13.3 28 Sep 2019
    Release notes
    • Adds a new named argument to collect to filter coverage results by a set of VM isolate IDs.
    • Migrates implementation of VM service protocol library from package:vm_service_lib, which is no longer maintained, to package:vm_service, which is.
    Open source →
  50. 0.13.3+1 25 Oct 2019
    Release notes
    • Loosen the dependency on the vm_service package from ^1.0.0 to >=1.0.0 <3.0.0. Ensures dependency version range compatibility with the latest versions of package test.
    Open source →
  51. 0.13.3+2 03 Dec 2019
    Release notes
    • Tighten the dependency on the vm_service package from >=1.0.0 <3.0.0 down to >=1.0.0 <2.1.2 in order to exclude version 2.1.2 which is broken on the current stable Dart VM due to a missing SDK constraint in its pubspec.yaml. The breakage was introduced in: https://github.com/dart-lang/sdk/commit/9e636b5ab4de850fb19bc262e0686fdf14bfbfc0.
    Open source →
  52. 0.13.3+3 04 Dec 2019
    Release notes
    • Re-loosen the dependency on the vm_service package from >=1.0.0 < 2.1.2 to >=1.0.0 <3.0.0 now that breakage introduced in version 2.1.2 has been resolved. Fixed in: https://github.com/dart-lang/sdk/commit/7a911ce3f1e945f2cbd1967c6109127e3acbab5a.
    Open source →
  53. 0.13.2 23 Jul 2019
    Release notes
    • Add new multi-flag option --scope-output which restricts coverage output so that only scripts that start with the provided path are considered.
    Open source →
  54. 0.13.1 18 Jul 2019
    Release notes
    • Handle scenario where the VM returns empty coverage information for a range.
    Open source →
  55. 0.13.0 10 Jul 2019
    Release notes
    • BREAKING CHANGE: Skips collecting coverage for dart: libraries by default, which provides a significant performance boost. To restore the previous behaviour and collect coverage for these libraries, use the --include-dart flag.
    • Disables WebSocket compression for coverage collection. Since almost all coverage collection runs happen over the loopback interface to localhost, this improves performance and reduces CPU usage.
    • Migrates implementation of VM service protocol library from package:vm_service_client, which is no longer maintained, to package:vm_service_lib, which is.
    Open source →
  56. 0.12.4 11 Jan 2019
    Release notes
    • collect() now immediately throws ArgumentError if a null URI is passed in the serviceUri parameter to avoid a less-easily debuggable null dereference later. See dart-lang/coverage#240 for details.
    Open source →
  57. 0.12.3 19 Oct 2018
    Release notes
    • Fixed dart-lang/coverage#194. During collection, we now track each script by its (unique) VMScriptRef. This ensures we look up the correct script when computing the affected line for each hit token. The hitmap remains URI based, since in the end, we want a single, unified set of line to hitCount mappings per script.
    Open source →
  58. 0.12.2 25 Jul 2018
    Release notes
    • Dart SDK upper bound raised to <3.0.0.
    Open source →
  59. 0.12.1 26 Jun 2018
    Release notes
    • Minor type, dartfmt fixes.
    • Require package:args >= 1.4.0.
    Open source →
  60. 0.12.0 26 Jun 2018
    Release notes
    • BREAKING CHANGE: This version requires Dart SDK 2.0.0-dev.64.1 or later.
    • Strong mode fixes as of Dart SDK 2.0.0-dev.64.1.
    Open source →

Every package, every release, already written down.

The archive is open and free. Watching your own project is what we are building next.

Browse the archive