source maps
文件,map
文件是一种对应编译文件和源文件的方法类型 | 含义 |
---|---|
source-map | 原始代码 最好的sourcemap质量有完整的结果,但是会很慢 |
eval-source-map | 原始代码 同样道理,但是最高的质量和最低的性能 |
cheap-module-eval-source-map | 原始代码(只有行内) 同样道理,但是更高的质量和更低的性能 |
cheap-eval-source-map | 转换代码(行内) 每个模块被eval执行,并且sourcemap作为eval的一个dataurl |
eval | 生成代码 每个模块都被eval执行,并且存在@sourceURL,带eval的构建模式能cache SourceMap |
cheap-source-map | 转换代码(行内) 生成的sourcemap没有列映射,从loaders生成的sourcemap没有被使用 |
cheap-module-source-map | 原始代码(只有行内) 与上面一样除了每行特点的从loader中进行映射 |
hidden-source-map | 隐藏sourcemap |
nosources-source-map | 控制台能正确提示报错的位置而不暴露源码 |
关键字 | 含义 |
---|---|
source-map | 产生.map文件 |
eval | 使用eval包裹模块代码 |
cheap | 不包含列信息(关于列信息的解释下面会有详细介绍)也不包含loader的sourcemap |
module | 包含loader的sourcemap(比如jsx to js ,babel的sourcemap),否则无法定义源文件 |
inline | 将.map作为DataURI嵌入,不单独生成.map文件 |
src\index.js
let a=1;
let b=2;
let c=3;
dist\main.js
({
"./src/index.js":
(function (module, exports) {
let a = 1;
let b = 2;
let c = 3;
})
});
//# sourceMappingURL=main.js.map
eval
执行代码 ({
"./src/index.js":
(function (module, exports) {
eval("let a=1;\r\nlet b=2;\r\nlet c=3;\n\n//# sourceURL=webpack:///./src/index.js?");
})
});
eval-source-map
就会带上源码的sourceMap.map
文件cache sourceMap
,从而rebuild的速度会比较快 ({
"./src/index.js":
(function (module, exports) {
eval("let a=1;\r\nlet b=2;\r\nlet c=3;//# sourceURL=[module]\n//# sourceMappingURL=data:application/json;charset=utf-8;base64,In0=\n//# sourceURL=webpack-internal:///./src/index.js\n");
})
});
devtool: "eval-source-map" is really as good as devtool: "source-map", but can cache SourceMaps for modules. It’s much faster for rebuilds.
inline
就是将map作为DataURI嵌入,不单独生成.map文件inline-source-map
({
"./src/index.js":
(function (module, exports) {
let a = 1;
let b = 2;
let c = 3;
})
});
//# sourceMappingURL=data:application/json;charset=utf-8;base64,eyJ2ZXJzaW9uIj
cheap(低开销)
的sourcemap,因为它没有生成列映射(column mapping),只是映射行数cheap-source-map
cheap-module-source-map
cnpm i webpack webpack-cli webpack-dev-server babel-loader @babel/core @babel/preset-env style-loader css-loader less-loader less file-loader url-loader -D
const HtmlWebpackPlugin = require('html-webpack-plugin');
module.exports = {
mode:'development',
devtool:'cheap-module-source-map',
entry:'./src/index.js',
module: {
rules: [
{
test: /\.js$/,
use: [{
loader:'babel-loader',
options:{
presets:["@babel/preset-env"]
}
}]
}
]
},
plugins:[
new HtmlWebpackPlugin({
template:'./src/index.html'
})
]
}
import './sum';
sum(1,2);
//console.log(window.a.b);
devtool: cheap-module-eval-source-map
hidden-source-map
script.js
let a=1;
let b=2;
let c=3;
java -jar compiler.jar --js script.js --create_source_map ./script-min.js.map --source_map_format=V3 --js_output_file script-min.js
script-min.js
var a=1,b=2,c=3;
script-min.js.map
{
"version":3,
"file":"script-min.js",
"lineCount":1,
"mappings":"AAAA,IAAIA,EAAE,CAAN,CACIC,EAAE,CADN,CAEIC,EAAE;",
"sources":["script.js"],
"names":["a","b","c"]
}
字段 | 含义 |
---|---|
version:Source | Source map的版本,目前为3 |
file:转换后的文件名。 | 转换后的文件名 |
sourceRoot | 转换前的文件所在的目录。如果与转换前的文件在同一目录,该项为空 |
sources | 转换前的文件,该项是一个数组,表示可能存在多个文件合并 |
names | 转换前的所有变量名和属性名 |
mappings | 记录位置信息的字符串 |
对应 | 含义 |
---|---|
第一层是行对应 | 以分号(;)表示,每个分号对应转换后源码的一行。所以,第一个分号前的内容,就对应源码的第一行,以此类推。 |
第二层是位置对应 | 以逗号(,)表示,每个逗号对应转换后源码的一个位置。所以,第一个逗号前的内容,就对应该行源码的第一个位置,以此类推。 |
第三层是位置转换 | 以VLQ编码表示,代表该位置对应的转换前的源码位置。 |
"mappings":"AAAA,IAAIA,EAAE,CAAN,CACIC,EAAE,CADN,CAEIC,EAAE;",
位置 | 含义 |
---|---|
第一位 | 表示这个位置在(转换后的代码的)的第几列 |
第二位 | 表示这个位置属于sources属性中的哪一个文件 |
第三位 | 表示这个位置属于转换前代码的第几行 |
第四位 | 表示这个位置属于转换前代码的第几列 |
第五位 | 表示这个位置属于names属性中的哪一个变量 |
首先,所有的值都是以0作为基数的。其次,第五位不是必需的,如果该位置没有对应names属性中的变量,可以省略第五位,再次,每一位都采用VLQ编码表示;由于VLQ编码是变长的,所以每一位可以由多个字符构成
如果某个位置是AAAAA,由于A在VLQ编码中表示0,因此这个位置的五个位实际上都是0。它的意思是,该位置在转换后代码的第0列,对应sources属性中第0个文件,属于转换前代码的第0行第0列,对应names属性中的第0个变量。
let binary = 137..toString(2);
console.log(binary);//10001001
let padded = binary.padStart(Math.ceil(binary.length / 7) * 7, '0');
console.log(padded);//00000010001001
let groups = padded.match(/\d{7}/g);
groups = groups.map((group,index)=>(index==0?'1':'0')+group);
console.log(groups);// ['10000001','00001001']
let base64 = [
'A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'I', 'J', 'K', 'L', 'M', 'N', 'O', 'P',
'Q', 'R', 'S', 'T', 'U', 'V', 'W', 'X', 'Y', 'Z', 'a', 'b', 'c', 'd', 'e', 'f',
'g', 'h', 'i', 'j', 'k', 'l', 'm', 'n', 'o', 'p', 'q', 'r', 's', 't', 'u', 'v',
'w', 'x', 'y', 'z', '0', '1', '2', '3', '4', '5', '6', '7', '8', '9', '+', '/'
];
/**
* 1. 将137改写成二进制形式 10001001
* 2. 127是正数,末位补0 100010010
* 3. 五位一组做分组,不足的补0 01000 10010
* 4. 将组倒序排序 10010 01000
* 5. 最后一组开头补0,其余补1 110010 001000
* 6. 转64进制 y和I
*/
function encode(num) {
//1. 将137改写成二进制形式,如果是负数的话是绝对值转二进制
let binary = (Math.abs(num)).toString(2);
//2.正数最后边补0,负数最右边补1,127是正数,末位补0 100010010
binary = num >= 0 ? binary + '0' : binary + '1';
//3.五位一组做分组,不足的补0 01000 10010
let zero = 5 - (binary.length % 5);
if (zero > 0) {
binary = binary.padStart(Math.ceil(binary.length / 5) * 5, '0');
}
let parts = [];
for (let i = 0; i < binary.length; i += 5) {
parts.push(binary.slice(i, i + 5));
}// 01000 10010
//4. 将组倒序排序 10010 01000
parts.reverse();// ['00000','00001']
//5. 最后一组开头补0,其余补1 110010 001000
for (let i = 0; i < parts.length; i++) {
if (i === parts.length - 1) {
parts[i] = '0' + parts[i];
} else {
parts[i] = '1' + parts[i];
}
}
//6.转64进制 y和I
let chars = [];
for (let i = 0; i < parts.length; i++) {
chars.push(base64[parseInt(parts[i], 2)]);
}
return chars.join('')
}
let result = encode(137);
console.log(result);
let base64 = [
'A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'I', 'J', 'K', 'L', 'M', 'N', 'O', 'P',
'Q', 'R', 'S', 'T', 'U', 'V', 'W', 'X', 'Y', 'Z', 'a', 'b', 'c', 'd', 'e', 'f',
'g', 'h', 'i', 'j', 'k', 'l', 'm', 'n', 'o', 'p', 'q', 'r', 's', 't', 'u', 'v',
'w', 'x', 'y', 'z', '0', '1', '2', '3', '4', '5', '6', '7', '8', '9', '+', '/'
];
function getValue(char) {
let index = base64.findIndex(item => item == char);//先找这个字符的索引
let str = (index).toString(2);//索引转成2进制
str = str.padStart(6, '0');//在前面补0补到6位
//最后一位是符号位,正数最后一位是0,负数最后一位为1
let sign = str.slice(-1)=='0'?1:-1;
//最后一组第一位为0,其它的第一位为1
str = str.slice(1, -1);
return parseInt(str, 2)*sign;
}
function decode(values) {
let parts = values.split(',');//分开每一个位置
let positions = [];
for(let i=0;i<parts.length;i++){
let part = parts[i];
let chars = part.split('');//得到每一个字符
let position = [];
for (let i = 0; i < chars.length; i++) {
position.push(getValue(chars[i]));//获取此编写对应的值
}
positions.push(position);
}
return positions;
}
let positions = decode('AAAA,IAAIA,EAAE,CAAN,CACIC,EAAE,CADN,CAEIC,EAAE');
//后列,哪个源文件,前行,前列,变量
console.log('positions',positions);
let offsets = positions.map(item=>[item[2],item[3],0,item[0],]);
console.log('offsets',offsets);
let origin = {x:0,y:0};
let target = {x:0,y:0};
let mapping=[];
for(let i=0;i<offsets.length;i++){
let [originX,originY,targetX,targetY] = offsets[i];
origin.x += originX;
origin.y += originY;
target.x += targetX;
target.y += targetY;
mapping.push(`[${origin.x},${origin.y}]=>[${target.x},${target.y}]`);
}
console.log('mapping',mapping);
positions [
[ 0, 0, 0, 0 ],
[ 4, 0, 0, 4, 0 ],
[ 2, 0, 0, 2 ],
[ 1, 0, 0, -6 ],
[ 1, 0, 1, 4, 1 ],
[ 2, 0, 0, 2 ],
[ 1, 0, -1, -6 ],
[ 1, 0, 2, 4, 1 ],
[ 2, 0, 0, 2 ]
]
offsets [
[ 0, 0, 0, 0 ],
[ 0, 4, 0, 4 ],
[ 0, 2, 0, 2 ],
[ 0, -6, 0, 1 ],
[ 1, 4, 0, 1 ],
[ 0, 2, 0, 2 ],
[ -1, -6, 0, 1 ],
[ 2, 4, 0, 1 ],
[ 0, 2, 0, 2 ]
]
mapping [
'[0,0]=>[0,0]',
'[0,4]=>[0,4]',
'[0,6]=>[0,6]',
'[0,0]=>[0,7]',
'[1,4]=>[0,8]',
'[1,6]=>[0,10]',
'[0,0]=>[0,11]',
'[2,4]=>[0,12]',
'[2,6]=>[0,14]'
]
webpack.config.js
const HtmlWebpackPlugin = require('html-webpack-plugin');
const FileManagerPlugin = require('filemanager-webpack-plugin');
const webpack = require('webpack');
module.exports = {
mode: 'production',
devtool: false,
entry: './src/index.js',
resolveLoader:{
modules:['node_modules','loaders']
},
module: {
rules: [
{
test: /\.js$/,
use: [{
loader: 'babel-loader',
options: {
presets: ["@babel/preset-env"]
}
}]
},
{
test: /\.scss$/,
use: [
{ loader: 'style-loader' },
{
loader: 'css-loader',
options: {
sourceMap: true,
importLoaders:2
}
},
//{ loader: "resolve-url-loader" },
{ loader: "resolve-scss-url-loader" },
{
loader: 'sass-loader',
options: { sourceMap: true }
}
]
},
{
test: /\.(jpg|png|gif|bmp)$/,
use: [
{ loader: 'url-loader' }
]
}
]
},
plugins: [
new HtmlWebpackPlugin({
template: './src/index.html'
}),
new webpack.SourceMapDevToolPlugin({
append: '//# sourceMappingURL=http://127.0.0.1:8081/[url]',
filename: '[file].map',
}),
new FileManagerPlugin({
onEnd: {
copy: [{
source: './dist/*.map',
destination: 'C:/aprepare/zhufengsourcemap/sourcemap',
}],
delete: ['./dist/*.map'],
archive: [{
source: './dist',
destination: './dist/dist.zip',
}]
}
})
]
}
regex:(?inx)http:\/\/localhost:8080\/(?<name>.+)$
*redir:http://127.0.0.1:8081/${name}
cnpm i source-map-loader -D
let a=1;
let b=2;
let c=3;
java -jar compiler.jar --js script.js --create_source_map ./script-min.js.map --source_map_format=V3 --js_output_file script-min.js
var a=1,b=2,c=3;
//# sourceMappingURL=script-min.js.map
{
"version":3,
"file":"script-min.js",
"lineCount":1,
"mappings":"AAAA,IAAIA,EAAE,CAAN,CACIC,EAAE,CADN,CAEIC,EAAE;",
"sources":["script.js"],
"names":["a","b","c"]
}
import './script-min.js';
webpack.config.js
const HtmlWebpackPlugin = require('html-webpack-plugin');
const FileManagerPlugin = require('filemanager-webpack-plugin');
const webpack = require('webpack');
module.exports = {
mode: 'development',
devtool: 'inline-source-map',
entry: './src/index.js',
resolveLoader:{
modules:['node_modules','loaders']
},
module: {
rules: [
+ {
+ test: /\.js$/,
+ use: ["source-map-loader"],
+ enforce: "pre"
+ },
{
test: /\.js$/,
use: [{
loader: 'babel-loader',
options: {
presets: ["@babel/preset-env"]
}
}]
},
{
test: /\.scss$/,
use: [
{ loader: 'style-loader' },
{
loader: 'css-loader',
options: {
sourceMap: true,
importLoaders:2
}
},
//{ loader: "resolve-url-loader" },
+ { loader: "resolve-scss-url-loader" },
{
loader: 'sass-loader',
options: { sourceMap: true }
}
]
},
{
test: /\.(jpg|png|gif|bmp)$/,
use: [
{ loader: 'url-loader' }
]
}
]
},
plugins: [
new HtmlWebpackPlugin({
template: './src/index.html'
})
]
}