Zero - jslib
从 0 开始创建一个 JavaScritp / TypeScript 库
0 配置 : 预置了所有配置,可以直接开始编写代码,并且立即享受以下功能:
- 模块打包(Rullup + Webpack)
- Babel 语法转换
- 单元测试 (Jest)
- 覆盖率测试 (Jest)
- TypeScript 支持
- 文档生成(jsdoc)
npm script
npm run build
命令 | 描述 |
---|---|
dev |
开发,将开启 rullup 的 watch 模式,对源文件修改会触发 build 。 |
build |
构建代码,源文件被构建为最终生成文件放在 dist 目录下的 |
build-all |
相当于清空 dist 目录 + build + build-bundle |
build-bundle |
使用 webpack 构建 bundle,bundle 用在对兼容性要求高的场合 |
build-and-publish |
相当于 build-all + doc + publish |
doc |
根据源码的注释(jsdoc)生成文档,并把文档和 README-HEAD.md 合并生成 README.md |
test |
启动测试(Jest) |
test-coverage |
启动覆盖率测试并生成报告放在 coverage 目录下 |
src/index.js
主入口,会生成下列文件:
XXXX.es.js
XXXX.umd.js
XXXX.web-bundle.js
src/index.node.js
Node.js 入口,用来与主入口区分,集成仅在 Node.js 环境才有的部分,需要手动编写。会生成下列文件:
XXXX.node.js
XXXX.node-bundle.js
src/index.typescript.ts
TypeScript 入口,主要用来生成 TypeScript 定义文件,需要手动编写。会生成下列文件:
types/index.typescript.d.ts
Usage
Install
npm i -S XXXX
Import
// ES6 modules // Node.js (CJS) modulesvar XXXX = // 浏览器载入<script src="XXXX.umd.js"></script> // 捆绑了所有 node_modules 依赖 // 捆绑了所有 node_modules 依赖,浏览器适用
Functions
- sayHi(text) ⇒
string
say hai boy
- genColor(inColor, [upperCase]) ⇒
string
转换一个色彩对象为文本
- getNowTime() ⇒
number
获取当前 ms
string
sayHi(text) ⇒ say hai boy
Kind: global function
Param | Type | Description |
---|---|---|
text | string |
一段文本 |
string
genColor(inColor, [upperCase]) ⇒ 转换一个色彩对象为文本
Kind: global function
Param | Type | Description |
---|---|---|
inColor | Color |
色彩对象 |
[upperCase] | boolean |
是否大写 |
number
getNowTime() ⇒ 获取当前 ms
Kind: global function