coverage-node

A simple CLI to run Node.js and report code coverage.

• ✨ Zero config.
• 🏁 ~240 SLOC, written from scratch to use code coverage features built into Node.js v10+.
• 📦 ~300 kB install size, compared to 6.61 MB for c8 or 13 MB for nyc.
• 🖱Displays ignored or uncovered source code ranges as paths, clickable in IDEs such as VS Code.

Setup

To install from npm run:

npm install coverage-node --save-dev

In a package.json script, replace the node command with coverage-node:

 {
   "scripts": {
-    "test": "node test.js"
+    "test": "coverage-node test.js"
   }
 }

Support

• Linux, macOS.
• Node.js v10+, but Node.js v13.3+ generates more reliable coverage data.

Ignored files

Code coverage analysis ignores:

• node_modules directory files, e.g. node_modules/foo/index.js.
• test directory files, e.g. test/index.js.
• Files with .test prefixed before the extension, e.g. foo.test.js.
• Files named test (regardless of extension), e.g. test.js.

Ignored lines

In source code, a comment (case insensitive) can be used to ignore code coverage ranges that start on the the next line:

// coverage ignore next line
if (false) console.log('Never runs.')

CLI

The coverage-node command substitutes the normal node command; any node CLI options can be used to run a test script.

If the script doesn’t error a code coverage analysis is reported to the console, and if coverage is incomplete the exit code is 1.

npx can be used to quickly check code coverage for a script:

npx coverage-node test.js

API

Table of contents

• function analyseCoverage
• function nodeWithCoverage
• function reportCoverage
• type CoverageAnalysis
• type SourceCodeLocation
• type SourceCodeRange
• type SourceCodeRanges

function analyseCoverage

Analyzes Node.js generated V8 JavaScript code coverage data in a directory; useful for reporting.

Returns: Promise<CoverageAnalysis> — Resolves the coverage analysis.

Examples

How to import.

const { analyseCoverage } = require('coverage-node')

function nodeWithCoverage

Runs Node.js with code coverage enabled via the NODE_V8_COVERAGE environment variable.

Returns: Promise<number> — Resolves the Node.js exit code.

Examples

How to import.

const { nodeWithCoverage } = require('coverage-node')

function reportCoverage

Reports a code coverage analysis to the console.

Examples

How to import.

const { reportCoverage } = require('coverage-node')

type CoverageAnalysis

Node.js generated V8 JavaScript code coverage data analysis; useful for reporting.

Type: object

type SourceCodeLocation

Source code location.

Type: object

type SourceCodeRange

Source code range details.

Type: object

type SourceCodeRanges

A source code file with ranges of interest.

Type: object