webpack实战之手写一个loader和plugin

简介: 该文章详细讲解了如何从零开始编写一个自定义的Webpack Loader和Plugin,包括它们的工作原理、开发步骤以及如何将自定义的Loader和Plugin集成到Webpack配置中。

loader和plugin封面

🔔序言

对于 webpack 来说, loaderplugin 可以算是需求程度最为广泛的配置项了。但是呢,单单止步于配置可能还不够。如果我们自己有时候想要 diy 一个需求,但是 webpack 又没有相关的 loaderplugin 。那这个时候我们可能就得开始造点轮子来供给自己使用了。

因此,在今天的文章当中,将带领大家手写一个简易的 loaderplugin ,并学会如何在项目中运用自己所编写的 loaderplugin

一起来学习吧~📢

🎵一、如何编写一个Loader

1. 碎碎念

之前的文章中我们讲到了关于 loader 的一些配置。那如果把那些引用的 loader 改为我们写的 loader ,该怎么处理呢?

现在,我们来了解一下,如何手写一个简易的 loader ,并运用到我们的项目当中。

2. 项目结构

首先用一张图,来看我们的项目结构如下图所示:

loader项目结构

其中 loaders 文件夹下放置我们想要写的 loader ,同时里面的 replaceLoader.js 文件放置我们即将要写的 loader 的代码逻辑。之后,index.js 文件是我们的入口文件,放置我们的业务逻辑。 webpack.config.js 文件放置关于 webpack 的相关配置,而 dist 文件夹内的内容,放置的是我们通过 webpack 打包后,生成的打包文件。

3. 业务代码编写

(1)入口文件代码

现在,我们先来编写入口文件 index.js 的代码。具体代码如下:

console.log('hello monday');

(2)编写loader

入口文件的内容很简单,我们想要达到的目的就是输出 hello monday 这个语句。现在,我们来编写 loader 的内容,已达到对入口文件 index.js 的内容进行修改。 replaceLoader.js 文件的代码具体如下:

module.exports = function(source) {
   
    const result = source.replace('monday', 'mondaylab');
    this.callback(null, result);
}

以上的代码意思为,将入口文件 index.js 文件中的 monday 替换为 mondaylab 。这样写似乎没啥问题,但是大家有没有想过,我们有时候传的属性可能会很诡异,不一定每次都能像这样以字符串的形式来替换。

所以,我们引用 webpack 官方推荐的 loadertils 这个工具,来解决这个问题。

第一步: 安装 loader-utils 插件。具体命令如下:

npm install loader-utils --save-dev

第二步: 改造 loader 文件。接下来,我们对 replaceLoader.js 文件进行改造升级,具体代码如下:

const loaderUtils = require('loader-utils');

//用function的原因在于为了业务层可以调用this
//source为引入文件的源代码
module.exports = function(source) {
   
    //getOptions会自动地帮我们分析this.query,然后把参数的所有内容放在options里面去
    const options = loaderUtils.getOptions(this);

    const result = source.replace('monday', options.name);

    this.callback(null, result);
}

大家可以看到,通过使用 loaderUtils 插件,间接地,调用 getOptions 方法,来自动的帮我们分析 this.query ,从而取到我们想要的内容。

值得注意的是,我们还需要再了解一下 this.callback 的内容。

一般情况下,如果我们接收到了源代码 source ,那么现在我们只能对源代码做处理。但是呢,有的时候,我们想要使用一些 sourceMap ,或者对源代码分析好了之后,我们不仅想要返回源代码,还要把 sourceMap 也带回去。

因为我们 return 的时候只能 return 一个参数,其余的一些额外的内容就带不出去了。这个时候呢,我们就需要 this.callback 来帮我们把 sourceMap 给带出去。因此,一般用 this.callback 来返回内容。

(3)引用loader

现在,我们在 webpack.config.js 中,来引入我们上面的 loader具体配置如下:

const path = require('path');

