file-loader和url-loader的区别
什么是 url-loader
url-loader 会将引入的文件进行编码,生成 DataURL,相当于把文件翻译成了一串字符串,再把这个字符串打包到 JavaScript。
使用 base64 来加载图片也是有两面性的:
- 优点:节省请求,提高页面性能
- 缺点:增大本地文件大小,降低加载性能
所以我们得有取舍,只对部分小 size 的图片进行 base64 编码,其它的大图片还是发请求吧。
什么是 file-loader
在css文件中定义background的属性或者在html中引入image的src,我们知道在webpack打包后这些图片会打包至定义好的一个文件夹下,和开发时候的相对路径会不一样,这就会导致导入图片路径的错误。而file-loader正是为了解决此类问题而产生的,他修改打包后图片的储存路径,再根据配置修改我们引用的路径,使之对应引入
之间有什么联系呢?
url-loader内部封装了file-loader。url-loader不依赖于file-loader,即使用url-loader时,只需要安装url-loader即可,不需要安装file-loader。
通过上面的介绍,我们可以看到,url-loader工作分两种情况:
- 文件大小小于limit参数,url-loader将会把文件转为DataURL;
- 文件大小大于limit,url-loader会调用file-loader进行处理,参数也会直接传给file-loader。因此我们只需要安装url-loader即可
手写实现file-loader
file-loader 的工作流程如下:
-
通过 loaderUtils.interpolateName 方法可以根据 options.name 以及文件内容生成一个唯一的文件名 url(一般配置都会带上hash,否则很可能由于文件重名而冲突)
-
通过 this.emitFile(url, content) 告诉 webpack 我需要创建一个文件,webpack会根据参数创建对应的文件,放在 public path 目录下。
-
返回 'module.exports = webpack_public_path + '+ JSON.stringify(url) + ‘;’ ,这样就会把原来的文件路径替换为编译后的路径
对file-loader 中最重要的几行代码解释如下(我们自己来实现一个 file-loader 就只需要这几行代码就行了,完全可以正常运行且支持 name 配置):
var loaderUtils = require('loader-utils')
module.exports = function (content) {
// 获取options,就是 webpack 中对 file-loader 的配置,比如这里我们配置的是 `name=[name]_[hash].[ext]`
// 获取到的就是这样一个k-v 对象 { name: "[name]_[hash].[ext]" }
const options = loaderUtils.getOptions(this) || {};
// 这是 loaderUtils 的一个方法,可以根据 name 配置和 content 内容 生成一个文件名。为什么需要 文件内容呢?这是为了保证当文件内容没有发生变化的时候,名字中的 [hash] 字段也不会变。可以理解为用文件的内容作了一个hash
let url = loaderUtils.interpolateName(this, options.name, {
content
})
this.emitFile(url, content) // 告诉webpack,我要创建一个文件,文件名和内容,这样webpack就会帮你在 dist 目录下创建一个对应的文件
// 这里要用到一个变量,就是 __webpack_public_path__ ,这是一个由webpack提供的全局变量,是public的根路径
// 参见:https://webpack.js.org/guides/public-path/#on-the-fly
// 这里要注意一点:这个返回的字符串是一段JS,显然,他是在浏览器中运行的
// 举个栗子:
// css源码这样写:background-image: url('a.png')
// 编译后变成: background-image: require('xxxxxx.png')
// 这里的 require 语句返回的结果,就是下面的 exports 的字符串,也就是图片的路径
return 'module.exports = __webpack_public_path__ + '+ JSON.stringify(url)
}
// 一定别忘了这个,因为默认情况下 webpack 会把文件内容当做UTF8字符串处理,而我们的文件是二进制的,当做UTF8会导致图片格式错误。
// 因此我们需要指定webpack用 raw-loader 来加载文件的内容,而不是当做 UTF8 字符串传给我们
module.exports.raw = true
手写url-loader
url-loader 的工作流程如下:
- 获取 limit 参数
- 如果 文件大小在 limit 之类,则直接返回文件的 base64 编码后内容
- 如果超过了 limit ,则调用 file-loader
- 因为逻辑比较简单,这里直接放上源码以及我添加的注释:
module.exports = function(content) {
// 获取 options 配置,上面已经讲过了就不在重复
var options = loaderUtils.getOptions(this) || {};
// Options `dataUrlLimit` is backward compatibility with first loader versions
// limit 参数,只有文件大小小于这个数值的时候我们才进行base64编码,否则将直接调用 file-loader
var limit = options.limit || (this.options && this.options.url && this.options.url.dataUrlLimit);
if(limit) {
limit = parseInt(limit, 10);
}
var mimetype = options.mimetype || options.minetype || mime.lookup(this.resourcePath);
// No limits or limit more than content length
if(!limit || content.length < limit) {
if(typeof content === "string") {
content = new Buffer(content);
}
// 直接返回 base64 编码的内容
return "module.exports = " + JSON.stringify("data:" + (mimetype ? mimetype + ";" : "") + "base64," + content.toString("base64"));
}
// 超过了文件大小限制,那么我们将直接调用 file-loader 来加载
var fallback = options.fallback || "file-loader";
var fallbackLoader = require(fallback);
return fallbackLoader.call(this, content);
}
// 一定别忘了这个,因为默认情况下 webpack 会把文件内容当做UTF8字符串处理,而我们的文件是二进制的,当做UTF8会导致图片格式错误。
// 因此我们需要指定webpack用 raw-loader 来加载文件的内容,而不是当做 UTF8 字符串传给我们
// 参见:https://webpack.github.io/docs/loaders.html#raw-loader
module.exports.raw = true
总结
- file-loader 返回的是文件的路径
- url-loader 返回的是文件的base64编码
参考文献
- 详解webpack url-loader和file-loader:https://segmentfault.com/a/1190000018987483
-
webpack 源码解析:file-loader 和 url-loader:https://www.cnblogs.com/shiyunfront/articles/8944940.html
欢迎关注前端早茶,与广东靓仔携手共同进阶
前端早茶专注前端,一起结伴同行,紧跟业界发展步伐~
公众号作者:广东靓仔