百度360必应搜狗淘宝本站头条
当前位置:网站首页 > 编程网 > 正文

如何开发gulp插件——一个中级前端工程师应该具备的能力

yuyutoo 2024-10-22 18:46 10 浏览 0 评论

前面几篇文章我们一起聊了几种类型的流,这篇文章主要来分析一下如何写一个gulp插件。

前言

前端工程化对于FE来说是一项必不可少的能力,而gulp在前端工程化中可以为FE提供很多重要的帮助,比如编译、压缩、同步文件等等。gulp的使用是非常简单的,文档写的也比较清楚,大部分人瞜一眼都能会用,学习成本比较低。但是大多数情况下我们都是使用别人提供的插件,如果网上找不到适合我们自己项目的插件时,该如何去实现一个gulp插件呢?

gulp源码分析

我们先看一个简单的应用例子,如下图:

图1中我们定义了两个任务,图2中分别运行了一下,都能正确打印出结果(使用本地gulp便于调试源码)。可以看出来gulp是任务型的,每个可以从文件中导出的函数就是一个任务,管理这些任务使用的逻辑都封装在了undertaker这个模块里,这个模块不需要我们去了解细节,知道它是干什么的就可以了。

gulp主要用于处理文件,现在图1中是没什么逻辑的,我们再加一点逻辑,如下图:

图3中的逻辑主要是把src读到的文件修改一下名字然后输出到dist目录,逻辑中我们使用了gulp提供的两个方法src和dest,根据之前学习Stream的经验,很显然前者至少会输出一个可读流,后者至少会输出一个可写流,我们现在去看看gulp的源码!

如图4,进入gulp源码找到src和dest方法,我们发现它两是vinyl-fs提供的,我们再移步vinyl-fs这个包!

图5所示就是src方法的具体实现,其最终会返回一个transform流(即return的结果),streams数组中几个元素也都是transform流,它们运行的顺序是上一个元素处理后的结果会交给下一个元素处理。

红色箭头标号为1的流主要是通过glob获取所有要处理的文件路径,然后交给标号为2的流,这个wrapVinyl主要作用是为每个要处理的文件生成一个对应的对象,这个对象上挂载了文件的信息比如文件路径、文件内容等,还挂载了几个方法比如文件是否是buffer、文件是否是stream等,生成这个对象用到的逻辑都封装到了vinyl这个包中。

标号为3的这个流主要作用就是读取文件的内容,然后将文件的内容通过contents属性设置到上面所说的对象上。

streams数组中其他几个元素对于我们学习如何写插件影响不大,就不做介绍了!

说到这里我想gulp的处理流程应该很清楚了,就是为每个要处理的文件生成一个对象挂载其自身的各种信息包括路径、内容等,后续插件(各种transform流)只要处理这个对象就可以了,最后通过dest方法输出新的文件。

使用buffer处理插件

直接看一个插件例子,如下:

图6中开发一个名字为gulpPlugin的插件,返回一个transfrom流,我们只需要实现_transform方法就可以了,其中参数originalFile就是之前提到的那个对象!

我们读取一个名为1.json的文件,originalFile.contents默认是buffer类型,此时我们将内容替换为“祝福我的祖国越来越强大!”,同时也将文件后缀修改为.js,运行后,你会发现dist目录下已经生成了1.js文件,并且内容也符合预期!

使用stream处理插件

看下面例子,

图7中在src里面将buffer选项置为false,运行一下你会发现originalFile.contents的类型已经变为了stream,此时该怎么处理呢?

我们可以再创建一个transform流,如下:

图8中新创建了一个transform流——innerStream,在这个流的内部我们可以修改文件的内容,并且把这个流传递下去。

图8中一共出现了两个原生transfrom流,代码显得有点冗余,为了解决这个问题,我们可以使用through2这个模块,它也会生成一个transfrom流,只是为objectMode和highWaterMark设置了默认值,我们利用这个模块修改一下代码逻辑。

如图9是利用through2模块修改后的逻辑,现在看起来代码优雅了许多!

在插件的逻辑中,开发者是需要判断数据内容的类型是buffer还是stream,因为插件并不清楚上游会传给它什么数据,所以就要做兼容处理,而最后的dest也会去做类型判断!

总结

这篇文章主要简单介绍了gulp的源码和如何写一个插件,这是一个中级程序员应该有的能力!想写好一个gulp插件,可以按照gulp的插件规范要求来写,比如命名、错误处理、单测等等。

