前言
在前端开发中,我们经常使用许多第三方包来帮助我们完成特定的任务。而 npm 是一个很好的平台,提供了海量的开源包供我们使用。而在这些包中,有一类是通过 ES6 module 的方式实现的。使用 ES6 module 可以有效的避免全局变量的污染问题,并且易于维护和测试。
而如果你想要创建自己的 ES6 module 包,那么可以使用 generator-esnext-modules 这个 npm 包来快速的生成一个项目模板。本文将详细介绍 generator-esnext-modules 的使用方法和相关注意事项。
安装
首先,我们需要在全局环境下安装 Yeoman :
npm install -g yo
然后,在全局环境下安装 generator-esnext-modules:
npm install -g generator-esnext-modules
使用
在安装完成后,我们可以使用以下命令来生成项目模板:
yo esnext-modules
这个命令会让你输入一些项目相关信息,比如项目名称、包名称、作者等等。生成的项目目录结构如下:
-- -------------------- ---- ------- - --- -------- --- ---------- --- ------------ --- --------- --- --- - --- -------- --- ---- - --- ------------- --- ---------
其中,.babelrc
用于配置 babel,.gitignore
用于指定 git 忽略上传的文件,package.json
用于记录项目相关配置信息和依赖包信息;README.md
用于记录项目说明文档;src
目录用于存放代码实现;test
目录用于存放测试用例。
在开始开发前,我们需要安装项目依赖:
yarn
然后,我们就可以开始愉快的写代码了。
注意事项
generator-esnext-modules 内部集成了 ESLint 和 Jest 两个工具,分别用于代码规范检查和测试。在进行开发时,建议遵循以下的注意事项:
- 尽量遵循 eslint 的规范要求,保证代码风格的一致性和可读性。
- 在编写实现代码时,可以采用 TDD(Test Driven Development,测试驱动开发) 的方式,先编写测试用例,再编写实现代码,确保覆盖所有可能的边界情况和错误场景。
- 在编写测试用例时,尽量覆盖代码的所有分支和情况,以及特殊的输入参数和异常情况。
示例代码
以下是一个使用 generator-esnext-modules 生成的项目的示例代码:
-- -------------------- ---- ------- -- ------------ --- - -------- - ------ -------- - - ------ -------- - - -------- -------- -- ------ -------- ------ -- - ------ - - -- -
-- -------------------- ---- ------- -- ------------------ ------ - --- - ---- --------- ------------- -------- ------- -- -- - ---------- ------ ------- ------ --- -------- ---------- -- -- - ------------- ------------ ---------------- ------------------ --------------- --------------- --- ---------- ------ ------- ------ --- -------- ---------- -- -- - -------------- ------------ ---------------- -------------------- ---------------- ----------------- --- ---
在编写完实现代码和测试用例后,可以使用以下命令来执行测试:
yarn test
如果所有的测试用例都通过了,那么我们就可以将代码提交到 github 上了。
来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/6005590381e8991b448d6516