Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

fix: Produce properly merged source-maps when inputSourceMap is provided #487

Merged
merged 1 commit into from Nov 1, 2019
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
4 changes: 1 addition & 3 deletions packages/istanbul-lib-instrument/package.json
Expand Up @@ -13,18 +13,16 @@
"prepublish": "npm run release"
},
"dependencies": {
"@babel/generator": "^7.6.2",
"@babel/core": "^7.6.2",
"@babel/parser": "^7.6.2",
"@babel/template": "^7.6.0",
"@babel/traverse": "^7.6.2",
"@babel/types": "^7.6.1",
"@istanbuljs/schema": "^0.1.0",
"istanbul-lib-coverage": "^3.0.0-alpha.1",
"semver": "^6.3.0"
},
"devDependencies": {
"@babel/cli": "^7.6.2",
"@babel/core": "^7.6.2",
"@babel/plugin-transform-modules-commonjs": "^7.6.0",
"@babel/register": "^7.6.2",
"chai": "^4.2.0",
Expand Down
84 changes: 49 additions & 35 deletions packages/istanbul-lib-instrument/src/instrumenter.js
Expand Up @@ -2,10 +2,7 @@
Copyright 2012-2015, Yahoo Inc.
Copyrights licensed under the New BSD License. See the accompanying LICENSE file for terms.
*/
import * as parser from '@babel/parser';
import * as t from '@babel/types';
import traverse from '@babel/traverse';
import generate from '@babel/generator';
import { transformSync } from '@babel/core';
import { defaults } from '@istanbuljs/schema';
import programVisitor from './visitor';
import readInitialCoverage from './read-coverage';
Expand Down Expand Up @@ -55,50 +52,67 @@ class Instrumenter {
throw new Error('Code must be a string');
}
filename = filename || String(new Date().getTime()) + '.js';
const opts = this.opts;
const ast = parser.parse(code, {
allowReturnOutsideFunction: opts.autoWrap,
sourceType: opts.esModules ? 'module' : 'script',
plugins: opts.parserPlugins
});
const ee = programVisitor(t, filename, {
coverageVariable: opts.coverageVariable,
coverageGlobalScope: opts.coverageGlobalScope,
coverageGlobalScopeFunc: opts.coverageGlobalScopeFunc,
ignoreClassMethods: opts.ignoreClassMethods,
inputSourceMap
});
const { opts } = this;
let output = {};
const visitor = {
Program: {
enter: ee.enter,
exit(path) {
output = ee.exit(path);
}
}
};
traverse(ast, visitor);

const generateOptions = {
const babelOpts = {
configFile: false,
babelrc: false,
ast: true,
filename: filename || String(new Date().getTime()) + '.js',
inputSourceMap,
sourceMaps: opts.produceSourceMap,
compact: opts.compact,
comments: opts.preserveComments,
sourceMaps: opts.produceSourceMap,
sourceFileName: filename
parserOpts: {
allowReturnOutsideFunction: opts.autoWrap,
sourceType: opts.esModules ? 'module' : 'script',
plugins: opts.parserPlugins
},
plugins: [
[
({ types }) => {
const ee = programVisitor(types, filename, {
coverageVariable: opts.coverageVariable,
coverageGlobalScope: opts.coverageGlobalScope,
coverageGlobalScopeFunc:
opts.coverageGlobalScopeFunc,
ignoreClassMethods: opts.ignoreClassMethods,
inputSourceMap
});

return {
visitor: {
Program: {
enter: ee.enter,
exit(path) {
output = ee.exit(path);
}
}
}
};
}
]
]
};
const codeMap = generate(ast, generateOptions, code);
if (output && output.fileCoverage) {
this.fileCoverage = output.fileCoverage;
} else {

const codeMap = transformSync(code, babelOpts);

if (!output || !output.fileCoverage) {
const initialCoverage =
readInitialCoverage(ast) ||
readInitialCoverage(codeMap.ast) ||
/* istanbul ignore next: paranoid check */ {};
this.fileCoverage = initialCoverage.coverageData;
this.sourceMap = inputSourceMap;
return code;
}

this.fileCoverage = output.fileCoverage;
this.sourceMap = codeMap.map;
const cb = this.opts.sourceMapUrlCallback;
if (cb && output.sourceMappingURL) {
cb(filename, output.sourceMappingURL);
}

return codeMap.code;
}
/**
Expand Down
3 changes: 1 addition & 2 deletions packages/istanbul-lib-instrument/src/read-coverage.js
@@ -1,6 +1,5 @@
import { parse } from '@babel/parser';
import traverse from '@babel/traverse';
import * as t from '@babel/types';
import { defaults } from '@istanbuljs/schema';
import { MAGIC_KEY, MAGIC_VALUE } from './constants';

Expand Down Expand Up @@ -33,7 +32,7 @@ export default function readInitialCoverage(code) {
const { node } = path;
if (
!node.computed &&
t.isIdentifier(node.key) &&
path.get('key').isIdentifier() &&
node.key.name === MAGIC_KEY
) {
const magicValue = path.get('value').evaluate();
Expand Down
19 changes: 14 additions & 5 deletions packages/istanbul-lib-instrument/test/already-instrumented.test.js
Expand Up @@ -3,10 +3,13 @@
import { assert } from 'chai';
import Instrumenter from '../src/instrumenter';

function instrument(code) {
// XXX produceSourceMap: true produces an altered source-map for the second run.
const instrumenter = new Instrumenter({ produceSourceMap: false });
const result = instrumenter.instrumentSync(code, __filename);
function instrument(code, inputSourceMap) {
const instrumenter = new Instrumenter({ compact: false });
const result = instrumenter.instrumentSync(
code,
__filename,
inputSourceMap
);
return {
code: result,
coverageData: instrumenter.lastFileCoverage(),
Expand All @@ -17,6 +20,12 @@ function instrument(code) {
const instrumented = instrument(`console.log('basic test');`);

it('should not alter already instrumented code', () => {
const result = instrument(instrumented.code);
const result = instrument(instrumented.code, instrumented.sourceMap);
[instrumented, result].forEach(({ sourceMap }) => {
// XXX Ignore source-map difference caused by:
// https://github.com/babel/babel/issues/10518
delete sourceMap.mappings;
delete sourceMap.names;
});
assert.deepEqual(instrumented, result);
});
3 changes: 1 addition & 2 deletions packages/istanbul-lib-instrument/test/plugins.test.js
Expand Up @@ -25,8 +25,7 @@ describe('plugins', () => {
try {
generateCode(codeNeedDecoratorPlugin);
} catch (e) {
const expected = `This experimental syntax requires enabling one of the following parser plugin(s): 'decorators-legacy, decorators'`;
assert.ok(e.message.includes(expected));
assert.ok(e);
done();
}
});
Expand Down
Expand Up @@ -14,11 +14,9 @@ tests:
name: without input source map
code: |
output = "test"
inputSourceMap: undefined
tests:
- name: is not set on the coverage object
args: []
out: "test"
lines: { '1': 1 }
statements: { '0': 1 }
inputSourceMap: undefined