另外,如果你还不了解buffer和stream,我想你在写插件(包括webpack等其他工具)时只能照葫芦画瓢,并不能很好的驾驭!所以如果你是这种情况,可以先看看我之前的文章,再来学习如何写插件也不迟!

喜欢我的文章就关注我吧,后续会更多干货输出,让我们一起学习,共同成长!

相关推荐

当 Linux 根分区 (/) 已满时如何释放空间?

根分区(/)是Linux文件系统的核心,包含操作系统核心文件、配置文件、日志文件、缓存和用户数据等。当根分区满载时,系统可能出现无法写入新文件、应用程序崩溃甚至无法启动的情况。常见原因包括:...

玩转 Linux 之:磁盘分区、挂载知多少?

今天来聊聊linux下磁盘分区、挂载的问题,篇幅所限,不会聊的太底层,纯当科普!!1、Linux分区简介1.1主分区vs扩展分区硬盘分区表中最多能存储四个分区,但我们实际使用时一般只分为两...

Linux 文件搜索神器 find 实战详解,建议收藏

在Linux系统使用中,作为一个管理员,我希望能查找系统中所有的大小超过200M文件,查看近7天系统中哪些文件被修改过,找出所有子目录中的可执行文件,这些任务需求...

Linux 操作系统磁盘操作(linux 磁盘命令)

一、文档介绍本文档描述Linux操作系统下多种场景下的磁盘操作情况。二、名词解释...

Win10新版19603推送:一键清理磁盘空间、首次集成Linux文件管理器

继上周四的Build19592后,微软今晨面向快速通道的Insider会员推送Windows10新预览版,操作系统版本号Build19603。除了一些常规修复,本次更新还带了不少新功能,一起来了...

Android 16允许Linux终端使用手机全部存储空间

IT之家4月20日消息,谷歌Pixel手机正朝着成为强大便携式计算设备的目标迈进。2025年3月的更新中,Linux终端应用的推出为这一转变奠定了重要基础。该应用允许兼容的安卓设备...

Linux 系统管理大容量磁盘(2TB+)操作指南

对于容量超过2TB的磁盘,传统MBR分区表的32位寻址机制存在限制(最大支持2.2TB)。需采用GPT(GUIDPartitionTable)分区方案,其支持64位寻址,理论上限为9.4ZB(9....

Linux 服务器上查看磁盘类型的方法

方法1:使用lsblk命令lsblk输出说明:TYPE列显示设备类型,如disk(物理磁盘)、part(分区)、rom(只读存储)等。...

ESXI7虚机上的Ubuntu Linux 22.04 LVM空间扩容操作记录

本人在实际的使用中经常遇到Vmware上安装的Linux虚机的LVM扩容情况,最终实现lv的扩容,大多数情况因为虚机都是有备用或者可停机的情况,一般情况下通过添加一块物理盘再加入vg,然后扩容lv来实...

5.4K Star很容易!Windows读取Linux磁盘格式工具

[开源日记],分享10k+Star的优质开源项目...

Linux 文件系统监控:用脚本自动化磁盘空间管理

在Linux系统中,文件系统监控是一项非常重要的任务,它可以帮助我们及时发现磁盘空间不足的问题,避免因磁盘满而导致的系统服务不可用。通过编写脚本自动化磁盘空间管理,我们可以更加高效地处理这一问题。下面...

Linux磁盘管理LVM实战(linux实验磁盘管理)

LVM(逻辑卷管理器,LogicalVolumeManager)是一种在Linux系统中用于灵活管理磁盘空间的技术,通过将物理磁盘抽象为逻辑卷,实现动态调整存储容量、跨磁盘扩展等功能。本章节...

Linux查看文件大小:`ls`和`du`为何结果不同?一文讲透原理!

Linux查看文件大小:ls和du为何结果不同?一文讲透原理!在Linux运维中,查看文件大小是日常高频操作。但你是否遇到过以下困惑?...

使用 df 命令检查服务器磁盘满了,但用 du 命令发现实际小于磁盘容量

在Linux系统中,管理员或开发者经常会遇到一个令人困惑的问题:使用...

Linux磁盘爆满紧急救援指南:5步清理释放50GB+小白也能轻松搞定

“服务器卡死?网站崩溃?当Linux系统弹出‘Nospaceleft’的红色警报,别慌!本文手把手教你从‘删库到跑路’进阶为‘磁盘清理大师’,5个关键步骤+30条救命命令,快速释放磁盘空间,拯救你...

取消回复欢迎 发表评论: