node使用例子

Posted 2020-10-14 华~静看一季花开花落

一、非计算机背景前端如何快速了解Node.js？

做前端的应该都听过Node.js，偏开发背景的童鞋应该都玩过。

对于一些没有计算机背景的，工作内容以静态页面呈现为主的前端，可能并未把玩过Node.js，且很有可能对Node.js都没有一个比较立体的认识——知道这玩意可以跑服务，构建很多前端工具，看上去很厉害的样子，但是，可能就仅限于此了。

“那可否三言两语概括Node.js的林林总总呢？”
“不可！”
“那怎么办？”
“那就六言四语！”

首先，要知道，Node.js一个javascript运行环境(runtime)，没错，就是用来运行Javascript. 以前JavaScript只能在浏览器这个小世界里称王称霸。很多前端小伙伴可能就JS这门程序语言熟一点，其他C++, .net之类的就呵呵了。如果是过去，如果浏览器一觉醒来灭绝了，很多人就会失业。就像食物单一的物种一旦这种食物没了，就坐等灭绝是一个道理。

但是，现在，不要担心了，Node.js让JavaScript变成杂食的了，也就是除了网页行为，可以和其他C++等语言一样，构建服务，操作文件等等。

我们应该都使用过.exe后缀的文件，双击一下，就可以潜伏个病毒什么的；我们可能还使用过.bat后缀的批处理文件，一点击，文件夹里面的图片全部重命名；那么如果是.js后缀的文件呢（假设你的系统已经安装了Node.js环境），双击一下则……当当当当……会打开编辑器看到JS代码，双击是没有用的！

我们可以打开命令行工具，cd到指定目录，然后输入（假设JS文件名为test.js）：

node test

然后test.js里面的代码就可以欢快地跑起来啦！

对于“页面仔”而言，了解这么多就够了！

1. 安装后Node.js环境；
2. 用我们蹩脚的JS写一个蹩脚处理的.js文件；
3. node执行下。

简简单单三部曲，我们就变身成了具有开发味道的前端从业人员了。

二、蹩脚JS下的Node.js初体验

绝大数厂子都是小厂，很大部分小厂都只有一个前端，很多前端的JS其实都一般般。

圈子里面经常把“前端解决方案”挂在嘴边的，实际上都是有前端团队的，因为有团队, 才能显价值。

“前端解决方案”是好，但是，如果真正关心行业发展，应该知道，能够在一个大团队里面玩耍的实际上是小部分人，有很多很多的小伙伴都是孤军奋战，这套东西说不定反而阻碍了敏捷和灵活；有很多很多的小伙伴在二三四线城市，是野生的前端开发，底子不够，这套庞杂的东西很难驾驭；有很多很多的项目就是几个静态活动页面，没必要回回使用高射炮打蚊子。

此时，往往需要的是定制化很强的小而美的处理。有同学可能会疑虑，哎呀，我JS水平比较菜，自造工具这种事情会不会有点挑大梁啊。实际上，即使你JS一般般，借助Node.js构建一些小工具提升自己的前端开发效率这种事情，完全不在话下。

前端这东西，有个博尔特都认同的特点，就是上手快！

首先，我们需要一份Node.js API文档，我们使用“动物搜索”，搜一下：

就第一个吧，进入会看到一长排的API列表内容： 

不要怕，我们只需要这一个就可以，没错，就一个文件系统(fs)！ 其他都不需要管，那些都是资深玩家玩的：

点击去，又是洋洋洒洒，一群API：

不要怕，我们只需要……淡定，不是一个，是若干个常规的增删读写重命名文件就可以了。

好了，然后只需要一点蹩脚的JS，我们就可以玩起来了。

玩什么呢？容我看集动漫想一想……

设计师给的图标重命名
勤劳的设计师送来了香饽饽的小图片素材，但是，连接字符是下划线_，恰巧，此时，前端童鞋的处女病发错，其他自己处理的图片全部是短横线-连接的，这里图标全是下划线受不了，想要全部替换为短横线，怎么办？

如果就一两个图标还好，大不了手动改改，但是，要是如上截图，设计师一口气给了57个图标，我去，要改到头皮发麻了吧~倒不是时间问题，而是重复劳动带来的那种枯燥和不愉悦会影响工作的激情，而且这种劳动用完就没了，无法复用，且不能作为业绩（我可以5分钟完成100个文件的重命名，有个卵用~）。