module.exports = {
   
    mode: 'development',
    entry: {
   
        main: './src/index.js'
    },
    module: {
   
        rules: [{
   
            test: /\.js/,
            use: [
                {
   
                    loader: path.resolve(__dirname, './loaders/replaceLoader.js'),
                    //上面的options.name中的name
                    options: {
   
                        name: 'mondaylab'
                    }
                }   
            ]
        }]
    },
    output: {
   
        path: path.resolve(__dirname, 'dist'),
        filename: '[name].js' 
    }
}

通过以上方式,我们写了一个简易的 loader ,这个 loader 实现了将 monday 替换为 mondaylab 的功能。并且供我们在 webpack 中使用自己书写的 loader

(4)在loader里面做一些异步的操作

好了现在,如果我们想要给 loader 做一些异步操作,该怎么实现呢?

在我们所写的 loader 当中,加入异步操作,那么我们需要调用官方提供给我们的 this.async() 这个 API 来实现。现在,我们来改造一下 replaceLoader.js 文件的代码。具体代码如下:

const loaderUtils = require('loader-utils');

module.exports = function(source) {
   

    const options = loaderUtils.getOptions(this);
    //调用this.async()这个API,来给异步代码使用
    const callback = this.async();

    setTimeout(() => {
   
        const result = source.replace('monday', options.name);
        callback(null, result);
    }, 1000);
}

通过这种方式,我们就可以在 loader 中编写异步代码,来达到我们想要的效果。

(5)loader路径自定义

有一个很小的注意点就是,当我们在配置 webpack.config.js 文件中, loader 的路径时,每回都要 path.resolve 去寻找路径文件。文件少的时候还好,但如果遇到多文件的时候呢?岂不是会很麻烦。

所以,我们引用 resolveLoader 来简化它。现在我们在 webpack.config.js 文件中进行改造。具体配置如下:

const path = require('path');

module.exports = {
   
    // 先到node_modules中去找,找不到则去./loaders目录下去找
    resolveLoader: {
   
        modules: ['node_modules', './loaders']
    },
    module: {
   
        rules: [{
   
            test: /\.js/,
            use: [
                {
   
                    loader: 'replaceLoader'
                }
            ]
        }]
    }
}

通过配置 resolveLoader ,来对文件文件目录进行查找,从而简化了路径内容。

🎶二、如何编写一个Plugin

1. 碎碎念

在讲解 plugin 之前,我们先来了解 loaderplugin 的区别。

当我们在源代码里面,去引入一个新的 js 文件,或者是一个其他格式的文件时,这个时候我们可以借用 loader ,来帮我们处理我们引用的 loader 文件。 loader 的作用就在于,帮助我们处理引用的模块

plugin 呢,是当我们在做打包的时候,在某些具体时刻上,比如说,当我们打包结束之后,我们要生成一个 html 文件,这个时候,我们就可以使用一个 htmlWebpackPlugin 的插件。使用它之后,他就会在打包结束之后,帮我们生成对应的 html 文件。

再比如,我们要在打包之前,把 dist 目录进行清空,这个时候我们就可以使用 cleanWebpackPlugin 来帮助我们做这件事情。

所以, plugin 插件,在什么时候生效呢?

它在我们打包过程中的某些时刻里,就是插件生效的场景

plugin 的编写相对于 loader 来说,会难一点点。但是呢,如果有看过 webpack 源码的小伙伴们可能会知道, webpack 的一些底层原理都是依据 plugin 来进行编写的。所以,我们还是有必要来学习一下 plugin 的编写。

下面就带领大家来编写一个简易的 plugin ~

2. 项目结构

对于 webpackplugin 来说,它是是基于发布者订阅的设计模式,也可以说是基于事件驱动来实现的。在这个事件驱动里,代码之间的执行,是通过事件来进行驱动的。

接下来,我们就来写一个简易的 plugin

首先用一张图,来看我们的项目结构如下图所示:

plugin项目结构

