webpack自定义loader全面详解
什么是loader?
因为webpack不识别非js结尾的文件,所以需要借助loader来告诉webpack如何对这些文件进行处理和输出的 loader都有哪些类型
loader类型
loader在webpack 中有四种loader:
- pre(前置)
- normal(普通)
- inline(行内)
- post(后置)
loader的执行顺序:pre>normal>inline>loader
如何指定loader类型
在webpack中通过Rule.enforce来指定loader的类型
{
test: /\.less$/,
use: 'less-loader',
enforce: 'pre'
}
如果没有enforce就会指定为普通的loader
如何禁用一些loader?
比如说一个eslint-loader,有的的开发者可能使用不了,但是不能干扰到其他同事,可以选择直接禁用它
require('!inline-loader!./a.js')
使用 ! 禁用配置文件中的普通loader
require('-!inline-loader!./a.js')
使用-!禁用所有的前置和普通loader
require('!!inline-loader!./a.js')
使用!! 禁用所有的后置和普通loader
下面开始直奔主题,开始说说url-loader和file-loader
为什么要用url-loader和file-loader?
url-loader和file-loader在webpack中是最常用的两个loaderl了,首先这两个loader存在一个相同点,上面已经提到webpack不能处理像css,scss,less,jpg,svg或者是其他文件格式的资源,这个时候就需要借助这两个loader其中一个去处理。
下面说一下这两个loader的区别
相同点:这两个loader都是用来处理在webpack编译的时候不能识别的文件格式
不同点:url-loader会在特定的条件下将资源输出为base64编码格式,为什么说在特定条件下,用过此loader的人都知道有一个limit的配置,通过这个配置来识别文件以哪种格式输出,并且在他内部也引用了file-loader,file-loader就是讲webpack不能识别的文件进行编译,并输出到指定的目录,url-loader就相当于对file-loader进行了二次封装,所以现在还是url-loader用的比较多一些。
开发自定义两个loader,并分别实现url-loader和file-loader
在编写源码之前需要安装三个依赖,分别是:
- loader-utils
loader的工具库
- mime
文件类型匹配
- schema-utils
验证loader参数
file-loader
- 创建文件loader/file-loader.js
const LoaderUtils = require('loader-utils')
module.exports = function(content,map,mate){
// 1. 获取参数
var options = loaderUtils.getOptions(this) || {};
// 2. 是否使用ESM导出
const esModule = typeof options.esModule !== 'undefined' ? options.esModule : true;
// 3. 根据文件生成带hash值文件名
const publicPath = LoaderUtils.interpolateName(this,"[hash].[ext][query]",content);
// 4. 将文件输出出去
this.emitFile(publicPath,content)
// 5. export 文件名
return `${esModule ? 'export default' : 'module.exports ='}${publicPath}`;
}
// 需要处理 文件 ,图片等文件格式都是 buffer格式的 需要使用rawloader才能处理
module.exports.raw = true;
url-loader
- 创建文件loader/option.json
{
"type":"object",
"properties":{
"limit":{
"type":["string","number"]
},
"mimeType":{
"type":"string"
},
"esModule":{
"type":"boolean"
}
}
}
- 创建文件loader/url-loader.js
var loaderUtils = require("loader-utils");
var mime = require("mime");
var validate = require("schema-utils");
var schema = require('./option.json');
function shouldTransform(limit, size){
if (typeof limit === 'boolean') {
return limit;
}
if (typeof limit === 'string') {
return size <= parseInt(limit, 10);
}
if (typeof limit === 'number') {
return size <= limit;
}
return true;
}
module.exports = function(content) {
// 1. 获取参数
var query = loaderUtils.getOptions(this) || {};
// 2. 验证参数 - 当出现错误的时候会自动抛出错误
validate(schema, query,{name:'url-loader'});
// 3. 文件大小限制
var limit = (this.options && this.options.url && this.options.url.dataUrlLimit) || 0;
// 2.0+版本以后新增的esModuleApi
let esModule = query.esModule
// 类型
var mimetype = query.mimetype || query.minetype || mime.lookup(this.resourcePath);
// 通过文件大小
if(shouldTransform(query.limit,content.length)){
// 如果比较文件小于limit 以base64的形式去展示
return `${esModule ? 'export default' : 'module.exports ='}` + JSON.stringify("data:" + (mimetype ? mimetype + ";" : "") + "base64," + content.toString("base64"));
} else {
// 这里引入我们自己的file-loader
// 如果比较文件大于limit,以url的形式展示
var fileLoader = require("./file-loader.js");
return fileLoader.call(this, content);
}
}
module.exports.raw = true;
如何测试使用
在loader统计目录下创建webpack.config.js
,只需要验证url-loader就可以了,因为内部已经有file-loader的导入
// webpack.config.js 中
{
oneOf:[
{
test:/\.js$/,
use:[
{
test: /\.(png|jpe?g|gif|svg)(\?.*)?$/,
loader: './loader/url-loader.js',
exclude: [resolve('class="lazy" data-src/icons')],
options: {
limit: 10000,
// 名称
name: utils.assetsPath('img/[name].[hash:7].[ext]')
}
},
]
}
]
},
本篇文章主要介绍loader的基础知识和如何去开发自定义loader,并介绍了两个常用的loaderurl-loader
和file-loader
,也进行了基本的实现,通过本片文章希望你能对webpack的loader的使用以及开发有一个基本的认识,更多关于webpack自定义loader的资料请关注编程网其它相关文章!
免责声明:
① 本站未注明“稿件来源”的信息均来自网络整理。其文字、图片和音视频稿件的所属权归原作者所有。本站收集整理出于非商业性的教育和科研之目的,并不意味着本站赞同其观点或证实其内容的真实性。仅作为临时的测试数据,供内部测试之用。本站并未授权任何人以任何方式主动获取本站任何信息。
② 本站未注明“稿件来源”的临时测试数据将在测试完成后最终做删除处理。有问题或投稿请发送至: 邮箱/279061341@qq.com QQ/279061341