此时，Node.js就可以闪亮登场了，有了Node.js环境，我们只要寥寥几行JS代码，就可以完全秒杀了，很简单，读取文件夹里面的所有图片，然后把名称里面所有的下划线_替换成短横线-, 假设我们的.js文件和需要处理的小图标文件夹结构如下：

underscore2dash.js内容如下：

// 引入fs文件处理模块
var fs = require("fs");
// 现在我们要关心的是‘icons‘文件夹
// 我们不妨用变量表示这个文件夹名称，方便日后维护和管理
var src = ‘icons‘;

// API文档中中找到遍历文件夹的API
// 找到了，是fs.readdir(path, callback)
// 文档中有叙述：
// 读取 path 路径所在目录的内容。 回调函数 (callback) 接受两个参数 (err, files) 其中 files 是一个存储目录中所包含的文件名称的数组
// 因此：
fs.readdir(src, function(err, files) {
    // files是名称数组，因此
    // 可以使用forEach遍历哈, 此处为ES5 JS一点知识
    // 如果不清楚，也可以使用for循环哈
    files.forEach(function(filename) {
        // 下面就是文件名称重命名
        // API文档中找到重命名的API，如下
        // fs.rename(oldPath, newPath, callback)       
        // 下面，我们就可以依葫芦画瓢，确定新旧文件名称：
        var oldPath = src + ‘/‘ + filename, newPath = src + ‘/‘ + filename.replace(/_/g, ‘-‘);
        // 重命名走起
        fs.rename(oldPath, newPath, function(err) {
            if (!err) {
                console.log(filename + ‘下划线替换成功!‘);
            }       
        })
    });
});

window系统举例，我们使用cmd或者PowerShell，在对应文件夹目录下执行下该JS文件：

node underscore2dash

结果：

此时的文件夹的图片们：

此处的文件名批量替换不仅适用于图片，实际上适用于任意格式的文件。

当前，对命名的批量处理不仅仅如此，还包括统一前缀（例如icon_*），此时只要把newPath = 后满的代码改成src + ‘/icon_‘ + filename。或者非开发需求，比方说批量下载的小视频名称从1依次往后排，则……还是自己处理下吧，forEach方法第二个参数是数组序号值，可以直接拿来用，就当课后作业了，看好你哟！

本文件夹批量处理例子，抛开详尽的注释，差不多10行出头JS代码，用到的JS方法也都是非常非常基本的，对吧，数组遍历forEach和字符替换replace方法，其他就是套API走套路，就算我老婆（非IT领域）亲自上阵，也都可以弄出来。简单，而且有意思。

我强烈建议大学的程序开发入门课程就学JavaScript，跑web网页，跑Node.js, 简单且所见即所得，容易激发学习的乐趣，要比枯燥不知干嘛用的C语言更适合科普和入门。

三、蹩脚JS下的Node.js初体验二周目

我们写页面实际的开发需求肯定不知文件批量重命名这么简单，我知道有一个需求点，尤其经常写静态原型页面的小伙伴一定感兴趣的。

就是html页面也能够如动态语言，如php一样，各个模块可以直接include进来。现在普遍存在这样一个问题，某项目，重构人员哗啦啦编写了20多个静态页面，但是，由于HTML无法直接include公用的头部底部和侧边栏，导致，这20个页面的头尾都是独立的，一般头部内容发生了变更，呵呵，估计就要求助编辑器来个批量替换什么的了。

这是不是痛点？显然是！凡事痛点都是可以做出贡献体现自己价值的地方。

没错，我们工作就是切切页面，我们的JS勉强可以扶上墙，但，就是这样的我们，只要你有这个心，意识到问题所在，同时知道Node.js可以帮你做到这一点，一个实用的工具其实已经完成了一半。参照API文档，东拼拼，西凑凑，肯定可以弄出一个至少自己用得很high的东西，剩下的一半就这么简简单单续上了。

实例示例示意
有一个原始的HTML页面，头尾都使用了类似下面代码的标准HTML5 import导入：

<link rel="import" href="header.html">

但是，实际上，rel="import"和include是完全不一样的概念，import进来实际上是个独立的document！不过这是后话了，反正我们又不是直接浏览这个页面，因此，大家不必在意这个细节。

HTML几个文件结构关系如下示意：

此时，我们就可以借助Node.js以及我们那一点点JS知识，把rel="import"这行HTML替换成对应的导入的HTML页面内容。

原理其实很简单：

1. 读import-example.html页面；
2. href="header.html"这行HTML替换成header.html的内容；
3. 监控import-example.html页面，一有变化，即时生成；
4. done!

下面为本例子的JS代码import.js：

// 引入fs文件处理模块
var fs = require("fs");

// 测试用的HTML页文件夹地址和文件名称
var src = ‘import‘, filename = ‘import-example.html‘;

var fnImportExample = function(src, filename) {
    // 读取HTML页面数据
    // 使用API文档中的fs.readFile(filename, [options], callback)
    fs.readFile(src + ‘/‘ + filename, {
        // 需要指定编码方式，否则返回原生buffer
        encoding: ‘utf8‘
    }, function(err, data) {
        // 下面要做的事情就是把
        // <link rel="import" href="header.html">
        // 这段HTML替换成href文件中的内容
        // 可以求助万能的正则
        var dataReplace = data.replace(/<link\srel="import"\shref="(.*)">/gi, function(matchs, m1) {
            // m1就是匹配的路径地址了
            // 然后就可以读文件了
            return fs.readFileSync(src + ‘/‘ + m1, {
                encoding: ‘utf8‘
            });
        });

        // 由于我们要把文件放在更上一级目录，因此，一些相对地址要处理下
        // 在本例子中，就比较简单，对../进行替换
        dataReplace = dataReplace.replace(/"\.\.\//g, ‘"‘);

        // 于是生成新的HTML文件
        // 文档找一找，发现了fs.writeFile(filename, data, [options], callback)
        fs.writeFile(filename, dataReplace, {
            encoding: ‘utf8‘
        }, function(err) {
            if (err) throw err;
            console.log(filename + ‘生成成功！‘);
        });
    });
};

// 默认先执行一次
fnImportExample(src, filename);

// 监控文件，变更后重新生成
fs.watch(src + ‘/‘ + filename, function(event, filename) {
    if (event == ‘change‘) {
        console.log(src + ‘/‘ + filename + ‘发生了改变，重新生成...‘);
        fnImportExample(src, filename);
    }
});

我们此时node run一下：

node import

结果：

此时的文件夹：

箭头所指就是新生成的HTML页面，此时的内容是：

我们访问此页面：

连广告都显示良好！

此时，node实际上是实时监控原始HTML是否发生变化的，文档中的fs.watch()方法，例如，我们把图片地址的mm1换成mm2，则：

此时页面变成了：

于是乎，一个随时自动编译import导入HTML页面的小工具的雏形就好了。

页面重构的小伙伴，就不要担心20多个原型页面公用部分修改一次要改20多处的问题了，直接将公用的模块import进来，20多个页面分分钟编译为HTML页面完全体。

现在，我们再回过头看上面的HTML支持模块引入的小工具，就是几个简单的Node.js API和几行简单的JS. 我们又不是开源就自己用用，很多复杂场景根本就不要去考虑，所以，这么简单就足够了！

四、结束语

当项目比较小的时候，当团队成员比较少的时候，当开发同学不鸟你的时候，此时，要发扬自己动手，丰衣足食的精神。

开发时候遇到痛点，或者感觉自己在做重复劳动的时候，想想看，是不是可以花点时间捣腾出一个Node.js的小脚本。

不要以为npm仓库里面的那些工具好像很Diao很难搞，其实呢，也就是一点点核心加上应付各种场景弄出来的。由于我们是自娱自乐，追求的是敏捷高效，专注于眼前任务功能，所以，我们只要把核心弄出来就好，而这些核心往往就几行JS代码+几个fs API就可以了。

蚂蚁虽小，咬人也疼。所以，不要觉得自己JS比较菜，搞不来，就几行JS代码，你不动手搞一搞你怎么就确定呢？

写CSS为主的前端想要往后发展，没有比本文介绍内容更适合学习和入门的了。