c8js • Docs
Interface: Options
Extends
Extended by
Properties
100?
optional
100:boolean
Fails if coverage falls below 100%.
Default Value
false
Inherited from
all?
optional
all:boolean
If true
, all files specified with the options src
,
include
, exclude
and extension
will be loaded into the report.
If any of those files remain uncovered, they will be factored into the report with a
default of 0% coverage.
Default Value
false
Inherited from
allowExternal?
optional
allowExternal:boolean
Inherited from
branches?
optional
branches:number
Percentage of branches that must be covered for the check to pass.
This setting is ignored if option 100
is used.
Default Value
0
Inherited from
c8Config?
optional
c8Config:string
Path to c8 JSON configuration file.
If not provided, c8js searches for files named '.c8rc'
, '.c8rc.json'
, '.nycrc'
, or
'.nycrc.json'
, starting from cwd
and walking up the filesystem tree.
This setting is ignored if option useC8Config
is set to false
.
Inherited from
checkCoverage?
optional
checkCoverage:boolean
Whether to check that code coverage is within the specified thresholds.
This setting is ignored if option 100
is used.
Default Value
false
cwd?
optional
cwd:string
|URL
Current working directory of the subprocess, project root of reports and base directory for all relative paths. Must be an absolute path.
Default Value
process.cwd
Inherited from
exclude?
optional
exclude:string
|string
[]
Glob patterns matching files that should be excluded from coverage.
Default Value
await import('@istanbuljs/schema/default-exclude.js')
Inherited from
excludeAfterRemap?
optional
excludeAfterRemap:boolean
Whether to apply exclusion logic after source maps are used to remap compiled to original source files, or before.
Default Value
false
Inherited from
excludeNodeModules?
optional
excludeNodeModules:boolean
Whether or not to exclude all 'node_module'
folders.
Default Value
true
Inherited from
extension?
optional
extension:string
|string
[]
Only files matching these extensions will be included in coverage.
Default Value
['.js', '.cjs', '.mjs', '.ts', '.tsx', '.jsx']
Inherited from
functions?
optional
functions:number
Percentage of functions that must be covered for the check to pass.
This setting is ignored if option 100
is used.
Default Value
0
Inherited from
include?
optional
include:string
|string
[]
Glob patterns matching files that should be included in coverage. An empty array matches all files.
Default Value
[]
Inherited from
lines?
optional
lines:number
Percentage of lines that must be covered for the check to pass.
This setting is ignored if option 100
is used.
Default Value
90
Inherited from
mergeAsync?
optional
mergeAsync:boolean
Merges all V8 coverage reports asynchronously and incrementally to avoid OOM issues.
Default Value
false
Inherited from
omitRelative?
optional
omitRelative:boolean
Inherited from
perFile?
optional
perFile:boolean
Checks thresholds on a per-file basis.
Default Value
false
Inherited from
reporter?
optional
reporter:string
|string
[]
Coverage reporter(s) to use.
Default Value
'text'
reporterOptions?
optional
reporterOptions:Record
<string
,Record
<string
,unknown
>>
An object mapping reporter names to additional options passed directly to the respective reporters.
Overrides
reportsDirectory?
optional
reportsDirectory:string
Directory where coverage reports will be output to.
The specified directory is ignored if none of the selected reports writes to disk.
This option is used to determine the location of tempDirectory
, if
not specified.
Default Value
'coverage'
Inherited from
resolve?
optional
resolve:string
Inherited from
skipFull?
optional
skipFull:boolean
If true
, files with 100% statement, branch, and function coverage will not be shown by
the text reporter.
Default Value
false
Overrides
src?
optional
src:string
|string
[]
Overrides cwd
as the location where source files are looked for when the option all
is specified.
This allows for workspaces spanning multiple projects.
Inherited from
statements?
optional
statements:number
Percentage of statements that must be covered for the check to pass.
This setting is ignored if option 100
is used.
Default Value
0
Inherited from
tempDirectory?
optional
tempDirectory:string
Directory where temporary V8 coverage files are written to and read from.
This directory will be created if it does not exist.
Defaults to a subdirectory named 'tmp'
in the directory specified by
reportsDirectory
.
Inherited from
useC8Config?
optional
useC8Config:boolean
If false
, c8js will not load c8 options from a c8
section in 'package.json'
, or from a
JSON configuration file on disk.
Default Value
true
Inherited from
watermarks?
optional
watermarks:Watermarks
Thresholds for low and high code coverage watermarks, exposed by some reporters.
wrapperLength?
optional
wrapperLength:number