你不懂的source map功能

最近负责做一个比较大型的前端编辑器项目,里面涉及很多前端npm包相互引用,为了更好的调试,需包与包的引用之间能够通过devtool调试,但是为了使用调试功能,必须source-map功能正常使用。

理想很完美 现实很残酷,业务项目Webpack启用后,控制台爆Warning ‘Failed to parse source map from ’,下面就一探究竟。

分析warning之前,先简单了解source-map的背景与原理。

一、背景

随着浏览器的性能与兼容性越来越好,业务逻辑的前移也越多,很多业务逻辑与效果让js来承担,加之代码也分模块书写,源代码都需要转换与压缩后才能投入生产使用。

源代码压缩后的代码,已经与源代码相差甚远,如果线上有错,debug变的困难重重

为了解决这个问题,发明了source-map这个玩意

二、source-map

source-map文件是一个json数据,目前在版本3的格式如下。

{
  "version": 3,   // 文件版本,必须是个正整数
  "file": "out.js", // 编译器生成后的文件
  "sourceRoot": "", // 源文件相对路径,如果都在当前路径上,为空
  "sources": [],  //  源文件列表
  "sourcesContent": [], // 源文件配置,当没有配置source的时候则使用这个
  "names": [], // 变量列表
  "mappings": "" // 映射表
}

mappings 数据结构

  • 生成后的文件,每一行的映射片段都会以分号(;)分隔开来,所以第一个分号前的内容就是对应源代码的第一行,以此类推
  • 第二层是位置对应,以逗号(,)表示,每个逗号对应转换后源码的一个位置,所以第一个逗号前的内容,就是对应该行源码的第一个位置,一次类推
  • 第三层是位置转换,以VLQ编码表示,代表位置对应的转换前的源码位置

每个位置的映射,从左算起,有如下含义

  • 第一位,表示这个位置在转换后的代码的第几列
  • 第二位,表示这个位置属于sources属性中的哪一个文件
  • 第三位,表示这个位置属于转换前代码的第几行
  • 第四位,表示这个位置属于转换前代码的第几列
  • 第五位,表示这个位置属于names属性中的哪一个变量

webpack配置

业务项目配置

{
  devtool: "source-map"
}

但要加载npm里面的source-map文件,需要借助loader(source-map-loader)
配置项如下

module.exports = {
  module: {
    rules: [
      {
        test: /\.js$/,
        enforce: "pre",
        use: ["source-map-loader"],
      },
    ],
  },
};

配置完成后,借助chrome开发工具就可以使用与打断点了


参考目录
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容

  • 一直都或多或少听说过 source-map,但却从未仔细学习过其具体内容。谨以此篇文章,鞭策自己,砥砺前行。 一、...
    ebfc7d0362e4阅读 13,788评论 0 11
  • 入门与进阶 第一章 进入编程 1,如何快速运行一段js代码? 方式1:浏览器开发者工具。可以使用快捷键option...
    潇潇潇潇潇潇潇阅读 890评论 0 0
  • 部署前端之前,开发者通常会对代码进行打包压缩,这样可以减少代码大小,从而有效提高访问速度。然而,压缩代码的报错信息...
    Fundebug阅读 2,257评论 5 7
  • 访问http://ajax.googleapis.com/ajax/libs/jquery/1.9.0/jquer...
    老夫的天阅读 701评论 1 4
  • 久违的晴天,家长会。 家长大会开好到教室时,离放学已经没多少时间了。班主任说已经安排了三个家长分享经验。 放学铃声...
    飘雪儿5阅读 7,566评论 16 22