前言
在前端开发中，我们经常需要对应用进行性能优化和错误调试等工作。而生产环境中的代码往往是压缩过的，调试起来很困难。此时，我们可以使用 instrumentation.js 这个 npm 包对代码进行源码映射，以便在生产环境下调试 JavaScript 代码。
安装
npm install instrumentation.js
使用
前置工作
在使用 instrumentation.js 前，我们需要先在应用中引入源码映射文件。可以通过 webpack 等工具进行配置，也可以手动将映射文件加入到项目中。
初始化
-- -------------------- ---- ------- ----- ---------- - ------------------------------ ----- -- - -------------- -- ------ ----- ---- - --------------------------- --------- -- -- ---------- -- ----- ---- - --- ------------ ----- --------- --------- ---------- ----------- ---
instrumentation.js 提供了一个 instrument 类，需要传入的参数为：
code：源代码fileName：包含.js后缀的文件名sourceMap：映射文件的路径，可以是相对路径或绝对路径
代码转换
// 转换代码 const transformedCode = inst.instrument();
在 instrument 实例上调用 instrument() 方法，会返回一个经过源码映射处理的新代码字符串。
代码还原
// 还原代码 const originalCode = inst.deinstrument(transformedCode);
在 instrument 实例上调用 deinstrument() 方法，会返回还原后的源代码字符串。该方法用于还原调试后的代码。
示例
const $button = document.querySelector('#button');
$button.addEventListener('click', () => {
console.log('Clicked!');
});假设上述代码保存在 app.js 文件中。现在我们需要对其进行源码映射处理以便在生产环境下调试。
首先，在运行之前需要先打包并生成源码映射文件。这里以 webpack 打包为例：
-- -------------------- ---- -------
----- ---- - ----------------
-------------- - -
------ -----------------
------- -
--------- -------------------------
--
-------- -------------
-------- -
--- -------------------
--------- ---------------------
---
--- ---------------------
--
------------- -
------------ -
------- -----
-
-
--上述代码配置了 devtool: 'source-map'，这样在打包时就会生成 .map 文件。
然后，在应用中引用 instrumentation.js 包：
-- -------------------- ---- ------- ------ ---------- ---- --------------------- ------ ------ ---- ------------------- ----- ---- - - ----- ------- - ---------------------------------- --------------------------------- -- -- - ------------------------ ----- ----- ---- - --- ------------ ----- --------- --------- ---------- ------- --- ----- --------------- - ------------------ ----------------------------- -- -- -- ----- ------- - ---------------------------------- -- --------------------------------- -------- ----------- - -- ------------------------ -- ---
在上述代码中，我们通过 import 语句引用了生成的源码映射文件。
最后，将经过源码映射处理的代码复制到生产环境中即可进行调试。由于该方法需要在生产环境下使用，建议开发者在开发环境下自行模拟并测试一遍。
总结
instrumentation.js 简单易用，但能够帮助我们在生产环境下进行 JavaScript 代码的调试，提高我们的前端开发效率。同时，使用该包也能帮助我们更好地了解 JavaScript 代码的执行过程。
在使用 instrumentation.js 时，需要注意源码映射文件的正确引入以及使用方式的正确性。对于具体的调试场景，可以结合实际情况灵活运用。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/6005725881e8991b448e876b