monocart-coverage-reports 2.0.4 → 2.0.6

package/README.md

@@ -4,19 +4,24 @@
 [![](https://badgen.net/npm/dw/monocart-coverage-reports)](https://www.npmjs.com/package/monocart-coverage-reports)
 ![](https://img.shields.io/github/license/cenfun/monocart-coverage-reports)
 
-> Code coverage tool to generate [V8](https://v8.dev/blog/javascript-code-coverage) or [Istanbul](https://istanbul.js.org/) coverage reports.
-
-## Preview Reports
-- [V8](https://cenfun.github.io/monocart-coverage-reports/v8)
-- [V8 Rollup](https://cenfun.github.io/monocart-coverage-reports/v8-rollup)
-- [V8 Esbuild](https://cenfun.github.io/monocart-coverage-reports/v8-esbuild)
-- [V8 Node v8 API](https://cenfun.github.io/monocart-coverage-reports/v8-node-api)
-- [V8 Node env](https://cenfun.github.io/monocart-coverage-reports/v8-node-env)
-- [V8 Node Inspector](https://cenfun.github.io/monocart-coverage-reports/v8-node-ins)
-- [V8 Minify](https://cenfun.github.io/monocart-coverage-reports/v8-minify)
-- [V8 to Istanbul](https://cenfun.github.io/monocart-coverage-reports/v8-and-istanbul/istanbul)
-- [Istanbul](https://cenfun.github.io/monocart-coverage-reports/istanbul/)
-- [Integration with Monocart Reporter](https://cenfun.github.io/monocart-reporter/) - Playwright test report
+> Code coverage tool to generate native [V8](https://v8.dev/blog/javascript-code-coverage) reports or [Istanbul](https://istanbul.js.org/) reports.
+
+* [Usage](#usage)
+* [Default Options](#default-options)
+* [Available Reports](#available-reports)
+* [Multiprocessing Support](#multiprocessing-support)
+* [Compare Reports](#compare-reports)
+* [Compare Workflows](#compare-workflows)
+* [Collecting Istanbul Coverage Data](#collecting-istanbul-coverage-data)
+* [Collecting V8 Coverage Data](#collecting-v8-coverage-data)
+* [Node.js V8 Coverage Report for Server Side](#nodejs-v8-coverage-report-for-server-side)
+* [Using `entryFilter` and `sourceFilter` to filter the results for V8 report](#using-entryfilter-and-sourcefilter-to-filter-the-results-for-v8-report)
+* [How to convert V8 to Istanbul](#how-to-convert-v8-to-istanbul)
+    - [Using `v8-to-istanbul`](#using-v8-to-istanbul)
+    - [How Monocart Works](#how-monocart-works)
+* [Chromium Coverage API](#chromium-coverage-api)
+* [Istanbul Introduction](#istanbul-introduction)
+* [Thanks](#thanks)
 
 ## Usage
 ```js
@@ -37,30 +42,13 @@ console.log(coverageResults.summary);
 ## Default Options
 - [lib/default/options.js](https://github.com/cenfun/monocart-coverage-reports/blob/main/lib/default/options.js)
 
-## Multiple Reports
-### V8 reports
-- v8 (html)
-- v8-json
-### [Istanbul reports](https://github.com/istanbuljs/istanbuljs/tree/master/packages/istanbul-reports/lib)
-- clover
-- cobertura
-- html
-- html-spa
-- json
-- json-summary
-- lcov
-- lcovonly
-- none
-- teamcity
-- text
-- text-lcov
-- text-summary
-
+## Available Reports
 ```js
 const CoverageReport = require('monocart-coverage-reports');
 const options = {
     outputDir: './coverage-reports',
     reports: [
+        ['console-summary'],
         ['v8'],
         ['html', {
             subdir: 'istanbul'
@@ -73,6 +61,43 @@ const options = {
 }
 const coverageReport = new CoverageReport(options);
 ```
+- `v8` (V8 data only)
+    - [V8 html](https://cenfun.github.io/monocart-coverage-reports/v8) - Example for browser, build with webpack, and also [Rollup](https://cenfun.github.io/monocart-coverage-reports/v8-rollup) and [Esbuild](https://cenfun.github.io/monocart-coverage-reports/v8-esbuild)
+    - [V8 Node](https://cenfun.github.io/monocart-coverage-reports/v8-node-env) - Example for Node.js using env, and also [V8 API](https://cenfun.github.io/monocart-coverage-reports/v8-node-api), [Inspector](https://cenfun.github.io/monocart-coverage-reports/v8-node-ins) and [CDP](https://cenfun.github.io/monocart-coverage-reports/v8-node-cdp)
+    - [V8 Minify](https://cenfun.github.io/monocart-coverage-reports/v8-minify)
+
+![](test/v8.gif)
+
+- `v8-json` (V8 data only)
+    - [V8 coverage-report.json](https://cenfun.github.io/monocart-coverage-reports/v8-and-istanbul/coverage-report.json)
+- `console-summary` shows coverage summary in console
+    
+    ![](test/console-summary.png)
+
+> Following are [istanbul reports](https://github.com/istanbuljs/istanbuljs/tree/master/packages/istanbul-reports/lib)
+- `clover`
+- `cobertura`
+- `html`
+    - [Istanbul html](https://cenfun.github.io/monocart-coverage-reports/istanbul/) 
+    - [V8 to Istanbul](https://cenfun.github.io/monocart-coverage-reports/v8-and-istanbul/istanbul)
+- `html-spa`
+    - [Istanbul html-spa](https://cenfun.github.io/monocart-coverage-reports/istanbul/html-spa/)
+- `json`
+- `json-summary`
+- `lcov`
+- `lcovonly`
+    - [V8 lcov.info](https://cenfun.github.io/monocart-coverage-reports/v8/lcov.info)
+    - [Istanbul lcov.info](https://cenfun.github.io/monocart-coverage-reports/istanbul/lcov.info)
+- `none`
+- `teamcity`
+- `text`
+- `text-lcov`
+- `text-summary`
+
+## Integration
+- [monocart-reporter](https://cenfun.github.io/monocart-reporter/) - Test reporter for [Playwright](https://github.com/microsoft/playwright)
+- [vitest-monocart-coverage](https://github.com/cenfun/vitest-monocart-coverage) - Integration with [Vitest](https://github.com/vitest-dev/vitest) coverage
+
 
 ## Multiprocessing Support
 The data will be added to `[outputDir]/.cache`, and the cache will be removed after reports generated.
@@ -105,7 +130,6 @@ console.log(coverageResults.summary);
 ## Compare Reports
 | | Istanbul | V8 | V8 to Istanbul |
 | :--------------| :------ | :------ | :----------------------  |
-| Instrumenting code | Required | No | No |
 | Coverage data | Istanbul (Object) | V8 (Array) | V8 (Array) |
 | Output | [Istanbul reports](#istanbul-reports) | [V8 reports](#v8-reports)  | [Istanbul reports](#istanbul-reports) |
 | - Bytes | ❌ | ✅ | ❌ |
@@ -121,70 +145,58 @@ console.log(coverageResults.summary);
 
 ## Compare Workflows
 - Istanbul Workflows
-    - 1, Only for source code: instrumenting code with [babel-plugin-istanbul](https://github.com/istanbuljs/babel-plugin-istanbul)，see [webpack.config-istanbul.js](https://github.com/cenfun/monocart-coverage-reports/blob/main/test/webpack.config-istanbul.js), or using [nyc](https://github.com/istanbuljs/nyc).
-    - 2, Collecting coverage data from browser `window.__coverage__` or from node `global.__coverage__`, see [example](https://github.com/cenfun/monocart-coverage-reports/blob/main/test/test-istanbul.js).
-    - 3, Generating coverage report.
+    - 1, [Collecting Istanbul coverage data](#collecting-istanbul-coverage-data)
+    - 2, Adding coverage data and generating coverage report
 
 - V8 Workflows
-    - 1, For any runtime code: nothing to do. For source code: building code with `development` [mode](https://webpack.js.org/configuration/mode/) and [sourcemap](https://webpack.js.org/configuration/devtool/) support, see [webpack.config-v8.js](https://github.com/cenfun/monocart-coverage-reports/blob/main/test/webpack.config-v8.js).
-    - 2, Collecting coverage data with [Chromium Coverage API](#chromium-coverage-api), see [example](https://github.com/cenfun/monocart-coverage-reports/blob/main/test/test-v8.js).
-    - 3, Generating coverage report.
+    - 1, [Collecting V8 coverage data](#collecting-v8-coverage-data)
+    - 3, Adding coverage data and generating coverage report
 
-## Chromium Coverage API
-- [V8 coverage report](https://v8.dev/blog/javascript-code-coverage) - Native support for JavaScript code coverage to V8. (Chromium only)
-- [Puppeteer Coverage Class](https://pptr.dev/api/puppeteer.coverage)
-- [Playwright Coverage Class](https://playwright.dev/docs/api/class-coverage)
-- [DevTools Protocol for Coverage](https://chromedevtools.github.io/devtools-protocol/tot/Profiler/#method-startPreciseCoverage)
+## Collecting Istanbul Coverage Data
+- Instrumenting source code
+    > Before collecting Istanbul coverage data, It requires your source code is instrumented with Istanbul
+    - Webpack: [babel-plugin-istanbul](https://github.com/istanbuljs/babel-plugin-istanbul), example: [webpack.config-istanbul.js](https://github.com/cenfun/monocart-coverage-reports/blob/main/test/webpack.config-istanbul.js)
+    - Rollup: [rollup-plugin-istanbul](https://github.com/artberri/rollup-plugin-istanbul)
+    - Vite: [vite-plugin-istanbul](https://github.com/ifaxity/vite-plugin-istanbul)
+- Browser
+    > Collecting coverage data from `window.__coverage__`, example: [test-istanbul.js](https://github.com/cenfun/monocart-coverage-reports/blob/main/test/test-istanbul.js)
+- Node.js
+    > Collecting coverage data from `global.__coverage__`
+
+## Collecting V8 Coverage Data
+- For source code: enable `sourcemap` and do not compress/minify:
+    - Webpack: with `source-map` [devtool](https://webpack.js.org/configuration/devtool/) and `development` [mode](https://webpack.js.org/configuration/mode/), example [webpack.config-v8.js](https://github.com/cenfun/monocart-coverage-reports/blob/main/test/webpack.config-v8.js)
+    - Rollup: [options](https://rollupjs.org/configuration-options/) `sourcemap: true`
+- Browser (Chromium Only)
+    > Collecting coverage data with [Chromium Coverage API](#chromium-coverage-api), see [example](https://github.com/cenfun/monocart-coverage-reports/blob/main/test/test-v8.js)
+- Node.js
+    > see [Node.js V8 Coverage Report for Server Side](#nodejs-v8-coverage-report-for-server-side)
 
 
 ## Node.js V8 Coverage Report for Server Side
-There are two ways to collect native V8 coverage data and generate coverage report:
 - Using Node.js env [NODE_V8_COVERAGE](https://nodejs.org/docs/latest/api/cli.html#node_v8_coveragedir)=`dir`
-    - 1, Before running your Node.js application, set env `NODE_V8_COVERAGE`=`dir`. After the application runs and exits, the coverage data will be saved to the `dir` directory in JSON file format.
-    - 2, Read the json file(s) from the `dir` and generate coverage report. see example:
+    - Before running your Node.js application, set env `NODE_V8_COVERAGE`=`dir`. After the application runs and exits, the coverage data will be saved to the `dir` directory in JSON file format
+    - Read the json file(s) from the `dir` and generate coverage report
+    - example:
     > cross-env NODE_V8_COVERAGE=`.temp/v8-coverage` node [./test/test-node-env.js](./test/test-node-env.js) && node [./test/generate-node-report.js](./test/generate-node-report.js)
-    
-- Using [Inspector](https://nodejs.org/docs/latest/api/inspector.html) API
-   - 1, Connecting to the V8 inspector and enable V8 coverage.
-   ```js
-    const inspector = require('inspector');
-    const startV8Coverage = async () => {
-        const session = new inspector.Session();
-        session.connect();
-        await session.post('Profiler.enable');
-        await session.post('Profiler.startPreciseCoverage', {
-            callCount: true,
-            detailed: true
-        });
-        return session;
-    };
-   ```
-   - 2, Taking coverage data and adding to the report after your application runs.
-   ```js
-    const takeV8Coverage = (session) => {
-        return new Promise((resolve) => {
-            session.post('Profiler.takePreciseCoverage', (error, coverage) => {
-                if (error) {
-                    console.log(error);
-                    resolve();
-                    return;
-                }
-                resolve(coverage.result);
-            });
-        });
-    };
-    const coverageList = await takeV8Coverage(session);
-    // filter node internal files
-    coverageList = coverageList.filter((entry) => entry.url && !entry.url.startsWith('node:'));
-    await new CoverageReport(coverageOptions).add(coverageList);
-   ```
-   - 3, Generating coverage report. see example: [./test/test-node-ins.js](./test/test-node-ins.js)
-   ```js
-    await new CoverageReport(coverageOptions).generate();
-   ```
+
+- Using [V8](https://nodejs.org/docs/latest/api/v8.html#v8takecoverage) API
+    - Writing the coverage started by NODE_V8_COVERAGE to disk on demand with `v8.takeCoverage()` and stopping with `v8.stopCoverage()`. 
+    - example:
+    > cross-env NODE_V8_COVERAGE=`.temp/v8-coverage` node [./test/test-node-api.js](./test/test-node-api.js)
+
+- Using [Inspector](https://nodejs.org/docs/latest/api/inspector.html) API (or module [collect-v8-coverage](https://github.com/SimenB/collect-v8-coverage))
+   - Connecting to the V8 inspector and enable V8 coverage.
+   - Taking coverage data and adding to the report after your application runs.
+   - example: [./test/test-node-ins.js](./test/test-node-ins.js)
+   
+- Using [CDP](https://chromedevtools.github.io/devtools-protocol/) API
+    - Enabling [Node Debugging](https://nodejs.org/en/guides/debugging-getting-started/)
+    - Collecting coverage data with CDP API.
+    - example: [./test/test-node-cdp.js](./test/test-node-cdp.js)
 
 ## Using `entryFilter` and `sourceFilter` to filter the results for V8 report
-When you add coverage data with [Chromium Coverage API](#chromium-coverage-api), it actually contains the data of all entry files, for example:
+When V8 coverage data collected, it actually contains the data of all entry files, for example:
 ```
 1, dist/main.js
 2, dist/vendor.js
@@ -213,12 +225,63 @@ const coverageOptions = {
 };
 ```
 
-## Istanbul Coverage
+## How to convert V8 to Istanbul
+### Using [v8-to-istanbul](https://github.com/istanbuljs/v8-to-istanbul)
+It is a popular library which is used to convert V8 coverage format to istanbul's coverage format. Most test frameworks are using it, such as [Jest](https://github.com/jestjs/jest/), [Vitest](https://github.com/vitest-dev/vitest), but it has two major problems:
+- 1, The source mapping does not work well if the position is between the two consecutive mappings. for example: 
+```js
+const a = tf ? 'true' : 'false';
+               ^     ^  ^
+              m1     p  m2
+```
+> `m1` and `m2` are two consecutive mappings, `p` is the position we looking for. However, we can only get the position of the `m1` if we don't fix it to `p`. Especially the generated code is different from the original code, such as minified, compressed or converted, then it becomes very difficult to find the middle position between two mappings.
+
+- 2, The coverage of functions and branches is incorrect. V8 only provided coverage at functions and it's blocks. But if a function is uncovered (count = 0), there is no information for it's blocks and sub-level functions.
+And also there are some problems about counting the functions and branches:
+```js
+functions.forEach(block => {
+    block.ranges.forEach((range, i) => {
+        if (block.isBlockCoverage) {
+            // v8-to-istanbul: count range as branch here. 
+            // Problem: not every block is branch, and the first block is actually function.
+            if (block.functionName && i === 0) {
+                // v8-to-istanbul: count range as function here. 
+                // Problem: there is no function name if the function is anonymous or expression.
+            }
+        } else if (block.functionName) {
+            // v8-to-istanbul: count range as function here. 
+            // Problem: same as above function.
+        }
+    }
+});
+// Problem: When the function or parent-level function is uncovered, then its sub-level functions will never be counted.
+```
+see source code [v8-to-istanbul.js](https://github.com/istanbuljs/v8-to-istanbul/blob/master/lib/v8-to-istanbul.js)
+
+### How Monocart Works
+We have removed `v8-to-istanbul` because of the two major problems and implemented new converter:
+- 1, Trying to fix the middle position if not found the exact mapping.
+- 2, Finding all functions and branches by parsing the source code [AST](https://github.com/acornjs/acorn), however the V8 cannot provide effective branch coverage information, so the branches is still not perfect.
+
+| AST | V8 | 
+| :--------------| :------ | 
+| AssignmentPattern | 🛇 Not Support | 
+| ConditionalExpression | ✔ Not Perfect | 
+| IfStatement | ✔ Not Perfect | 
+| LogicalExpression | ✔ Not Perfect | 
+| SwitchStatement | ✔ Not Perfect | 
+
+## Chromium Coverage API
+- [V8 coverage report](https://v8.dev/blog/javascript-code-coverage) - Native support for JavaScript code coverage to V8. (Chromium only)
+- [Puppeteer Coverage Class](https://pptr.dev/api/puppeteer.coverage)
+- [Playwright Coverage Class](https://playwright.dev/docs/api/class-coverage)
+- [DevTools Protocol for Coverage](https://chromedevtools.github.io/devtools-protocol/tot/Profiler/#method-startPreciseCoverage)
+
+## Istanbul Introduction
 - [Istanbul coverage report](https://istanbul.js.org/) - Instrumenting source codes and generating coverage reports
 - [babel-plugin-istanbul](https://github.com/istanbuljs/babel-plugin-istanbul)
 - [istanbul-reports](https://github.com/istanbuljs/istanbuljs/tree/master/packages/istanbul-reports/lib)
 - [Code Coverage Introduction](https://docs.cypress.io/guides/tooling/code-coverage)
 
-
 ## Thanks
 - Special thanks to [@edumserrano](https://github.com/edumserrano)

package/lib/converter/ast.js

@@ -162,6 +162,7 @@ const getJsAstInfo = (item, coverageList) => {
         allowReturnOutsideFunction: true,
         allowImportExportEverywhere: true,
         allowSuperOutsideMethod: true,
+        allowAwaitOutsideFunction: true,
         // first line: #!/usr/bin/env node
         allowHashBang: true
     };

package/lib/converter/collect-source-maps.js

@@ -79,56 +79,27 @@ const resolveSourceMap = (data) => {
     }
 };
 
-const collectInlineSourceMaps = async (v8list) => {
-    let count = 0;
-    const concurrency = new Concurrency();
-    for (const item of v8list) {
-
-        const { type, source } = item;
-
-        // only for js
-        if (type === 'js') {
-            const converter = convertSourceMap.fromSource(source);
-            if (converter) {
-                item.sourceMap = resolveSourceMap(converter.sourcemap);
-                count += 1;
-                // source map comments is inline source map, remove it because it is big
-                item.source = convertSourceMap.removeComments(source);
-
-                continue;
-            }
-            const sourceMapUrl = getSourceMapUrl(source, item.url);
-            if (sourceMapUrl) {
-                // console.log('========================', sourceMapUrl);
-                item.sourceMapUrl = sourceMapUrl;
-                concurrency.addItem(item);
-            }
-        }
-    }
-    await concurrency.start(async (item) => {
-        const data = await loadSourceMap(item.sourceMapUrl);
-        if (data) {
-            item.sourceMap = resolveSourceMap(data);
-            count += 1;
-            // source map comments is a link, no need remove
-        }
-    });
-
-    return count;
+const saveSourceFile = async (filePath, data) => {
+    await Util.writeFile(filePath, JSON.stringify(data));
 };
 
-const collectFileSourceMaps = async (v8list, options) => {
+const collectSourceMaps = async (v8list, options) => {
+
     let count = 0;
     const concurrency = new Concurrency();
     for (const item of v8list) {
 
         const {
-            type, url, source, id
+            type, url, id, source, sourceMap
         } = item;
 
-        // remove source just keep functions to reduce artifacts size
+        // source and sourceMap will be saved as separated file (could be cached)
+        // just keep functions coverage ( could be multiple times, will be merged )
+        // so remove source and sourceMap
         delete item.source;
+        delete item.sourceMap;
 
+        // source and sourceMap already saved
         const sourcePath = Util.resolveCacheSourcePath(options.cacheDir, id);
         if (fs.existsSync(sourcePath)) {
             continue;
@@ -137,18 +108,23 @@ const collectFileSourceMaps = async (v8list, options) => {
         const sourceData = {
             url,
             id,
-            source: convertSourceMap.removeComments(source)
+            // source,
+            source: convertSourceMap.removeComments(source),
+            // could be existed
+            sourceMap
         };
 
-        // only for js
-        if (type === 'js') {
-            const converter = convertSourceMap.fromSource(source);
-            if (converter) {
-                sourceData.sourceMap = resolveSourceMap(converter.sourcemap);
+        // check sourceMap only for js
+        if (type === 'js' && !sourceData.sourceMap) {
+            // from inline sync
+            const smc = convertSourceMap.fromSource(source);
+            if (smc) {
+                sourceData.sourceMap = resolveSourceMap(smc.sourcemap);
                 count += 1;
                 await saveSourceFile(sourcePath, sourceData);
                 continue;
             }
+            // from url async
             const sourceMapUrl = getSourceMapUrl(source, item.url);
             if (sourceMapUrl) {
                 concurrency.addItem({
@@ -160,10 +136,12 @@ const collectFileSourceMaps = async (v8list, options) => {
             }
         }
 
+        // no need check sourceMap
         await saveSourceFile(sourcePath, sourceData);
 
     }
 
+    // from url concurrency
     await concurrency.start(async (item) => {
         const sourceData = item.sourceData;
         const data = await loadSourceMap(item.sourceMapUrl);
@@ -175,19 +153,6 @@ const collectFileSourceMaps = async (v8list, options) => {
     });
 
     return count;
-};
-
-const saveSourceFile = async (filePath, data) => {
-    await Util.writeFile(filePath, JSON.stringify(data));
-};
-
-const collectSourceMaps = (v8list, options, inlineSourceMap) => {
-
-    if (inlineSourceMap) {
-        return collectInlineSourceMaps(v8list);
-    }
-
-    return collectFileSourceMaps(v8list, options);
 
 };
 

package/lib/converter/converter.js

@@ -475,7 +475,7 @@ const generateCoverageForDist = (item, state) => {
 
 // ========================================================================================================
 
-const decodeSourceMappings = async (item, state, originalDecodedMap) => {
+const decodeSourceMappings = async (state, originalDecodedMap) => {
 
     const generatedLocator = state.locator;
 
@@ -566,7 +566,7 @@ const getOriginalDecodedMappings = (originalDecodedMap, sourceIndex, locator) =>
     return decodedMappings;
 };
 
-const initOriginalList = (item, state, originalDecodedMap, options) => {
+const initOriginalList = (state, originalDecodedMap, options) => {
 
     // source filter
     let sourceFilter = options.sourceFilter;
@@ -580,6 +580,7 @@ const initOriginalList = (item, state, originalDecodedMap, options) => {
     const originalMap = new Map();
 
     const { sources, sourcesContent } = state.sourceMap;
+
     sources.forEach((sourcePath, sourceIndex) => {
 
         // filter
@@ -860,12 +861,12 @@ const unpackSourceMap = async (item, state, options) => {
     const time_start_decode = Date.now();
     const originalDecodedMap = new Map();
     // for find-original-range
-    state.decodedMappings = await decodeSourceMappings(item, state, originalDecodedMap);
+    state.decodedMappings = await decodeSourceMappings(state, originalDecodedMap);
     // only debug level
     Util.logTime(`decode source mappings: ${sourcePath}`, time_start_decode);
 
     // filter original list and init list
-    const originalMap = initOriginalList(item, state, originalDecodedMap, options);
+    const originalMap = initOriginalList(state, originalDecodedMap, options);
 
     originalDecodedMap.clear();
 

package/lib/generate.js

@@ -1,6 +1,7 @@
 const fs = require('fs');
 const path = require('path');
-
+const CG = require('console-grid');
+const EC = require('eight-colors');
 const Util = require('./utils/util.js');
 const {
     initIstanbulData, mergeIstanbulCoverage, saveIstanbulReports
@@ -72,6 +73,9 @@ const getReportGroup = (reports, lcov, dataType) => {
         'v8',
         'v8-json',
 
+        // both
+        'console-summary',
+
         // istanbul
         'clover',
         'cobertura',
@@ -95,6 +99,7 @@ const getReportGroup = (reports, lcov, dataType) => {
             return;
         }
 
+        // v8
         if (k.startsWith('v8')) {
             // v8
             if (!reportGroup.v8) {
@@ -104,6 +109,12 @@ const getReportGroup = (reports, lcov, dataType) => {
             return;
         }
 
+        // both
+        if (k === 'console-summary') {
+            reportGroup[k] = reportMap[k];
+            return;
+        }
+
         // istanbul
         if (!reportGroup.istanbul) {
             reportGroup.istanbul = {};
@@ -114,6 +125,8 @@ const getReportGroup = (reports, lcov, dataType) => {
     return reportGroup;
 };
 
+// ========================================================================================================
+
 
 const generateCoverageReports = async (dataList, options) => {
 
@@ -144,6 +157,8 @@ const generateCoverageReports = async (dataList, options) => {
 
 };
 
+// ========================================================================================================
+
 
 const getCoverageDataList = async (cacheDir) => {
     const files = fs.readdirSync(cacheDir).filter((f) => f.startsWith('coverage-'));
@@ -164,8 +179,105 @@ const getCoverageDataList = async (cacheDir) => {
     }
 };
 
+// ========================================================================================================
+
+const capitalizeFirstLetter = (string) => {
+    return string.charAt(0).toUpperCase() + string.slice(1);
+};
+
+const pFormatter = (v, row, column) => {
+    if (typeof v === 'number') {
+        const p = Util.PSF(v, 100, 2);
+        if (row.status === 'low') {
+            return EC.red(p);
+        }
+        if (row.status === 'medium') {
+            return EC.yellow(p);
+        }
+        if (row.status === 'high') {
+            return EC.green(p);
+        }
+    }
+    return v;
+};
+
+const nFormatter = (v) => {
+    if (typeof v === 'number') {
+        return Util.NF(v);
+    }
+    return v;
+};
+
+const showConsoleSummary = (coverageResults, options) => {
+
+    const reportGroup = options.reportGroup;
+    const consoleOptions = reportGroup['console-summary'];
+    if (!consoleOptions) {
+        return;
+    }
+
+    const {
+        summary, name, type
+    } = coverageResults;
+    if (name) {
+        EC.logCyan(name);
+    }
+
+    const indicators = {
+        v8: ['bytes', 'functions', 'branches', 'lines'],
+        istanbul: ['statements', 'functions', 'branches', 'lines']
+    };
+
+    const list = indicators[type] || indicators.v8;
+    const rows = list.map((k) => {
+        return {
+            ... summary[k],
+            name: capitalizeFirstLetter(k)
+        };
+    });
+
+    const columns = [{
+        id: 'name',
+        name: 'Name'
+    }, {
+        id: 'pct',
+        name: 'Coverage %',
+        align: 'right',
+        formatter: pFormatter
+    }, {
+        id: 'covered',
+        name: 'Covered',
+        align: 'right',
+        formatter: nFormatter
+    }, {
+        id: 'uncovered',
+        name: 'Uncovered',
+        align: 'right',
+        formatter: nFormatter
+    }, {
+        id: 'total',
+        name: 'Total',
+        align: 'right',
+        formatter: nFormatter
+    }];
+
+    if (type === 'istanbul') {
+        columns.splice(4, 0, {
+            id: 'skipped',
+            name: 'Skipped',
+            align: 'right',
+            formatter: nFormatter
+        });
+    }
+
+    CG({
+        columns,
+        rows
+    });
+};
 
 module.exports = {
     getCoverageDataList,
-    generateCoverageReports
+    generateCoverageReports,
+    showConsoleSummary
 };

package/lib/index.d.ts

@@ -28,6 +28,7 @@ export type ReportDescription =
     ['v8-json'] | ["v8-json", {
         outputFile?: string
     }] |
+    ['console-summary'] |
     ['clover'] | ['clover', {
         file?: string
     }] |

package/lib/index.js

@@ -4,7 +4,9 @@ const defaultOptions = require('./default/options.js');
 const Util = require('./utils/util.js');
 
 const { initV8ListAndSourcemap } = require('./v8/v8.js');
-const { getCoverageDataList, generateCoverageReports } = require('./generate.js');
+const {
+    getCoverageDataList, generateCoverageReports, showConsoleSummary
+} = require('./generate.js');
 
 class CoverageReport {
 
@@ -63,9 +65,7 @@ class CoverageReport {
 
         if (Array.isArray(data)) {
             results.type = 'v8';
-            // init v8list and unpack sourcemap
-            const inlineSourceMap = false;
-            results.data = await initV8ListAndSourcemap(data, this.options, inlineSourceMap);
+            results.data = await initV8ListAndSourcemap(data, this.options);
         } else {
             results.type = 'istanbul';
             results.data = data;
@@ -109,6 +109,8 @@ class CoverageReport {
             Util.rmSync(cacheDir);
         }
 
+        showConsoleSummary(coverageResults, this.options);
+
         const onEnd = this.options.onEnd;
         if (typeof onEnd === 'function') {
             await onEnd(coverageResults);

package/lib/istanbul/istanbul-summary.js

@@ -37,6 +37,19 @@ class IstanbulSummary extends ReportBase {
     }
 
     getReport() {
+
+        // remove branchesTrue
+        delete this.summary.branchesTrue;
+
+        // add uncovered
+        Object.keys(this.summary).forEach((id) => {
+            const item = this.summary[id];
+            // NOTE: skipped
+            item.uncovered = item.total - item.covered - item.skipped;
+        });
+
+        // console.log(this.summary);
+
         return {
             summary: this.summary,
             files: this.files

package/lib/utils/decode-mappings-worker.js

@@ -0,0 +1,9 @@
+const { parentPort } = require('worker_threads');
+const { decode } = require('../packages/monocart-coverage-vendor.js');
+
+parentPort.on('message', (message) => {
+    const result = decode(message);
+    parentPort.postMessage(result);
+});
+
+parentPort.postMessage('workerReady');

package/lib/utils/decode-mappings.js

@@ -1,49 +1,35 @@
-const {
-    Worker, isMainThread, parentPort
-} = require('worker_threads');
+const path = require('path');
+const { Worker } = require('worker_threads');
 const Util = require('./util.js');
 
-if (isMainThread) {
+// do NOT use isMainThread because it could be executed in worker too. (worker in worker)
 
-    const decodeMappings = (mappings = '') => {
-        if (typeof text !== 'string') {
-            mappings = String(mappings);
-        }
+const decodeMappings = (mappings = '') => {
+    if (typeof text !== 'string') {
+        mappings = String(mappings);
+    }
 
-        return new Promise((resolve) => {
+    return new Promise((resolve) => {
 
-            const worker = new Worker(__filename);
-
-            worker.on('message', (message) => {
-                if (message === 'workerReady') {
-                    worker.postMessage(mappings);
-                    return;
-                }
-                resolve(message);
-                worker.terminate();
-            });
-
-            worker.on('error', (e) => {
-                Util.logError(e.message);
-                resolve([]);
-                worker.terminate();
-            });
+        const workerPath = path.resolve(__dirname, 'decode-mappings-worker.js');
+        const worker = new Worker(workerPath);
 
+        worker.on('message', (message) => {
+            if (message === 'workerReady') {
+                worker.postMessage(mappings);
+                return;
+            }
+            resolve(message);
+            worker.terminate();
         });
-    };
-
-    module.exports = decodeMappings;
-
-} else {
 
-    const { decode } = require('../packages/monocart-coverage-vendor.js');
+        worker.on('error', (e) => {
+            Util.logError(e.message);
+            resolve([]);
+            worker.terminate();
+        });
 
-    parentPort.on('message', (message) => {
-        const result = decode(message);
-        parentPort.postMessage(result);
     });
+};
 
-    parentPort.postMessage('workerReady');
-
-}
-
+module.exports = decodeMappings;

package/lib/v8/v8.js

@@ -7,7 +7,7 @@ const { mergeScriptCovs } = require('../packages/monocart-coverage-vendor.js');
 const collectSourceMaps = require('../converter/collect-source-maps.js');
 const version = require('../../package.json').version;
 
-const initV8ListAndSourcemap = async (v8list, options, inlineSourceMap) => {
+const initV8ListAndSourcemap = async (v8list, options) => {
 
     // filter list first
     const entryFilter = options.entryFilter;
@@ -47,8 +47,8 @@ const initV8ListAndSourcemap = async (v8list, options, inlineSourceMap) => {
             data.type = 'js';
             data.functions = item.functions;
             data.source = item.source;
-            // useless here
-            // data.scriptId = item.scriptId;
+            // could be existed
+            data.sourceMap = item.sourceMap;
         } else if (item.ranges) {
             data.type = 'css';
             data.ranges = item.ranges;
@@ -72,7 +72,7 @@ const initV8ListAndSourcemap = async (v8list, options, inlineSourceMap) => {
 
     // collect sourcemap first
     const time_start = Date.now();
-    const count = await collectSourceMaps(v8list, options, inlineSourceMap);
+    const count = await collectSourceMaps(v8list, options);
     if (count) {
         // debug level time
         Util.logTime(`loaded ${count} sourcemaps`, time_start);

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "monocart-coverage-reports",
-    "version": "2.0.4",
+    "version": "2.0.6",
     "description": "Monocart coverage reports",
     "main": "lib/index.js",
     "exports": {
@@ -17,13 +17,15 @@
         "build-docs": "node ./scripts/build-docs.js",
         "build-test": "node ./scripts/build-test.js",
         "build": "sf lint && sf b -p && npm run build-test",
-        "test-node": "npm run test-node-env && npm run test-node-ins && npm run test-node-api",
+        "test-node": "npm run test-node-env && npm run test-node-ins && npm run test-node-api && npm run test-node-cdp",
         "test-node-env": "cross-env NODE_V8_COVERAGE=.temp/v8-coverage node ./test/test-node-env.js && node ./test/generate-node-report.js",
         "test-node-ins": "node ./test/test-node-ins.js",
         "test-node-api": "cross-env NODE_V8_COVERAGE=.temp/v8-coverage node ./test/test-node-api.js",
+        "test-node-cdp": "node --inspect=9229 ./test/test-node-cdp.js",
         "test-browser": "node ./test/test.js",
         "test": "npm run test-browser && npm run test-node && npm run build-docs",
         "dev": "sf d v8",
+        "open": "node ./scripts/open.js",
         "patch": "npm run build && sf publish patch -r"
     },
     "workspaces": [
@@ -46,11 +48,10 @@
         "istanbul-reports": "~3.1.6",
         "lz-utils": "~2.0.1",
         "monocart-code-viewer": "^1.0.13",
-        "monocart-formatter": "~2.2.0",
+        "monocart-formatter": "~2.2.1",
         "turbogrid": "~3.0.12"
     },
     "devDependencies": {
-        "cross-env": "^7.0.3",
         "eslint": "^8.56.0",
         "eslint-config-plus": "^1.0.6",
         "eslint-plugin-html": "^7.1.0",