Skip to content

核心函数

Jump to bottom
j-show edited this page Feb 28, 2019 · 2 revisions

核心函数库，主要用于对于类型的识别及判断。

type(obj, [detail=false])

  • 说明
    • 类型识别，通过字符串形式返回目标类型
  • 参数
    • obj 检测对象，可以是任意类型
    • detail=false 是否进行深度识别。
  • 返回
    • 返回 string，通过字符串形式返回目标类型
    • 当detail=false时，引用类型均识别为object
    • 当detail=true时，会针对引用类型进行名称识别

is(a,b,[abs=true])

  • 说明
    • 判断对象是否相等
  • 参数
    • a、b 检测对象，可以是任意类型
    • abs=true 判断引用类型时，是否判断绝对相等（会深入判断每一个数据内容）
  • 返回
    • 返回 true/false

isSimple(value)

  • 说明
    • 判断对象是否为简单类型
  • 参数
    • value 检测对象，可以是任意类型
  • 返回
    • 返回 true/false
    • boolean/number/string，属于简单类型
    • null/undefined，属于简单类型

isNull(value, [opt])

  • 说明
    • 判断对象是否为null
  • 参数
    • value 检测对象，可以是任意类型
    • opt 检测参数
      • opt.udf=true 是否将undefined算作null
      • opt.obj=false 数组/对象为空是否算着null
      • opt为boolean时，等效opt.udf
  • 返回
    • 返回 true/false

isBool(value, [str=false])

  • 说明
    • 判断对象是否为Boolean
  • 参数
    • value 检测对象，可以是任意类型
    • str 是否判断字符串
      • str=true时，会强制将value转换为字符串判定
  • 返回
    • 返回 true/false

isNumber(value, [opt])

  • 说明
    • 判断对象是否为数字
  • 参数
    • value 检测对象，可以是任意类型
    • opt 检测参数
      • opt.nan=false 是否将NaN算作数字
      • opt.str=false 是否将字符串转换为数字判断
      • opt.int=true 是否只识别整数
      • opt.min=NaN 小于min的数，不算做数字
      • opt.max=NaN 大于max的数，不算做数字
      • opt为boolean时，等效opt.nan
  • 返回
    • 返回 true/false
    • opt.int=false时，会识别浮点数，当同时opt.str=true时，可以识别科学计数法

isString(value, [empty=false])

  • 说明
    • 判断对象是否为字符串
  • 参数
    • value 检测对象，可以是任意类型
    • empty=false 空字符串是否为字符串
  • 返回
    • 返回 true/false

isFunction(value, [type])

  • 说明
    • 判断对象是否为函数
  • 参数
    • value 检测对象，可以是任意类型
    • type 检测参数
      • type=true时，async/generator函数不算函数
      • type可以取值为'async'、'generator'，此时严格判断类型
  • 返回
    • 返回 true/false

isArray(value, [arg=false])

  • 说明
    • 判断对象是否为数组
  • 参数
    • value 检测对象，可以是任意类型
    • arg=false arguments对象是否算作数组
  • 返回
    • 返回 true/false

isObject(value, [arg])

  • 说明
    • 判断对象是否为object，可用于区分是否为json数据对象
  • 参数
    • value 检测对象，可以是任意类型
    • arg 检测参数
      • 默认只识别，基本Object
      • arg='any'/true 任意引用类型都算object
      • arg=false 任意引用类型不等于null都是object
  • 返回
    • 返回 true/false

isPromise(value)

  • 说明
    • 判断对象是否为Promise对象
  • 参数
    • value 检测对象，可以是任意类型
  • 返回
    • 返回 true/false

isGenerator(value, [obj=false])

  • 说明
    • 判断对象是否为generator，函数和对象都可返回true
  • 参数
    • value 检测对象，可以是任意类型
    • obj=false 是否检测generator对象
  • 返回
    • 返回 true/false

