javascript技巧

关注公众号 jb51net

关闭
首页 > 网络编程 > JavaScript > javascript技巧 > webpack自定义loader

webpack自定义loader全面详解

作者:摸鱼的汤姆

这篇文章主要为大家介绍了webpack自定义loader全面详解,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪

什么是loader?

因为webpack不识别非js结尾的文件,所以需要借助loader来告诉webpack如何对这些文件进行处理和输出的 loader都有哪些类型

loader类型

loader在webpack 中有四种loader:

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

在编写源码之前需要安装三个依赖,分别是:

file-loader

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

{
    "type":"object",
    "properties":{
         "limit":{
             "type":["string","number"]
         },
         "mimeType":{
              "type":"string"
         },
         "esModule":{
            "type":"boolean"
       } 
    }
}
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('src/icons')],
            options: {
            limit: 10000,
            // 名称
            name: utils.assetsPath('img/[name].[hash:7].[ext]')
            }
        },
        ]
    }
]
},

本篇文章主要介绍loader的基础知识和如何去开发自定义loader,并介绍了两个常用的loaderurl-loaderfile-loader,也进行了基本的实现,通过本片文章希望你能对webpack的loader的使用以及开发有一个基本的认识,更多关于webpack自定义loader的资料请关注脚本之家其它相关文章!

您可能感兴趣的文章:
阅读全文