其中 plugins 文件夹下放置我们想要写的 plugin ,同时里面的 copyright-webpack-plugin.js 文件放置我们即将要写的 plugin 的代码逻辑。之后,index.js 文件是我们的入口文件,放置我们的业务逻辑。 webpack.config.js 文件放置关于 webpack 的相关配置,而 dist 文件夹内的内容,放置的是我们通过 webpack 打包后,生成的打包文件。

3. 业务代码编写

(1)入口文件代码

现在,我们先来编写入口文件 index.js 的代码。具体代码如下:

console.log('hello monday');

(2)编写plugin

现在,我们来编写 plugin 的内容, copyright-webpack-plugin.js 文件的代码具体如下:

class CopyrightWebpackPlugin {
   
    //编写一个构造器
    constructor(options) {
   
         console.log(options)
     }

    apply(compiler) {
   
        //遇到同步时刻
        compiler.hooks.compile.tap('CopyrightWebpackPlugin',() => {
   
            console.log('compiler');
        });

        //遇到异步时刻
        //当要把代码放到dist目录之前,要走下面这个函数
        //Compilation存放打包的所有内容,Compilation.assets放置生成的内容
        compiler.hooks.emit.tapAsync('CopyrightWebpackPlugin', (Compilation, cb) => {
   
            debugger;
            // 往代码中增加一个文件,copyright.txt
            Compilation.assets['copyright.txt'] = {
   
                source: function() {
   
                    return 'copyright by monday';
                },
                size: function() {
   
                    return 19;
                }
            };
            cb();
        })
    }
}

module.exports = CopyrightWebpackPlugin;

上面的这个插件中想要实现的功能就是,获取版权信息

(3)引用plugin

现在,我们在 webpack.config.js 中,来引入我们上面的 plugin具体配置如下:

const path = require('path');
const CopyrightWebpackPlugin = require('./plugins/copyright-webpack-plugin');

module.exports = {
   
    mode: 'development',
    entry: {
    
        main: './src/index.js'
    },
    plugins: [
        new CopyrightWebpackPlugin({
   
            name: 'monday'
        })
    ],
    output: {
   
        path: path.resolve(__dirname, 'dist'),
        filename: '[name].js'
    }
}

通过上述代码,我们可以了解到,在(2)中,我们首先需要定义一个类,之后呢,在类中写一个构造器和一个 apply() 方法来调用。然后呢,大家看到(3),通过 require 的方式,来进行 new 实例 ,实例化一个插件,从而在项目中使用这个插件。

最终,我们项目进行打包时,就会生成一个 dist 目录,并且在目录下增加一个 copyright.txt 文件,并且文件中的内容就是 copyright by monday

💹三、结束语

在上面的文章中,讲解了关于loader和plugin的基本编写思路,以及如何在项目中对他们进行运用,相信大家对这一块内容有了基础的认识。

到这里,loader和plugin的编写讲解就结束啦!希望对大家有帮助~

如文章有误或有不理解的地方,欢迎小伙伴们评论区留言哦💬

本文代码已上传至公众号,后台回复关键词 webpack 即可获取~

🐣彩蛋 One More Thing

