Sourcemapping

介绍

一个本地JavaScript混淆堆栈解析npm命令行工具，用于收集外网JavaScript错误日志的解析。考虑到发布环境不attach sourcemap文件，收集到的错误堆栈都是混淆过的，需要一个解析工具进行解析，映射到源文件。

• 本工具基于官方映射工具source-map以及error-stack-parser工具
• 专门针对前端window.onerror捕捉到的JSON.stringfy(errorObj.stack)进行解析
• 根据堆栈中的每一帧信息找指定路径下对应的sourcemap文件进行解析，最终生成映射到源码后的堆栈信息

用法

需要传入window.onerror中捕获的JSON.stringfy(errorObj.stack)即需要被解析的堆栈字符串，以及存放sourcemap文件的相对路径。

sourcemap文件命名为各压缩混淆工具的默认规则:javascript文件名.map，需要直接存放在指定路径下

安装

npm install sourcemapping -g

Usage: sourcemapping [options]
 
Options:
  -v, --version         output the version number
  -s, --stack <string>  stack string which can obtain from JSON.stringfy(Error.stack)
  -m, --map <string>    sourcemap dir path. Where to find sourcemap
  -h, --help            output usage information
 
sourcemapping -s "ReferenceError: exclued is not defined\n    at getParameterByName (http://localhost:7777/aabbcc/logline.min.js:1:9827)\n    at http://localhost:7777/aabbcc/index.js:15:11" -m "./test"

输出

----Sourcemap Result----
Uncaught ReferenceError: exclued is not defined
    at Logline (../src/logline.js:62:31)
    at (index.js:15:11)
------------------------

测试

工具使用TypeScript编写，修改源码后调试测试可以使用如下命令:

npm install
npm run test