(给前端大全加星标,提升前端技能)
英文:coreyc 译文:何星
segmentfault.com/a/1190000017461602
如果您曾在 Node 或 JavaScript 前端开发中投入过时间和精力,那么您就知道 npm 中有数以十万计的模块可供您选择。开发者不停的寻求帮助/抱怨:
"对模块的选择困难正在蚕食我们" "X 模块和 Y 模块有什么区别?哪一个更好?" "npm 很棒,但是这些模块可能在一年半载后失效,取决于模块维护者是否积极"
通常在提出这样的问题时,您会得到十个不同的答案。每个人都会给您推荐自己喜欢的模块,接下来就演变成争论哪一个是最好的。
选择 npm 模块时很容易面临纸上谈兵。选择太多,而新来者在鼓吹“快上车”,为您的项目选择合适的 npm 模块可能是有难度的。而且这些模块中有许多做类似(或相同)的事情,这也没有帮助。
与其浪费时间在 google 上搜索,在 npmjs.org 上搜索,或者浪费更多的时间不构建您的项目,还不如搞清楚什么时候该选择哪些模块。
为了帮助解决这个问题,您将在下面找到针对最常见问题类型(即 web 框架、模板、身份认证等)的 npm 模块列表,以及何时使用这些模块。
这里有一些注意事项:您可能熟悉其中一些模块,甚至许多模块,但是有时候您面对的是您还没有接触到的技术栈(可能是身份验证或 Websocket 之类的东西),您需要知道有哪些备选模块可以完成这项工作。您可能有您认为更好的模块,或者可能有一个用例/需求没有包含在这里。我没有列出相同类别的 10 个不同模块,而是缩小了范围,这样您就可以避免分析瘫痪的陷阱。如果您认为自己的用例未被涵盖,请务必自行研究解决。本清单的目的在于让您能更快地启动和运行。
这些模块的选择依据如下:
它们完成工作的能力如何
社区规模(对于支持/故障排除很重要)
积极维护
如果您发现自己仍然没有足够的信息做出决定,我建议使用slant.co和nodejs.libhunt.com来帮助进行比较。
注意:为了保持范围的合理性,这些模块都考虑到了服务器端。它们中的一些可以同时在客户机或服务器上使用,但我的原则是“服务器优先”。
1、Request(https://www.npmjs.com/package/request)
当您需要基于回调的 HTTP 请求时可选择它,例如从一个 REST 服务连接到另一个。
2、Axios(https://www.npmjs.com/package/axios)
当您需要基于 Promise的 HTTP 请求时可选择它。
注意:您可以使用request-promise,但是 axios 的依赖更少,并且基于原生 Promises。
1、Express(https://www.npmjs.com/package/express)
如果您想为 API、网站或单页应用程序使用轻量级 web 框架,请使用它。
您不介意使用回调作为默认的异步处理方式。
使用该框架的模块生态极为繁荣。
您需要一个支持和故障排除的大型社区。
2、Koa(https://www.npmjs.com/package/koa)
当您想要一个比 Express 更简洁的框架时使用。
Koa 更像是一个中间件层,它不提供模板或开箱即用的路由,因此更适合 API 开发。
要想支持开箱即用,您需要 async / await。
3、Hapi(https://www.npmjs.com/package/hapi)
如果您想要一个比 Express 或 Koa 更“自带电池”(译者注:原文"batteries"意为您不必重复造轮子,大多数您需要的功能都能通过(已有)库完成。您能导入并使用它们。)的框架,但又不像 Sails 那么多,那就使用它。
4、Sails(https://www.npmjs.com/package/sails)
当您需要像 Rails 这样的东西时,请使用它,它具有几乎所有功能(但是根据您的应用程序可能不需要那么多)。
1、Ajv(https://www.npmjs.com/package/ajv)
在需要验证 JSON 时使用(比如来自 web 请求)。
您希望与应用程序的其他非 JS 部分共享这些验证规则(因为它是 JSON,所以您可以这样做)。
2、Joi(https://www.npmjs.com/package/joi)
在需要验证输入时使用,并且喜欢链式调用的风格(译者注:代码见下方),而不是在 JSON 中定义验证规则。
您正在使用 Hapi(Hapi 自带 Joi)。
const schema = joi.object().keys({
id: joi.string().guid().required(),
username: joi.string().alphanum().min(8).required()
});
1、Passport(https://www.npmjs.com/package/passport)
当您需要为您的网站或 API 使用身份验证中间件时使用。
您希望能够在多种身份验证类型(Oauth,Facebook 等)之间进行选择。
您需要管理会话。
1、Async (library)(https://www.npmjs.com/package/async)
当您需要使用旧版本的 Node,而该版本的 Node 支持只支持回调而不支持 Promises 时。
2、ES6 原生 promises (原生 JS, 非 npm)
在使用大于 0.12 的 Node 版本时使用。
另一件需要考虑的事情是您的团队对 Promises 的接受程度。在 2018 年,大多数开发人员应该没问题了。
3、async / await(原生 JS,非 npm)
当您为了逃脱“回调地狱”却又误闯“Promise 地狱”。
您有很多来自 Promises 的 .then
和 .catch
。
下面是数据库驱动程序、ORM 和查询生成器的组合。在使用 ORM 之前,我强烈建议您首先确保需要使用它。当您可以只使用原始 SQL 或查询生成器时,它们通常会添加另一层抽象,这层抽象不一定能够提供足够的回报。
1、mysql(https://www.npmjs.com/package/mysql)、node-postgres(https://node-postgres.com/)
当您不需要完整的 ORM,而是需要使用原始 SQL 查询数据库时使用(这些是驱动程序)。
2、node-mongodb-native(https://github.com/mongodb/node-mongodb-native)
当您不需要一个完整的 ORM,而是要直接查询 MongoDB 时使用。
3、Mongoose(https://www.npmjs.com/package/mongoose)
当您希望为 MongoDB 使用 ORM 时使用。
4、Knex(https://www.npmjs.com/package/knex)
当您不需要一个完整的 ORM 解决方案,而只是需要一些工具使编写查询代码更容易,可以使用它。
Knex 是一个生成 SQL 的查询生成器。
您拥有 Postgres、MSSQL、MySQL、MariaDB、SQLite3、Oracle 或 Amazon Redshift 数据库。
5、Objection.js(https://www.npmjs.com/package/objection)
您希望 ORM 支持 Knex 支持的所有东西,不使用查询 DSL(因此您编写的代码更接近原始 SQL),具有基于 Promise 的 API 和良好的文档。
这个网址提供了部分进程管理器的横向比较http://strong-pm.io/compare/。注意:它们还包括了 StrongLoop Process Manager,这是一个不错的工具,但是有点笨重。我建议您在决定使用 StrongLoop 之前先查看一下解决方案。
1、PM2(https://www.npmjs.com/package/pm2)
当您希望进程管理器在服务崩溃时处理重新启动,并允许您控制集群时使用。
注意:PM2 所依据的 AGPL 许可证存在一些潜在的违规行为。这里有一些讨论。我的看法是它最有可能被使用。但如果您有任何问题,请咨询您的法律部门,因为我不是律师。
2、forever(https://www.npmjs.com/package/forever)
当您需要进程管理器来处理在服务崩溃时重新启动服务时使用
您的部署规模较小(pm2 及其集群支持用于更大规模的部署)。如果您只有少量的服务/进程,那么您可能可以使用它。
3、nodemon(https://www.npmjs.com/package/nodemon)
当您希望监视应用程序中的任何代码更改时使用,并在本地开发时自动重启服务器。
非常适合用于开发!
对于 Web Sockets,我只是推荐 primus,而不是列出一个列表。它支持所有主要的 Web Sockets 实现,并且维护者十分积极。如果您需要换成其他的库,您可以通过一行代码更改轻松地更换。
1、Primus(https://www.npmjs.com/package/primus)
当您需要 Web Sockets 但又不想被束缚在特定的 Web Sockets 实现时使用。
1、Swagger-node(https://github.com/swagger-api/swagger-node)
当您需要记录 REST API 并能够针对端点测试请求时使用。
1、Lodash(https://www.npmjs.com/package/lodash)
当您需要 JS 实用程序库时使用。
您使用了大量的 OOP(面向对象编程)。
2、Ramda(https://www.npmjs.com/package/ramda)
当您希望使用函数式的编程风格时,请使用。
您想要像 lodash 这样的东西,但是在函数式编程范式中。
3、Moment(https://www.npmjs.com/package/moment)
在需要解析、验证、操作和显示日期/时间时使用。
4、UUID(https://www.npmjs.com/package/uuid)
当您需要随机的、唯一的、难以破解的 id 时使用。
5、NVM(https://github.com/creationix/nvm)
当您希望能够在环境中安装的多个 Node 版本之间切换时使用。
6、Fs-extra(https://www.npmjs.com/package/fs-extra)
当您需要能够递归地使用 mkdir
、 rm-rf
和 Node 中缺少的其他文件系统级功能时,请使用。
7、Nodemailer(https://www.npmjs.com/package/nodemailer)
当您需要从 Node 发送电子邮件时使用。
8、Dotenv(https://www.npmjs.com/package/dotenv)
当您需要将 .env
文件中的环境变量加载到 process.env
时使用。
1、Commander(https://www.npmjs.com/package/commander)
当您要构建一个 CLI 程序时使用,该程序将所有参数作为命令行上的标志。
2、Inquirer(https://www.npmjs.com/package/inquirer)
当您想要构建一个按顺序获取选项的“交互式”CLI 程序时使用(类似于运行 npm init 时的方式,它会询问您生成 package.json 文件的一系列问题)。
1、Winston(https://www.npmjs.com/package/winston)
当您需要一个日志库并需要不同的日志输出格式时使用。
2、Bunyan(https://www.npmjs.com/package/bunyan)
当您需要一个日志库,并以 JSON 作为唯一日志输出格式时使用。
您希望为不同的组件、请求或函数使用不同的日志记录器(也就是说,这些日志记录器可能以不同的方式解析事件)。
3、Morgan(https://www.npmjs.com/package/morgan)
当您使用 Express 并且想要记录 HTTP 请求时使用。
注意:这将与 Winston 或 Bunyan 一起使用。由于它是中间件,它知道如何处理请求并记录它,但不处理 Winston 和 Bunyan 所做的日志输出的传输。
1、Pug (原 Jade)(https://www.npmjs.com/package/pug)
当您需要服务器端模板引擎时,请使用该引擎,该引擎易于阅读,并且支持开箱即用的子组件代码块。 您只需要输出 HTML。
2、EJS(https://www.npmjs.com/package/ejs)
当您需要一个服务器端模板引擎,该引擎完全使用 JS,并且允许空格缩进(Pug 不允许)。
注意:不支持异步 JS 函数。
1、Mocha(https://www.npmjs.com/package/mocha)
在需要编写和运行单元测试时使用。
2、Chai(https://www.npmjs.com/package/chai)
当您需要证明您的单元测试中的断言时,请使用。
注意:这将与 Mocha 一起使用。
3、Chai-as-promised(https://www.npmjs.com/package/chai-as-promised)
当您希望在 promises 上证明您的断言时,而不是将断言放在 then 或 catch 中使用。
4、Sinon(https://www.npmjs.com/package/sinon)
当您需要用于测试的 mock 库时使用。
1、ESdoc(https://www.npmjs.com/package/esdoc)
当您想从您的代码中生成 API 文档,并且您正在使用最新的 JS 版本时,请使用。
默认情况下支持当前版本的 JS(支持 class),因此如果在代码中使用 prototypes,请使用 JSdoc。
2、JSdoc(jsdoc)
当您需要支持 ES6 的代码 API 文档生成器时使用。
支持 classes
和 prototypes
。
3、ESlint(https://www.npmjs.com/package/eslint)
当您需要一个 linter 来自动查找(和修复)代码中的语法和代码格式问题时使用(译者注:可参考本人博文vscode + vetur + eslint + prettier 实现团队代码风格统一)。
现在,原生 Node 调试现在已经够用了,我的建议是直接使用它。几年前,引入一些 npm 模块是很有帮助的,而且您可能有一个特定的用例需要一个 npm 模块,但是现在已经有了足够的本地支持,如果您对调试没有任何太疯狂要求,请务必忽略掉额外的依赖项。
挑选模块可能很难,但您只需要一些方法点来解决它。当您正在为如何抉择浪费时间,或者甚至不知道从哪里开始时,请使用本指南来帮助您。
推荐阅读
(点击标题可跳转阅读)
觉得本文对你有帮助?请分享给更多人
关注「前端大全」加星标,提升前端技能