
Security News
TypeScript is Porting Its Compiler to Go for 10x Faster Builds
TypeScript is porting its compiler to Go, delivering 10x faster builds, lower memory usage, and improved editor performance for a smoother developer experience.
v8-to-istanbul
Advanced tools
The v8-to-istanbul package is a tool that converts V8 coverage information into a format that is compatible with Istanbul's coverage reports. It allows developers to generate coverage reports for JavaScript code executed in the V8 JavaScript engine, which is used by Node.js and Chrome.
Convert V8 coverage to Istanbul format
This feature allows you to convert V8 coverage information into the Istanbul format. You can then use this data to generate reports with Istanbul-compatible tools.
const v8toIstanbul = require('v8-to-istanbul');
const scriptPath = './path/to/script.js';
const v8Coverage = require('./path/to/v8-coverage.json');
const converter = v8toIstanbul(scriptPath);
converter.load();
converter.applyCoverage(v8Coverage);
const istanbulCoverage = converter.toIstanbul();
console.log(JSON.stringify(istanbulCoverage, null, 2));
Exclude specific functions or lines from coverage
This feature allows you to exclude specific functions or ranges of lines from the coverage report. This is useful for ignoring code that you do not want to include in your coverage metrics.
const v8toIstanbul = require('v8-to-istanbul');
const scriptPath = './path/to/script.js';
const converter = v8toIstanbul(scriptPath, {
exclude: ['**/node_modules/**', '**/test/**']
});
converter.exclude('functionName');
converter.excludeRange([startLine, endLine]);
nyc is a command-line tool and library for instrumenting code with Istanbul's coverage tracking and reporting. It is a more comprehensive tool that includes v8-to-istanbul's functionality as part of its coverage processing pipeline.
c8 is a higher-level tool that uses v8-to-istanbul under the hood to collect and report V8 code coverage. It provides a simple command-line interface to generate coverage reports without needing to manually convert V8 coverage data.
istanbul-lib-instrument is part of the Istanbul API and is responsible for instrumenting JavaScript code. It differs from v8-to-istanbul in that it modifies the code to track coverage, rather than converting coverage data from the V8 engine.
converts from v8 coverage format to istanbul's coverage format.
const v8toIstanbul = require('v8-to-istanbul')
// the path to the original source-file is required, as its contents are
// used during the conversion algorithm.
const converter = v8toIstanbul('./path-to-instrumented-file.js')
await converter.load() // this is required due to async file reading.
// provide an array of coverage information in v8 format.
converter.applyCoverage([
{
"functionName": "",
"ranges": [
{
"startOffset": 0,
"endOffset": 520,
"count": 1
}
],
"isBlockCoverage": true
},
// ...
])
// output coverage information in a form that can
// be consumed by Istanbul.
console.info(JSON.stringify(converter.toIstanbul()))
Sometimes you might find yourself wanting to ignore uncovered lines in your application (for example, perhaps you run your tests in Linux, but there's code that only executes on Windows).
To ignore lines, use the special comment /* v8 ignore next */
.
NOTE: Before version 9.2.0
the ignore hint had to contain c8
keyword, e.g. /* c8 ignore ...
.
const myVariable = 99
/* v8 ignore next */
if (process.platform === 'win32') console.info('hello world')
const myVariable = 99
/* v8 ignore next 3 */
if (process.platform === 'win32') {
console.info('hello world')
}
/* v8 ignore start */
function dontMindMe() {
// ...
}
/* v8 ignore stop */
const myVariable = 99
const os = process.platform === 'darwin' ? 'OSXy' /* v8 ignore next */ : 'Windowsy'
To execute tests, simply run:
npm test
FAQs
convert from v8 coverage format to istanbul's format
The npm package v8-to-istanbul receives a total of 16,636,493 weekly downloads. As such, v8-to-istanbul popularity was classified as popular.
We found that v8-to-istanbul demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 0 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
TypeScript is porting its compiler to Go, delivering 10x faster builds, lower memory usage, and improved editor performance for a smoother developer experience.
Research
Security News
The Socket Research Team has discovered six new malicious npm packages linked to North Korea’s Lazarus Group, designed to steal credentials and deploy backdoors.
Security News
Socket CEO Feross Aboukhadijeh discusses the open web, open source security, and how Socket tackles software supply chain attacks on The Pair Program podcast.