@alisports/jx-util

JavaScript工具函数库

TODO

• 测试覆盖率 100%
• need core: https://github.com/findhit/util
• js beautify 打印 obj中嵌套 json string，被嵌套的部分没有格式化
• Scoped packages, https://www.npmjs.cn/misc/scope/

更新/发布/分发

// 版本号
main.minor.patch

// 第一次发布
npm adduser
npm publish

// 第n+1次发布
npm login
npm publish

// 查看包的版本
npm view jx-util version

@alisports/jx-util

npm publish --access=public

单元测试

Mocha测试异步代码, 在Nodejs中贯彻单元测试

// 安装依赖
npm install es6-promise --save --verbose
npm install -g mocha --verbose // 测试框架
npm install --save-dev chai --verbose // 断言库

npm install --save-dev mocha --verbose
npm install --save-dev mochawesome --verbose

npm install -g istanbul --verbose

// 单次测试
mocha tests/test-regex.js

// 持续测试
mocha --watch tests

// 生成测试结果html报表
mocha --reporter mochawesome tests

// 测试覆盖率
istanbul cover ./node_modules/mocha/bin/_mocha -- -t 2000 --recursive -R spec tests/

core

函数名	功能
uniqId	唯一ID码
uuid	'8-4-4-4-12' 字符串
timing	测量函数执行时间
forEach	遍历数组、字典
map	映射函数
filter	过滤函数
clone	克隆函数
extend	对象扩展函数
slice	片取函数
stamp	邮戳函数

from

函数名	功能
string	从string转换为本有类型

function

函数名	功能
bind	上下文绑定
return	immutable 值
falsify	immutable 假
truthify	immutable 真
nullify	immutable 空
undefinify	immutable 为定义
always	immutable 值
args	获取实参名称数组
chain	链异步函数
compose	执行从右向左的函数组合
curry	函数柯里化
allPass	条件判断
anyPass	条件判断
tryCatch	异常捕获封装
pipes	执行从左向右的函数组合
promisify	转换异步
runPromisesInSeries	异步串行
sleep	延迟异步执行
throttle	函数节流
debounce	函数防抖

is

函数名	功能
instanceof	------
function	------
array	------
object	------
string	------
error	------
regexp	------
HTMLelement	------
number	------
undefined	------
true	------
false	------
null	------
json	json 字符串，不为字符串，则返回false
bool	------
symbol	------
date	------
promise	------
not	------
ok	------
plain	------
empty	------
equal	------

object

函数名	功能
forEach, each	------
map	------
filter	------
clone	------
isEmpty	------
clean	------
fromPairs	------
toPairs	------
shallowClone	------
has	------
merge	------
mergeDeep	------
mergeWith	------
keys	------
values	------
entries	------
pick	------
omit	------
prop	------
propApply	------
propEq	------
size	------

to

函数名	功能
string	------

array

函数名	功能
head/first	首位元素
tail/last	末尾元素
disorder/shuffle	打乱
equal	等价
contains	包含
flatten	扁平化
randomOne	随机选取
countOccurrences	计算元素数目
unique	去重
sum	求和（数值型数组）
maxify	求最大值（数值型数组）
minify	求最小值（数值型数组）
forEach/each	遍历
clone	克隆
map	映射
filter	过滤
del/rm/remove	移除
randomFilter	指定元素数目，随机过滤
empty	清空
union/merge	求并集
intersect	求交集
adjust	对指定元素加值
allPass	全量判定
anyPass	选择判定
append	追加元素
concat	拼接数组
diff	求差集
slice	片取

date

函数名	功能
head/first	首位元素

number

regex

string

timer

url

logger

基本功能

• 日志级别
• 模块信息、字段信息与格式

重要组件

组件名称	对应类名	功能描述
日志器	Logger	提供了应用程序可一直使用的接口
处理器	Handler	将logger创建的日志记录发送到合适的目的输出
过滤器	Filter	提供了更细粒度的控制工具来决定输出哪条日志记录，丢弃哪条日志记录
格式器	Formatter	决定日志记录的最终输出格式