查看原文
其他

635000 个 npm 包中我应该用哪个?

前端大全 2020-02-18

(给前端大全加星标,提升前端技能


英文: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来帮助进行比较。

注意:为了保持范围的合理性,这些模块都考虑到了服务器端。它们中的一些可以同时在客户机或服务器上使用,但我的原则是“服务器优先”。

HTTP requests (HTTP 请求)

1、Request(https://www.npmjs.com/package/request)

  • 当您需要基于回调的 HTTP 请求时可选择它,例如从一个 REST 服务连接到另一个。

2、Axios(https://www.npmjs.com/package/axios)

  • 当您需要基于 Promise的 HTTP 请求时可选择它。

注意:您可以使用request-promise,但是 axios 的依赖更少,并且基于原生 Promises。

Web frameworks (Web 框架)

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 这样的东西时,请使用它,它具有几乎所有功能(但是根据您的应用程序可能不需要那么多)。

Validation (前端验证)

1、Ajv(https://www.npmjs.com/package/ajv)

  • 在需要验证 JSON 时使用(比如来自 web 请求)。

  • 您希望与应用程序的其他非 JS 部分共享这些验证规则(因为它是 JSON,所以您可以这样做)。

2、Joi(https://www.npmjs.com/package/joi)

  • 在需要验证输入时使用,并且喜欢链式调用的风格(译者注:代码见下方),而不是在 JSON 中定义验证规则。

  • 您正在使用 Hapi(Hapi 自带 Joi)。

  1. const schema = joi.object().keys({

  2.  id: joi.string().guid().required(),

  3.  username: joi.string().alphanum().min(8).required()

  4. });

Authentication (身份认证)

1、Passport(https://www.npmjs.com/package/passport)

  • 当您需要为您的网站或 API 使用身份验证中间件时使用。

  • 您希望能够在多种身份验证类型(Oauth,Facebook 等)之间进行选择。

  • 您需要管理会话。

Asynchronous (异步)

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

Database (数据库)

下面是数据库驱动程序、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 和良好的文档。

Process management (进程管理)

这个网址提供了部分进程管理器的横向比较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

对于 Web Sockets,我只是推荐 primus,而不是列出一个列表。它支持所有主要的 Web Sockets 实现,并且维护者十分积极。如果您需要换成其他的库,您可以通过一行代码更改轻松地更换。

1、Primus(https://www.npmjs.com/package/primus)

  • 当您需要 Web Sockets 但又不想被束缚在特定的 Web Sockets 实现时使用。

API documentation (API 文档)

1、Swagger-node(https://github.com/swagger-api/swagger-node)

  • 当您需要记录 REST API 并能够针对端点测试请求时使用。

Utilities/misc (通用工具/杂项)

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 时使用。

CLI (命令行界面)

1、Commander(https://www.npmjs.com/package/commander)

  • 当您要构建一个 CLI 程序时使用,该程序将所有参数作为命令行上的标志。

2、Inquirer(https://www.npmjs.com/package/inquirer)

  • 当您想要构建一个按顺序获取选项的“交互式”CLI 程序时使用(类似于运行 npm init 时的方式,它会询问您生成 package.json 文件的一系列问题)。

Logging (日志)

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 所做的日志输出的传输。

Templating (前端模板)

1、Pug (原 Jade)(https://www.npmjs.com/package/pug)

  • 当您需要服务器端模板引擎时,请使用该引擎,该引擎易于阅读,并且支持开箱即用的子组件代码块。 您只需要输出 HTML。

2、EJS(https://www.npmjs.com/package/ejs)

  • 当您需要一个服务器端模板引擎,该引擎完全使用 JS,并且允许空格缩进(Pug 不允许)。

  • 注意:不支持异步 JS 函数。

Testing (测试)

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 库时使用。

Tooling (开发工具)

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 实现团队代码风格统一)。

Debugging (调试)

现在,原生 Node 调试现在已经够用了,我的建议是直接使用它。几年前,引入一些 npm 模块是很有帮助的,而且您可能有一个特定的用例需要一个 npm 模块,但是现在已经有了足够的本地支持,如果您对调试没有任何太疯狂要求,请务必忽略掉额外的依赖项。

结论

挑选模块可能很难,但您只需要一些方法点来解决它。当您正在为如何抉择浪费时间,或者甚至不知道从哪里开始时,请使用本指南来帮助您。


推荐阅读

(点击标题可跳转阅读)

从0开始发布一个无依赖、高质量的 npm 包

趣图:如果 NPM 是快递公司…

为什么我认为数据结构与算法对前端开发很重要?



觉得本文对你有帮助?请分享给更多人

关注「前端大全」加星标,提升前端技能

    您可能也对以下帖子感兴趣

    文章有问题?点此查看未经处理的缓存