# v8-to-istanbul

> convert from v8 coverage format to istanbul's format

Latest version **9.3.0** (published 2024-06-22) · ISC license · 0 weekly downloads

## Install

```sh
npm install v8-to-istanbul
pnpm add v8-to-istanbul
yarn add v8-to-istanbul
bun add v8-to-istanbul
```

## Health

**Score 40/100 (D)** — status: abandoned.

Positive: has types; no vulnerabilities; high maintenance score; high quality score.

Warnings: low downloads; no esm support.

Negative: abandoned.

## Facts

| | |
|---|---|
| Version | 9.3.0 |
| Published | 2024-06-22 |
| First published | 2017-11-25 |
| Weekly downloads | 0 |
| License | ISC |
| TypeScript types | bundled |
| Module format | CommonJS |
| Node | >=10.12.0 |
| Dependencies | 3 |
| Unpacked size | 46.5 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 136 |
| Author | Ben Coe |
| Keywords | istanbul, v8, coverage |

## Links

- npm: https://www.npmjs.com/package/v8-to-istanbul
- Repository: https://github.com/istanbuljs/v8-to-istanbul
- Homepage: https://github.com/istanbuljs/v8-to-istanbul#readme
- Issues: https://github.com/istanbuljs/v8-to-istanbul/issues
- npm.io page: https://npm.io/package/v8-to-istanbul

## Dependencies (3)

- [convert-source-map](https://npm.io/package/convert-source-map.md) ^2.0.0
- [@jridgewell/trace-mapping](https://npm.io/package/@jridgewell/trace-mapping.md) ^0.3.12
- [@types/istanbul-lib-coverage](https://npm.io/package/@types/istanbul-lib-coverage.md) ^2.0.1

## Recent versions

- 9.3.0 (latest) — 2024-06-22
- 8.2.0-candidate.1 (next) — 2022-01-01
- 9.2.0 — 2023-11-22
- 9.1.3 — 2023-10-05
- 9.1.2 — 2023-10-04
- 9.1.1 — 2023-10-04
- 9.1.0 — 2023-02-14
- 9.0.1 — 2022-06-20
- 9.0.0 — 2022-04-20
- 8.1.1 — 2022-01-10
- 9.0.0-candidate.0 — 2021-12-31
- 8.1.0 — 2021-09-27
- 8.0.0 — 2021-06-03
- 7.1.2 — 2021-05-05
- 7.1.1 — 2021-03-30
- … 40 more at https://npm.io/package/v8-to-istanbul/versions

## README

# v8-to-istanbul

[![Build Status](https://img.shields.io/github/actions/workflow/status/istanbuljs/v8-to-istanbul/ci.yaml?branch=master)](https://github.com/istanbuljs/v8-to-istanbul/actions)
[![Conventional Commits](https://img.shields.io/badge/Conventional%20Commits-1.0.0-yellow.svg)](https://conventionalcommits.org)
![nycrc config on GitHub](https://img.shields.io/nycrc/istanbuljs/v8-to-istanbul)

converts from v8 coverage format to [istanbul's coverage format](https://github.com/gotwarlost/istanbul/blob/master/coverage.json.md).

## Usage

```js
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

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

### ignoring the next N lines

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

### ignoring all lines until told

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

### ignoring the same line as the comment

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

## Testing

To execute tests, simply run:

```bash
npm test
```

---
_Source: https://npm.io/package/v8-to-istanbul · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._