(:往期推荐

webpack入门核心知识👉不会webpack的前端可能是捡来的,万字总结webpack的超入门核心知识

webpack入门进阶知识👉webpack入门核心知识还看不过瘾?速来围观万字进阶知识

webpack实战案例配置👉万字总结webpack实战案例配置

(:番外篇

  • 关注公众号星期一研究室,第一时间关注优质文章,更多精选专栏待你解锁~

  • 如果这篇文章对你有用,记得留个脚印jio再走哦~

  • 以上就是本文的全部内容!我们下期见!👋👋👋

相关文章
|
10天前
|
弹性计算 人工智能 架构师
阿里云携手Altair共拓云上工业仿真新机遇
2024年9月12日,「2024 Altair 技术大会杭州站」成功召开,阿里云弹性计算产品运营与生态负责人何川,与Altair中国技术总监赵阳在会上联合发布了最新的“云上CAE一体机”。
阿里云携手Altair共拓云上工业仿真新机遇
|
6天前
|
机器学习/深度学习 算法 大数据
【BetterBench博士】2024 “华为杯”第二十一届中国研究生数学建模竞赛 选题分析
2024“华为杯”数学建模竞赛,对ABCDEF每个题进行详细的分析,涵盖风电场功率优化、WLAN网络吞吐量、磁性元件损耗建模、地理环境问题、高速公路应急车道启用和X射线脉冲星建模等多领域问题,解析了问题类型、专业和技能的需要。
2506 14
【BetterBench博士】2024 “华为杯”第二十一届中国研究生数学建模竞赛 选题分析
|
6天前
|
机器学习/深度学习 算法 数据可视化
【BetterBench博士】2024年中国研究生数学建模竞赛 C题:数据驱动下磁性元件的磁芯损耗建模 问题分析、数学模型、python 代码
2024年中国研究生数学建模竞赛C题聚焦磁性元件磁芯损耗建模。题目背景介绍了电能变换技术的发展与应用,强调磁性元件在功率变换器中的重要性。磁芯损耗受多种因素影响,现有模型难以精确预测。题目要求通过数据分析建立高精度磁芯损耗模型。具体任务包括励磁波形分类、修正斯坦麦茨方程、分析影响因素、构建预测模型及优化设计条件。涉及数据预处理、特征提取、机器学习及优化算法等技术。适合电气、材料、计算机等多个专业学生参与。
1519 14
【BetterBench博士】2024年中国研究生数学建模竞赛 C题:数据驱动下磁性元件的磁芯损耗建模 问题分析、数学模型、python 代码
|
8天前
|
编解码 JSON 自然语言处理
通义千问重磅开源Qwen2.5,性能超越Llama
击败Meta,阿里Qwen2.5再登全球开源大模型王座
531 13
|
1月前
|
运维 Cloud Native Devops
一线实战:运维人少,我们从 0 到 1 实践 DevOps 和云原生
上海经证科技有限公司为有效推进软件项目管理和开发工作,选择了阿里云云效作为 DevOps 解决方案。通过云效,实现了从 0 开始,到现在近百个微服务、数百条流水线与应用交付的全面覆盖,有效支撑了敏捷开发流程。
19282 30
|
1月前
|
人工智能 自然语言处理 搜索推荐
阿里云Elasticsearch AI搜索实践
本文介绍了阿里云 Elasticsearch 在AI 搜索方面的技术实践与探索。
18836 20
|
1月前
|
Rust Apache 对象存储
Apache Paimon V0.9最新进展
Apache Paimon V0.9 版本即将发布,此版本带来了多项新特性并解决了关键挑战。Paimon自2022年从Flink社区诞生以来迅速成长,已成为Apache顶级项目,并广泛应用于阿里集团内外的多家企业。
17524 13
Apache Paimon V0.9最新进展
|
8天前
|
人工智能 自动驾驶 机器人
吴泳铭:AI最大的想象力不在手机屏幕,而是改变物理世界
过去22个月,AI发展速度超过任何历史时期,但我们依然还处于AGI变革的早期。生成式AI最大的想象力,绝不是在手机屏幕上做一两个新的超级app,而是接管数字世界,改变物理世界。
458 48
吴泳铭:AI最大的想象力不在手机屏幕,而是改变物理世界
|
1天前
|
云安全 存储 运维
叮咚!您有一份六大必做安全操作清单,请查收
云安全态势管理(CSPM)开启免费试用
355 4
叮咚!您有一份六大必做安全操作清单,请查收
|
2天前
|
存储 关系型数据库 分布式数据库
GraphRAG:基于PolarDB+通义千问+LangChain的知识图谱+大模型最佳实践
本文介绍了如何使用PolarDB、通义千问和LangChain搭建GraphRAG系统,结合知识图谱和向量检索提升问答质量。通过实例展示了单独使用向量检索和图检索的局限性,并通过图+向量联合搜索增强了问答准确性。PolarDB支持AGE图引擎和pgvector插件,实现图数据和向量数据的统一存储与检索,提升了RAG系统的性能和效果。