ut2
一个现代 JavaScript 实用工具库。
比较
与其他工具库对比（lodash、underscore）
- 使用 ES API 开发，并剔除原生支持的大量方法（
forEach、filter、Array.from、Object.keys、Object.entries、Object.create……）。 - 使用 TypeScript 实现， 提供类型定义。
- 导出
escjsumd模块格式，支持不同开发环境使用。
使用
es 或 node 开发环境
安装依赖
npm
npm install ut2yarn
yarn add ut2浏览器原生开发环境
如果你的项目使用的是原生方式开发，可以在浏览器中使用 script 标签直接引入文件，并使用全局变量 ut2 。
npm 包的 ut2/dist 目录下提供了 UMD 包 ut2.js 以及 ut2.min.js。你也可以通过 UNPKG 下载到本地进行使用。或者直接使用 UNPKG 线上版本 注意版本 。
示例
所有方法都在 ut2 模块中。
import { debounce } from 'ut2';
const debounced = debounce(() => {
// do something
}, 300);API
下列方法全部在
ut2模块直接导出，分类只是为了可读性。你可以点击查看在线文档，了解更多信息。
import { throttle, chunk, max } from 'ut2'
- Array 数组
- chunk - 拆分成多个
size长度的区块。 - compact - 剔除假值元素。
- difference - 排除部分值。
- formPairs - 将键值对转为对象。
- intersection - 数组交集。
- nth - 获取第
n个元素。 - shuffle - 打乱数组。
- union - 并集去重。
- uniq - 数组去重。
- unzip - 数组分组。
- xor - 先并集再排除交集部分。
- zip - 数组参数分组。
- chunk - 拆分成多个
- Collection 集合
- countBy - 统计数量。
- groupBy - 对象分组。
- keyBy - 转为对象。
- orderBy - 排序。
- partition - 拆分真值和假值。
- Function 函数
- after - 调用
n或更多次之后触发。 - before - 调用次数少于
n次之前触发。 - debounce - 防抖函数。
- delay - 延迟触发。
- negate - 否定断言。
- partial - 预设部分参数。
- throttle - 节流函数。
- after - 调用
- Math 数学
- ceil - 向上舍入。
- floor - 向下舍入。
- max - 取最大值。
- min - 取最小值。
- round - 四舍五入。
- Number 数字
- clamp - 限制数字范围。
- inRange - 是否在范围内。
- random - 随机小数。
- randomInt - 随机整数。
- Object 对象
- merge - 递归对象或数组进行合并。
- omit - 排除部分属性。
- omitBy - 根据方法，排除部分属性。
- pick - 选择部分属性。
- pickBy - 根据方法，选择部分属性。
- String 字符串
- camelCase - 驼峰小写。
- capitalize - 首字母大写，其余小写。
- escape - 转义
&<>"'为 HTML 实体字符。 - escapeRegExp - 转义为
RegExp字符串中的特殊字符。 - kebabCase - 连接符分隔小写。
- lowerCase - 空格分隔小写。
- lowerFirst - 首字母小写。
- snakeCase - 下划线分隔小写
- unescape - 转义字符串中的 HTML 实体字符
&<"'。 - upperCase - 空格分隔大写。
- upperFirst - 首字母大写。
- words - 拆分词组。
- Type 类型
- isArguments -
arguments对象。 - isArray -
Array对象。 - isArrayBuffer -
ArrayBuffer对象。 - isArrayLike - 类数组。
- isArrayLikeObject - 类数组对象。
- isBlob -
Blob对象。 - isBoolean - 布尔类型或对象。
- isBuffer -
buffer对象。 - isDate -
Date对象。 - isElement -
Dom元素。 - isEmpty - 空对象、数组、
Map、Set。 - isError -
Error对象。 - isFinite - 有限数字。
- isFunction -
Function对象。 - isInteger - 整数。
- isLength - 有效的类数组长度。
- isMap -
Map对象。 - isNaN -
NaN。 - isNil -
undefined或null。 - isNull -
null。 - isNumber - 数字类型或对象。
- isObject - 对象。
- isObjectLike - 类对象。
- isPlainObject - 普通对象。
- isPromiseLike - 类
Promise对象。 - isRegExp -
RegExp对象。 - isSafeInteger - 安全整数。
- isSet -
Set对象。 - isString - 字符串类型或对象。
- isSymbol -
Symbol类型或对象。 - isTypedArray - 类型化数组。
- isUndefined -
undefined。 - isWeakMap -
WeakMap对象。 - isWeakSet -
WeakSet对象。
- isArguments -
- Util 实用工具
- castArray - 包装成数组。
- conforms - 创建断言对象属性的方法。
- conformsTo - 断言对象属性。
- constant - 返回自身的函数。
- defaultTo - 默认值。
- eq - 等于。
- gt - 大于。
- gte - 大于等于
- identity - 返回第一个参数的函数。
- lt - 小于。
- lte - 小于等于。
- noop - 空函数。
- nthArg - 返回指定位置参数的函数。
- sleep - 返回
promise延迟。 - times - 迭代执行次数。
- toFinite - 转为有限数字。
- toInteger - 转为整数。
- toLength - 转为数组长度整数。
- toNumber - 转为数字。
- toSafeInteger - 转为安全整数。
- toString - 转为字符串。
- uniqueId - 唯一 ID。