.
This commit is contained in:
444
qwen/nodejs/node_modules/istanbul-lib-coverage/lib/file-coverage.js
generated
vendored
Normal file
444
qwen/nodejs/node_modules/istanbul-lib-coverage/lib/file-coverage.js
generated
vendored
Normal file
@@ -0,0 +1,444 @@
|
||||
/*
|
||||
Copyright 2012-2015, Yahoo Inc.
|
||||
Copyrights licensed under the New BSD License. See the accompanying LICENSE file for terms.
|
||||
*/
|
||||
'use strict';
|
||||
|
||||
const percent = require('./percent');
|
||||
const dataProperties = require('./data-properties');
|
||||
const { CoverageSummary } = require('./coverage-summary');
|
||||
|
||||
// returns a data object that represents empty coverage
|
||||
function emptyCoverage(filePath, reportLogic) {
|
||||
const cov = {
|
||||
path: filePath,
|
||||
statementMap: {},
|
||||
fnMap: {},
|
||||
branchMap: {},
|
||||
s: {},
|
||||
f: {},
|
||||
b: {}
|
||||
};
|
||||
if (reportLogic) cov.bT = {};
|
||||
return cov;
|
||||
}
|
||||
|
||||
// asserts that a data object "looks like" a coverage object
|
||||
function assertValidObject(obj) {
|
||||
const valid =
|
||||
obj &&
|
||||
obj.path &&
|
||||
obj.statementMap &&
|
||||
obj.fnMap &&
|
||||
obj.branchMap &&
|
||||
obj.s &&
|
||||
obj.f &&
|
||||
obj.b;
|
||||
if (!valid) {
|
||||
throw new Error(
|
||||
'Invalid file coverage object, missing keys, found:' +
|
||||
Object.keys(obj).join(',')
|
||||
);
|
||||
}
|
||||
}
|
||||
|
||||
const keyFromLoc = ({ start, end }) =>
|
||||
`${start.line}|${start.column}|${end.line}|${end.column}`;
|
||||
|
||||
const isObj = o => !!o && typeof o === 'object';
|
||||
const isLineCol = o =>
|
||||
isObj(o) && typeof o.line === 'number' && typeof o.column === 'number';
|
||||
const isLoc = o => isObj(o) && isLineCol(o.start) && isLineCol(o.end);
|
||||
const getLoc = o => (isLoc(o) ? o : isLoc(o.loc) ? o.loc : null);
|
||||
|
||||
// When merging, we can have a case where two ranges cover
|
||||
// the same block of code with `hits=1`, and each carve out a
|
||||
// different range with `hits=0` to indicate it's uncovered.
|
||||
// Find the nearest container so that we can properly indicate
|
||||
// that both sections are hit.
|
||||
// Returns null if no containing item is found.
|
||||
const findNearestContainer = (item, map) => {
|
||||
const itemLoc = getLoc(item);
|
||||
if (!itemLoc) return null;
|
||||
// the B item is not an identified range in the A set, BUT
|
||||
// it may be contained by an identified A range. If so, then
|
||||
// any hit of that containing A range counts as a hit of this
|
||||
// B range as well. We have to find the *narrowest* containing
|
||||
// range to be accurate, since ranges can be hit and un-hit
|
||||
// in a nested fashion.
|
||||
let nearestContainingItem = null;
|
||||
let containerDistance = null;
|
||||
let containerKey = null;
|
||||
for (const [i, mapItem] of Object.entries(map)) {
|
||||
const mapLoc = getLoc(mapItem);
|
||||
if (!mapLoc) continue;
|
||||
// contained if all of line distances are > 0
|
||||
// or line distance is 0 and col dist is >= 0
|
||||
const distance = [
|
||||
itemLoc.start.line - mapLoc.start.line,
|
||||
itemLoc.start.column - mapLoc.start.column,
|
||||
mapLoc.end.line - itemLoc.end.line,
|
||||
mapLoc.end.column - itemLoc.end.column
|
||||
];
|
||||
if (
|
||||
distance[0] < 0 ||
|
||||
distance[2] < 0 ||
|
||||
(distance[0] === 0 && distance[1] < 0) ||
|
||||
(distance[2] === 0 && distance[3] < 0)
|
||||
) {
|
||||
continue;
|
||||
}
|
||||
if (nearestContainingItem === null) {
|
||||
containerDistance = distance;
|
||||
nearestContainingItem = mapItem;
|
||||
containerKey = i;
|
||||
continue;
|
||||
}
|
||||
// closer line more relevant than closer column
|
||||
const closerBefore =
|
||||
distance[0] < containerDistance[0] ||
|
||||
(distance[0] === 0 && distance[1] < containerDistance[1]);
|
||||
const closerAfter =
|
||||
distance[2] < containerDistance[2] ||
|
||||
(distance[2] === 0 && distance[3] < containerDistance[3]);
|
||||
if (closerBefore || closerAfter) {
|
||||
// closer
|
||||
containerDistance = distance;
|
||||
nearestContainingItem = mapItem;
|
||||
containerKey = i;
|
||||
}
|
||||
}
|
||||
return containerKey;
|
||||
};
|
||||
|
||||
// either add two numbers, or all matching entries in a number[]
|
||||
const addHits = (aHits, bHits) => {
|
||||
if (typeof aHits === 'number' && typeof bHits === 'number') {
|
||||
return aHits + bHits;
|
||||
} else if (Array.isArray(aHits) && Array.isArray(bHits)) {
|
||||
return aHits.map((a, i) => (a || 0) + (bHits[i] || 0));
|
||||
}
|
||||
return null;
|
||||
};
|
||||
|
||||
const addNearestContainerHits = (item, itemHits, map, mapHits) => {
|
||||
const container = findNearestContainer(item, map);
|
||||
if (container) {
|
||||
return addHits(itemHits, mapHits[container]);
|
||||
} else {
|
||||
return itemHits;
|
||||
}
|
||||
};
|
||||
|
||||
const mergeProp = (aHits, aMap, bHits, bMap, itemKey = keyFromLoc) => {
|
||||
const aItems = {};
|
||||
for (const [key, itemHits] of Object.entries(aHits)) {
|
||||
const item = aMap[key];
|
||||
aItems[itemKey(item)] = [itemHits, item];
|
||||
}
|
||||
const bItems = {};
|
||||
for (const [key, itemHits] of Object.entries(bHits)) {
|
||||
const item = bMap[key];
|
||||
bItems[itemKey(item)] = [itemHits, item];
|
||||
}
|
||||
const mergedItems = {};
|
||||
for (const [key, aValue] of Object.entries(aItems)) {
|
||||
let aItemHits = aValue[0];
|
||||
const aItem = aValue[1];
|
||||
const bValue = bItems[key];
|
||||
if (!bValue) {
|
||||
// not an identified range in b, but might be contained by one
|
||||
aItemHits = addNearestContainerHits(aItem, aItemHits, bMap, bHits);
|
||||
} else {
|
||||
// is an identified range in b, so add the hits together
|
||||
aItemHits = addHits(aItemHits, bValue[0]);
|
||||
}
|
||||
mergedItems[key] = [aItemHits, aItem];
|
||||
}
|
||||
// now find the items in b that are not in a. already added matches.
|
||||
for (const [key, bValue] of Object.entries(bItems)) {
|
||||
let bItemHits = bValue[0];
|
||||
const bItem = bValue[1];
|
||||
if (mergedItems[key]) continue;
|
||||
// not an identified range in b, but might be contained by one
|
||||
bItemHits = addNearestContainerHits(bItem, bItemHits, aMap, aHits);
|
||||
mergedItems[key] = [bItemHits, bItem];
|
||||
}
|
||||
|
||||
const hits = {};
|
||||
const map = {};
|
||||
|
||||
Object.values(mergedItems).forEach(([itemHits, item], i) => {
|
||||
hits[i] = itemHits;
|
||||
map[i] = item;
|
||||
});
|
||||
|
||||
return [hits, map];
|
||||
};
|
||||
|
||||
/**
|
||||
* provides a read-only view of coverage for a single file.
|
||||
* The deep structure of this object is documented elsewhere. It has the following
|
||||
* properties:
|
||||
*
|
||||
* * `path` - the file path for which coverage is being tracked
|
||||
* * `statementMap` - map of statement locations keyed by statement index
|
||||
* * `fnMap` - map of function metadata keyed by function index
|
||||
* * `branchMap` - map of branch metadata keyed by branch index
|
||||
* * `s` - hit counts for statements
|
||||
* * `f` - hit count for functions
|
||||
* * `b` - hit count for branches
|
||||
*/
|
||||
class FileCoverage {
|
||||
/**
|
||||
* @constructor
|
||||
* @param {Object|FileCoverage|String} pathOrObj is a string that initializes
|
||||
* and empty coverage object with the specified file path or a data object that
|
||||
* has all the required properties for a file coverage object.
|
||||
*/
|
||||
constructor(pathOrObj, reportLogic = false) {
|
||||
if (!pathOrObj) {
|
||||
throw new Error(
|
||||
'Coverage must be initialized with a path or an object'
|
||||
);
|
||||
}
|
||||
if (typeof pathOrObj === 'string') {
|
||||
this.data = emptyCoverage(pathOrObj, reportLogic);
|
||||
} else if (pathOrObj instanceof FileCoverage) {
|
||||
this.data = pathOrObj.data;
|
||||
} else if (typeof pathOrObj === 'object') {
|
||||
this.data = pathOrObj;
|
||||
} else {
|
||||
throw new Error('Invalid argument to coverage constructor');
|
||||
}
|
||||
assertValidObject(this.data);
|
||||
}
|
||||
|
||||
/**
|
||||
* returns computed line coverage from statement coverage.
|
||||
* This is a map of hits keyed by line number in the source.
|
||||
*/
|
||||
getLineCoverage() {
|
||||
const statementMap = this.data.statementMap;
|
||||
const statements = this.data.s;
|
||||
const lineMap = Object.create(null);
|
||||
|
||||
Object.entries(statements).forEach(([st, count]) => {
|
||||
/* istanbul ignore if: is this even possible? */
|
||||
if (!statementMap[st]) {
|
||||
return;
|
||||
}
|
||||
const { line } = statementMap[st].start;
|
||||
const prevVal = lineMap[line];
|
||||
if (prevVal === undefined || prevVal < count) {
|
||||
lineMap[line] = count;
|
||||
}
|
||||
});
|
||||
return lineMap;
|
||||
}
|
||||
|
||||
/**
|
||||
* returns an array of uncovered line numbers.
|
||||
* @returns {Array} an array of line numbers for which no hits have been
|
||||
* collected.
|
||||
*/
|
||||
getUncoveredLines() {
|
||||
const lc = this.getLineCoverage();
|
||||
const ret = [];
|
||||
Object.entries(lc).forEach(([l, hits]) => {
|
||||
if (hits === 0) {
|
||||
ret.push(l);
|
||||
}
|
||||
});
|
||||
return ret;
|
||||
}
|
||||
|
||||
/**
|
||||
* returns a map of branch coverage by source line number.
|
||||
* @returns {Object} an object keyed by line number. Each object
|
||||
* has a `covered`, `total` and `coverage` (percentage) property.
|
||||
*/
|
||||
getBranchCoverageByLine() {
|
||||
const branchMap = this.branchMap;
|
||||
const branches = this.b;
|
||||
const ret = {};
|
||||
Object.entries(branchMap).forEach(([k, map]) => {
|
||||
const line = map.line || map.loc.start.line;
|
||||
const branchData = branches[k];
|
||||
ret[line] = ret[line] || [];
|
||||
ret[line].push(...branchData);
|
||||
});
|
||||
Object.entries(ret).forEach(([k, dataArray]) => {
|
||||
const covered = dataArray.filter(item => item > 0);
|
||||
const coverage = (covered.length / dataArray.length) * 100;
|
||||
ret[k] = {
|
||||
covered: covered.length,
|
||||
total: dataArray.length,
|
||||
coverage
|
||||
};
|
||||
});
|
||||
return ret;
|
||||
}
|
||||
|
||||
/**
|
||||
* return a JSON-serializable POJO for this file coverage object
|
||||
*/
|
||||
toJSON() {
|
||||
return this.data;
|
||||
}
|
||||
|
||||
/**
|
||||
* merges a second coverage object into this one, updating hit counts
|
||||
* @param {FileCoverage} other - the coverage object to be merged into this one.
|
||||
* Note that the other object should have the same structure as this one (same file).
|
||||
*/
|
||||
merge(other) {
|
||||
if (other.all === true) {
|
||||
return;
|
||||
}
|
||||
|
||||
if (this.all === true) {
|
||||
this.data = other.data;
|
||||
return;
|
||||
}
|
||||
|
||||
let [hits, map] = mergeProp(
|
||||
this.s,
|
||||
this.statementMap,
|
||||
other.s,
|
||||
other.statementMap
|
||||
);
|
||||
this.data.s = hits;
|
||||
this.data.statementMap = map;
|
||||
|
||||
const keyFromLocProp = x => keyFromLoc(x.loc);
|
||||
const keyFromLocationsProp = x => keyFromLoc(x.locations[0]);
|
||||
|
||||
[hits, map] = mergeProp(
|
||||
this.f,
|
||||
this.fnMap,
|
||||
other.f,
|
||||
other.fnMap,
|
||||
keyFromLocProp
|
||||
);
|
||||
this.data.f = hits;
|
||||
this.data.fnMap = map;
|
||||
|
||||
[hits, map] = mergeProp(
|
||||
this.b,
|
||||
this.branchMap,
|
||||
other.b,
|
||||
other.branchMap,
|
||||
keyFromLocationsProp
|
||||
);
|
||||
this.data.b = hits;
|
||||
this.data.branchMap = map;
|
||||
|
||||
// Tracking additional information about branch truthiness
|
||||
// can be optionally enabled:
|
||||
if (this.bT && other.bT) {
|
||||
[hits, map] = mergeProp(
|
||||
this.bT,
|
||||
this.branchMap,
|
||||
other.bT,
|
||||
other.branchMap,
|
||||
keyFromLocationsProp
|
||||
);
|
||||
this.data.bT = hits;
|
||||
}
|
||||
}
|
||||
|
||||
computeSimpleTotals(property) {
|
||||
let stats = this[property];
|
||||
|
||||
if (typeof stats === 'function') {
|
||||
stats = stats.call(this);
|
||||
}
|
||||
|
||||
const ret = {
|
||||
total: Object.keys(stats).length,
|
||||
covered: Object.values(stats).filter(v => !!v).length,
|
||||
skipped: 0
|
||||
};
|
||||
ret.pct = percent(ret.covered, ret.total);
|
||||
return ret;
|
||||
}
|
||||
|
||||
computeBranchTotals(property) {
|
||||
const stats = this[property];
|
||||
const ret = { total: 0, covered: 0, skipped: 0 };
|
||||
|
||||
Object.values(stats).forEach(branches => {
|
||||
ret.covered += branches.filter(hits => hits > 0).length;
|
||||
ret.total += branches.length;
|
||||
});
|
||||
ret.pct = percent(ret.covered, ret.total);
|
||||
return ret;
|
||||
}
|
||||
|
||||
/**
|
||||
* resets hit counts for all statements, functions and branches
|
||||
* in this coverage object resulting in zero coverage.
|
||||
*/
|
||||
resetHits() {
|
||||
const statements = this.s;
|
||||
const functions = this.f;
|
||||
const branches = this.b;
|
||||
const branchesTrue = this.bT;
|
||||
Object.keys(statements).forEach(s => {
|
||||
statements[s] = 0;
|
||||
});
|
||||
Object.keys(functions).forEach(f => {
|
||||
functions[f] = 0;
|
||||
});
|
||||
Object.keys(branches).forEach(b => {
|
||||
branches[b].fill(0);
|
||||
});
|
||||
// Tracking additional information about branch truthiness
|
||||
// can be optionally enabled:
|
||||
if (branchesTrue) {
|
||||
Object.keys(branchesTrue).forEach(bT => {
|
||||
branchesTrue[bT].fill(0);
|
||||
});
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* returns a CoverageSummary for this file coverage object
|
||||
* @returns {CoverageSummary}
|
||||
*/
|
||||
toSummary() {
|
||||
const ret = {};
|
||||
ret.lines = this.computeSimpleTotals('getLineCoverage');
|
||||
ret.functions = this.computeSimpleTotals('f', 'fnMap');
|
||||
ret.statements = this.computeSimpleTotals('s', 'statementMap');
|
||||
ret.branches = this.computeBranchTotals('b');
|
||||
// Tracking additional information about branch truthiness
|
||||
// can be optionally enabled:
|
||||
if (this.bT) {
|
||||
ret.branchesTrue = this.computeBranchTotals('bT');
|
||||
}
|
||||
return new CoverageSummary(ret);
|
||||
}
|
||||
}
|
||||
|
||||
// expose coverage data attributes
|
||||
dataProperties(FileCoverage, [
|
||||
'path',
|
||||
'statementMap',
|
||||
'fnMap',
|
||||
'branchMap',
|
||||
's',
|
||||
'f',
|
||||
'b',
|
||||
'bT',
|
||||
'all'
|
||||
]);
|
||||
|
||||
module.exports = {
|
||||
FileCoverage,
|
||||
// exported for testing
|
||||
findNearestContainer,
|
||||
addHits,
|
||||
addNearestContainerHits
|
||||
};
|
||||
Reference in New Issue
Block a user