Jiess文档

Appearance

常用工具合集 ​

@jiess/utils默认指向该工具合集；即引入时，默认指向该合集

准备工作 ​

使用包管理器，安装依赖

bash
# 安装工具模块
npm i @jiess/utils -S
# -------------------------------------------------

# 引入未经babel转化的版本（体积小，建议高版本项目中使用）
import JiessTools from '@jiess/utils';

# 引入babel转化的版本（体积大，建议低版本项目中使用）
import JiessTools from '@jiess/utils/lib-lower/JiessTools';

使用cdn引入js库

bash
# 引入未经babel转化的版本（体积小，建议高版本项目中使用）
<script src="//cdn.jsdelivr.net/npm/@jiess/utils/lib/JiessTools.js"></script>

# 引入babel转化的版本（体积大，建议低版本项目中使用）
<script src="//cdn.jsdelivr.net/npm/@jiess/utils/lib-lower/JiessTools.js"></script>

使用cdn引入后，会在全局挂载名为JiessTools的实例对象

js
// 引入时，默认指向常用工具合集
import tools, {identify} from '@jiess/utils';

合集中的工具一栏 ​

firstUpperCase ​

  • 类型 Function
  • 参数 String
  • 返回 String
  • 详细 首字母大写

firstLowerCase ​

  • 类型 Function
  • 参数 String
  • 返回 String
  • 详细 首字母小写

nfn ​

  • 类型 Function
  • 参数
  • 返回 无
  • 详细 单纯的空函数

timer ​

  • 类型 Function
  • 参数 (fn = nfn, wait = 0)
  • 返回
  • 详细 提供一个回调函数，等待给定时间后触发该回调
  • 说明 一个带有自动清除功能的计时器

注：严格模式下不能用callee,caller

identify ​

  • 类型 Function
  • 参数 (val, type)
  • 返回 Boolean
  • 详细 鉴定给定的数据是否为期望的给定类型
  • 说明 鉴别对象类型的工具函数

期望类型的说明

第二参，即期望类型不区分首字母大小写，使用用|隔开可同时校验多种数据类型

js
let val = '123';
identify(val,'number') // false
identify(val,'string') // true
// 首字母不区分大小写
identify(val,'String') // true
// 同时校验多种数据类型
identify(val,'number|string') // true

copy ​

  • 类型 Function
  • 参数 (obj_new, obj_old)
  • 返回 Object
  • 详细 将旧对象的所有属性深度拷贝到指定的新对象
  • 说明 给定的参数均为对象类型

clone ​

  • 类型 Function
  • 参数 (source)
  • 返回 Object
  • 详细 将指定对象深度克隆为的新对象
  • 说明 给定的参数为对象类型

isUndef ​

  • 类型 Function
  • 参数 (value, boo)
  • 返回 Boolean
  • 详细 判断指定数据是否为空，boo为true，则将空字符串也视为空

isDef ​

  • 类型 Function
  • 参数 (value, boo)
  • 返回 Boolean
  • 详细 判断指定数据是否定义，boo为true，则将空字符串视为未定义

getUUID ​

  • 类型 Function
  • 参数 (len = 6)
  • 返回 String
  • 详细 生成随机数
  • 说明 len为生成随机字符串的长度，默认为6

dateFormat ​

  • 类型 Function
  • 参数 (source, fmt)
  • 返回 String
  • 详细 将给定时间数据转化为指定格式
  • 说明 source需要能被Date解析的数据

toString ​

  • 类型 Function
  • 参数 (object)
  • 返回 String
  • 详细 将函数对象在内的对象转化为字符串

getCookie ​

  • 类型 Function
  • 参数 (name)
  • 返回
  • 详细 读取cookie

setCookie ​

  • 类型 Function
  • 参数 (name, value, Days = 30)
  • 返回
  • 详细 写入cookie
  • 说明 名称 - String，值 - String，存储天数 - Number

debounce1 ​

  • 类型 Function
  • 参数 (callback, wait = 100)
  • 返回
  • 详细 回调函数 - Function，等待时间 - Number

使用计时器防抖： 当高频的抖动结束以后，等待指定的时间间隔才会执行

debounce2 ​

  • 类型 Function
  • 参数 (callback, wait = 100)
  • 返回
  • 详细 回调函数 - Function，等待时间 - Number

使用时间戳防抖： 在高频触发中，只执行首次触发，只有停下来等待指定的间隔后，下次才会再次执行

throttle1 ​

  • 类型 Function
  • 参数 (callback, wait = 100)
  • 返回
  • 详细 回调函数 - Function，等待时间 - Number

使用计时器节流： 在高频的触发中，每隔固定的时间间隔才会执行一次

throttle2 ​

  • 类型 Function
  • 参数 (callback, wait = 100)
  • 返回
  • 详细 回调函数 - Function，等待时间 - Number

使用时间戳节流： 在高频的触发中，每隔固定的时间间隔才会执行一次，且首次触发会执行一次

querystring ​

  • 类型 Object
  • 属性
    • stringify(obj: TypeObj):string 将JSON对象转化为url字符串
    • parse(str: string):object 将url字符串转化为JSON对象
  • 详细

用于实现JSON对象与url字符串之间的相互转化