isJSON(value)

  • 说明
    • 判断对象是否为JSON对象
  • 参数
    • value 检测对象，可以是任意类型
  • 返回
    • 返回 true/false

isjQuery(value)

  • 说明
    • 判断对象是否为jquery对象
  • 参数
    • value 检测对象，可以是任意类型
  • 返回
    • 返回 true/false

isDOM(value)

  • 说明
    • 判断对象是否为DOM对象
  • 参数
    • value 检测对象，可以是任意类型
  • 返回
    • 返回 true/false

isDate(value, [str=false])

  • 说明
    • 判断对象是否为dete对象
  • 参数
    • value 检测对象，可以是任意类型
    • str=false 是否识别字符串内容
      • str=true时，会进行字符串内容解析
  • 返回
    • 返回 true/false

isTime(value, [str=false])

  • 说明
    • 判断对象是否为含有时间的date对象
  • 参数
    • value 检测对象，可以是任意类型
    • str=false 是否识别字符串内容
      • str=true时，会进行字符串内容解析，且内容必须包含时间格式
  • 返回
    • 返回 true/false

isGuid(value)

  • 说明
    • 判断对象是否为Guid
  • 参数
    • value 检测对象，可以是任意类型
      • value=string时，会进行内容解析
      • value值必须符合guid规则
  • 返回
    • 返回 true/false

between(value, b1, b2)

  • 说明
    • 判断数字是否b1,b2之间
  • 参数
    • value 检测对象，可以是任意类型
    • b1、b2 判断源
  • 返回
    • 返回 true/false
    • 此函数为不安全函数，将会在后续版本完善

callback(value, [index=0])

  • 说明
    • 获取对象中的回调函数
  • 参数
    • value 检测对象，可以是array或arguments对象
    • index=0 排除参数个数
      • 函数假定检测对象的最后项为回调函数，这index参数用于区分当忽略判定的参数个数
  • 返回
    • 返回 function

each(value, callback, [opt])

  • 说明
    • 对象遍历函数
  • 参数
    • value 遍历对象，可以是array|object|string|set|map类型
    • callback(item, index, type, list) 遍历函数
      • item 遍历内容
      • index 遍历序号，value=object时，为key
      • type 遍历内容类型，opt.detail=true为item的类型
      • list 真实遍历对象，当opt.desc=true时，遍历对象不等于真实遍历对象
      • 遍历函数内部返回为false时，可以中断遍历
    • opt 检测参数
      • opt.detail=false 是否识别遍历内容类型
      • opt.force=false 是否强制使用array识别方式
      • opt.index=0 起始遍历位置，value=array/string时有效
      • opt.desc=false 是否倒序排列，value=array/string时有效
      • opt=boolean时，等效opt.detail
      • opt=number时，等效opt.index
  • 返回
    • 返回 true/false，是否遍历完成
    • 无法遍历对象或遍历中断，都将返回false

unique(value, [write=false])

  • 说明
    • 去重函数
  • 参数
    • value 检测对象，必须是array对象
    • write=false 是否更改检测对象
      • write=true时，会改写value内容，引用不变
  • 返回
    • 返回 array，已去重数组

has(value, list, [callback])

  • 说明
    • 判断对象是否包含在list对象内
  • 参数
    • value 检测对象，可以是任意类型
    • list 检测列表，可以是array/object/set/map对象
    • callback 当检测存在时，触发回调函数
  • 返回
    • 返回 true/false

clone(src, dest, [opt])

  • 说明
    • 安全复制
  • 参数
    • src 复制源，可以是任意类型
    • dest 复制目标，可以是任意类型
    • opt 检测参数
      • opt.deep=false 深入复制，当复制目标为引用类型时，是否复制内容
      • opt.write=true 是否改写dest
        • opt.write=true时，会改写dest内容，引用不变
  • 返回
    • 返回 最终复制内容，类型由src和dest决定

English

Core tool library

external components

中文

核心工具库

外挂组件

Clone this wiki locally