aboutsummaryrefslogtreecommitdiff
path: root/node_modules/v8-to-istanbul/README.md
diff options
context:
space:
mode:
authorJoel Kronqvist <joel.h.kronqvist@gmail.com>2022-03-05 19:02:27 +0200
committerJoel Kronqvist <joel.h.kronqvist@gmail.com>2022-03-05 19:02:27 +0200
commit5d309ff52cd399a6b71968a6b9a70c8ac0b98981 (patch)
tree360f7eb50f956e2367ef38fa1fc6ac7ac5258042 /node_modules/v8-to-istanbul/README.md
parentb500a50f1b97d93c98b36ed9a980f8188d648147 (diff)
downloadLYLLRuoka-5d309ff52cd399a6b71968a6b9a70c8ac0b98981.tar.gz
LYLLRuoka-5d309ff52cd399a6b71968a6b9a70c8ac0b98981.zip
Added node_modules for the updating to work properly.
Diffstat (limited to 'node_modules/v8-to-istanbul/README.md')
-rw-r--r--node_modules/v8-to-istanbul/README.md90
1 files changed, 90 insertions, 0 deletions
diff --git a/node_modules/v8-to-istanbul/README.md b/node_modules/v8-to-istanbul/README.md
new file mode 100644
index 0000000..7e9bf69
--- /dev/null
+++ b/node_modules/v8-to-istanbul/README.md
@@ -0,0 +1,90 @@
+# v8-to-istanbul
+
+[![Build Status](https://travis-ci.org/istanbuljs/v8-to-istanbul.svg?branch=master)](https://travis-ci.org/istanbuljs/v8-to-istanbul)
+[![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 the async source-map dependency.
+// 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()))
+
+// cleanup resources allocated in "load" (i.e. by the source-map dependency),
+// the converter may not be used anymore afterwards
+converter.destroy()
+```
+
+## 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 `/* c8 ignore next */`.
+
+### ignoring the next line
+
+```js
+const myVariable = 99
+/* c8 ignore next */
+if (process.platform === 'win32') console.info('hello world')
+```
+
+### ignoring the next N lines
+
+```js
+const myVariable = 99
+/* c8 ignore next 3 */
+if (process.platform === 'win32') {
+ console.info('hello world')
+}
+```
+
+### ignoring all lines until told
+
+```js
+/* c8 ignore start */
+function dontMindMe() {
+ // ...
+}
+/* c8 ignore stop */
+```
+
+### ignoring the same line as the comment
+
+```js
+const myVariable = 99
+const os = process.platform === 'darwin' ? 'OSXy' /* c8 ignore next */ : 'Windowsy'
+```
+
+## Testing
+
+To execute tests, simply run:
+
+```bash
+npm test
+```