Socket
Socket
Sign inDemoInstall

v8-to-istanbul

Package Overview
Dependencies
5
Maintainers
2
Versions
54
Alerts
File Explorer

Advanced tools

Install Socket

Protect your apps from supply chain attacks

Install

v8-to-istanbul

convert from v8 coverage format to istanbul's format

    9.2.0latest
    GitHub
    npm

Version published
Maintainers
2
Weekly downloads
24,500,667
increased by5.59%

Weekly downloads

Package description

What is v8-to-istanbul?

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.

What are v8-to-istanbul's main functionalities?

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]);

Other packages similar to v8-to-istanbul

Changelog

Source

9.2.0 (2023-11-22)

Features

  • support /* v8 ignore ignore hints (#228) (f8757c0)

Readme

Source

v8-to-istanbul

Build Status Conventional Commits nycrc config on GitHub

converts from v8 coverage format to istanbul's coverage format.

Usage

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()))

Ignoring Uncovered Lines

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 ....

ignoring the next line

const myVariable = 99
/* v8 ignore next */
if (process.platform === 'win32') console.info('hello world')

ignoring the next N lines

const myVariable = 99
/* v8 ignore next 3 */
if (process.platform === 'win32') {
  console.info('hello world')
}

ignoring all lines until told

/* v8 ignore start */
function dontMindMe() {
  // ...
}
/* v8 ignore stop */

ignoring the same line as the comment

const myVariable = 99
const os = process.platform === 'darwin' ? 'OSXy' /* v8 ignore next */ : 'Windowsy' 

Testing

To execute tests, simply run:

npm test

Keywords

FAQs

Last updated on 22 Nov 2023

Did you know?

Socket installs a GitHub app to automatically flag issues on every pull request and report the health of your dependencies. Find out what is inside your node modules and prevent malicious activity before you update the dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc