前言
在平时自己由零搭建项目时,虽然基础配置都比较熟悉,比如配置 file-loader, url-loader, css-loader 等,配置不难,但究竟是怎么起作用的呢,今天就来说说如何编写一个 Webpack Loader。
Loader 作用
按我自己的简单理解,loader 通常指打包的方案,即按什么方式来处理打包,打包的时候它可以拿到模块源代码,经过特定 loader 的转换后返回新的结果。
比如 sass-loader 可以把 SCSS 代码转换成 CSS 代码
编写 Loader
保持功能单一
我们项目中可能会配置很多,但要记住,要保持一个 Loader 的功能单一,避免做多种功能,只需完成一种功能转换即可。
所以如 less 文件转换成 css 文件,也不是一步到位,而是 less-loader, css-loader, style-loader 几个 loader 的链式调用才能完成转换。
模块
因为 Webpack 本身是运行在 Node.js 之上的,一个 loader 其实就是一个 node 模块,这个模块导出的是一个函数,即:
module.exports = function (source) { // source 为 compiler 传递给 Loader 的一个文件的原内容 // 处理... return source // 需要返回处理后的内容 }
这个导出的函数的工作就是获得处理前的原内容,对原内容执行处理后,返回处理后的内容。
替换字符串的 loader
比如我们打包时,想要替换源文件的字符串,这时可以考虑使用 Loader,因为 loader 就是获得源文件内容然后对其进行处理,再返回。
比如 src 目录下有三个文件:
src/msg1.js
export const msg1 = '学习框架'
src/msg2.js
export const msg2 = '深入理解JS'
src/index.js
import { msg1 } from './msg1' import { msg2 } from './msg2' function print() { console.log(`输出:${msg1}, ${msg2}`) } print()
做的事情则是把 msg1 和 msg2 两个文件导入,然后输出两个字符串。
我们要做的事也很简单,把"框架"转为"React 框架", "JS"转为"JavaScript"。
新建 src/loaders/replaceLoader.js文件,
module.exports = function (source) { const handleContent = source.replace('框架', 'React框架').replace('JS', 'JavaScript') return handleContent }
就这样,loader 写完了!!!
上面我们讲到,source 是源文件内容,如果打印的话,则是:
使用 Loader
接下来,我们要来使用它,在根目录下新建文件 webpack.config.js
const path = require('path') module.exports = { mode: 'production', entry: './src/index.js', module: { rules: [ { test: /\.js$/, use: './src/loaders/replaceLoader.js', }, ], }, output: { path: path.resolve(__dirname, 'dist'), filename: '[name].js', }, }
执行npx webpack, 查看打包结果dist/main.js
(()=>{"use strict";console.log("输出:学习React框架, 深入理解JavaScript")})();
替换成功!
需要注意的是,use里面填写的 loader 是去node_modules目录里面找的,由于我们是自定义的 loader,所以不能直接写use: 'replaceLoader',但直接写路径的方式未免难看点,我们可以通过 webpack 来配置:
module.exports = { resolveLoader: { modules: ['node_modules', './src/loaders'], // node_modules找不到,就去./src/loaders找 }, module: { rules: [ { test: /\.js$/, use: 'replaceLoader', }, ], }, }
获取 loader 的 options
写完之后,让我们来想想,其实就是写一个功能函数嘛。
当然,这只是最简单的例子,如果 loader 可以传入参数呢,比如:
module: { rules: [ { test: /\.js$/, use: { loader: 'replaceLoader', options: { params: 'replaceString', }, }, }, ], },
这个时候可以使用this.query来获取,通过this.query.params就能拿到,这里需要注意的是,this 上下文是有用的,所以这个 loader 导出函数不能是箭头函数。
但 webpack 更推荐loader-utils模块来获取,它提供了许多有用的工具,最常用的一种工具是获取传递给 loader 的选项。
首先要安装
npm i -D loader-utils
修改src/loaders/replaceLoader.js
const { getOptions } = require('loader-utils') module.exports = function (source) { console.log(getOptions(this)) // { params: 'replaceString' } console.log(this.query.params) // replaceString const handleContent = source.replace('框架', 'React框架').replace('JS', 'JavaScript') return handleContent }
这里需要注意的是,getOptions(this)参数传入的是 this,也就是说
打印结果:
{ params: 'replaceString' }
{ params: 'replaceString' }
{ params: 'replaceString' }
this.callback()
上面都是返回原来内容转换后的内容,但有些场景下还需要返回其他东西比如 sourceMap
module.exports = function (source) { // 告诉 Webpack 返回的结果 this.callback(null, source, sourceMaps) }
另外也不需要 return 了,所以也可使用此 API 替代 return
const { getOptions } = require('loader-utils') module.exports = function (source) { const handleContent = source.replace('框架', 'React框架').replace('JS', 'JavaScript') this.callback(null, handleContent) }
自定义 loader 应用场景
在所有 function 外面加一层 try catch 代码块捕获错误,避免手动繁琐添加。
实现中英文替换:可以将文字用占位符如{{ title }}包裹,检测到占位符则根据环境变量替换为中英文。
Webpack,Loader
免责声明:本站文章均来自网站采集或用户投稿,网站不提供任何软件下载或自行开发的软件! 如有用户或公司发现本站内容信息存在侵权行为,请邮件告知! 858582#qq.com
稳了!魔兽国服回归的3条重磅消息!官宣时间再确认!
昨天有一位朋友在大神群里分享,自己亚服账号被封号之后居然弹出了国服的封号信息对话框。
这里面让他访问的是一个国服的战网网址,com.cn和后面的zh都非常明白地表明这就是国服战网。
而他在复制这个网址并且进行登录之后,确实是网易的网址,也就是我们熟悉的停服之后国服发布的暴雪游戏产品运营到期开放退款的说明。这是一件比较奇怪的事情,因为以前都没有出现这样的情况,现在突然提示跳转到国服战网的网址,是不是说明了简体中文客户端已经开始进行更新了呢?