1.0.0 • Published 6 years ago

jswenger v1.0.0

Weekly downloads
-
License
MIT
Repository
-
Last release
6 years ago

##wenger是什么? wenger是一个工具函数库,可提高开发效率。

##wenger有哪些功能?

  • drop:裁剪数组中的前 N 个元素,返回剩余的部分。
  • @param (array, n=1) n表示裁剪个数
  • @return Array返回数组的剩余的部分。
  • 示例:wenger.drop(1, 2, 3, 2) == 3
  • first:获得数组的首个元素。
  • @param (array)
  • @return 返回数组中的首个元素。
  • 示例:wenger.head(1, 2, 3) == 1
  • last:获取数组中的最后一个元素。
  • @param (array)
  • @return 返回数组中的最后一个元素。
  • 示例:wenger.last(1, 2, 3) == 3
  • pull:移除所有经过 SameValueZero 等值比较为 true 的元素。
  • @param (array, values)
  • @return 返回数组本身(区别于下面的without方法)。
  • 示例:wenger.pull(1, 2, 3, 1, 2, 3, 2, 3) == 1, 1
  • tail:获取数组中除了第一个元素的剩余数组。
  • @param (array)
  • @return 返回数组中除了第一个元素的剩余数组。
  • 示例:wenger.tail(1, 2, 3) == 2, 3
  • take:从数组的起始元素开始提取 N 个元素。
  • @param (array, n=1) n表示提取个数
  • @return 返回提取的元素数组。
  • 示例:wenger.take(1, 2, 3,2) == 1, 2
  • uniq:创建一个不重复的数组副本。使用了 SameValueZero 等值比较。只有首次出现的元素才会被保留。。
  • @param (array)
  • @return 返回不重复的数组。
  • 示例:wenger.uniq(2, 1, 2) == 2, 1
  • without:创建一个移除了所有提供的 values 的数组。使用了 SameValueZero 等值比较。
  • @param (array, values)
  • @return 返回一个处理好的新数组。
  • 示例:wenger.without(1, 2, 1, 3, 1, 2) == 3
  • includes:检查 值 是否在 集合中,如果集合是字符串,那么检查 值 是否在字符串中。 其他情况用 SameValueZero 等值比较。 如果指定 fromIndex 是负数,从结尾开始检索。
  • @param (collection, value, fromIndex=0)
  • @return 如果找到 value 返回 ture, 否则返回 false。
  • 示例:wenger.includes(1, 2, 3, 1) == true
  • wenger.includes({ 'user': 'fred', 'age': 40 }, 'fred') == true
  • wenger.includes('pebbles', 'eb') == true
  • debounce:创建一个防抖动函数。
  • 该函数会在 wait 毫秒后调用 func 方法。
  • @param (func, wait=0, options)
  • @return 返回具有防抖动功能的函数。
  • 示例:
  • 避免窗口在变动时出现昂贵的计算开销: jQuery(window).on('resize', _.debounce(calculateLayout, 150));
  • debounce:创建一个节流函数,在 wait 秒内最多执行 func 一次的函数。
  • @param (func, wait=0, options)
  • @return 返回节流的函数。
  • 示例:
  • 避免在滚动时过分的更新定位: jQuery(window).on('scroll', _.throttle(updatePosition, 100));
  • cloneDeep:深拷贝。
  • @param (value)
  • @return 返回拷贝后的值。
  • eq:执行 SameValueZero 比较两者的值确定它们是否相等。
  • @param (value, other)
  • @return 相等返回 true,否则返回 false。
  • 示例:
  • wenger.eq({ 'user': 'fred' }, { 'user': 'fred' }) == true
  • isArray:检查 value 是否是 Array 对象。
  • @param (value)
  • @return 如果是正确的类型,返回 true,否则返回 false。
  • 示例:
  • wenger.isArray(1) == true
  • isArrayLike:检查 value 是否是类数组。
  • @param (value)
  • @return 如果是正确的类型,返回 true,否则返回 false。
  • 示例:
  • wenger.isArrayLike(1) == true
  • wenger.isArrayLike(document.body.children) == true
  • wenger.isArrayLike('abc') == true
  • isBoolean:检查 value 是否是原始 boolean 类型或者对象。
  • @param (value)
  • @return 如果是正确的类型,返回 true,否则返回 false。
  • 示例:
  • wenger.isBoolean(false) == true
  • isEqual:执行深比较来决定两者的值是否相等。
  • @param (value, other)
  • @return 如果是正确的类型,返回 true,否则返回 false。
  • 示例:
  • wenger.isEqual({ 'user': 'fred' },{ 'user': 'fred' }) == true
  • isFinite:检查 value 是否是原始 finite number。
  • @param (value)
  • @return 如果是正确的类型,返回 true,否则返回 false。
  • 示例:
  • wenger.isFinite(3) == true
  • isInteger:检查 value 是否是整数。
  • @param (value)
  • @return 如果是正确的类型,返回 true,否则返回 false。
  • 示例:
  • wenger.isInteger(3) == true
  • isNaN:检查 value 是否是 NaN。
  • @param (value)
  • @return 如果符合 NaN 返回 true,否则返回 false。
  • 示例:
  • wenger.isNaN(NaN) == true
  • isNil:检查 value 是否是 null 或者 undefined。
  • @param (value)
  • @return 如果是 null 或者 undefined 返回 true,否则返回 false
  • 示例:
  • wenger.isNil(null) == true
  • isNull:检查 value 是否是 null。
  • @param (value)
  • @return 如果是 null 返回 true,否则返回 false
  • 示例:
  • wenger.isNull(NaN) == true
  • isNumber:检查 value 是否是原始数值型 或者 对象。
  • @param (value)
  • @return 如果是正确的类型,返回 true,否则返回 false
  • 示例:
  • wenger.isNumber(3) == true
  • isObject:检查 value 是否是 Object 的 language type。
  • @param (value)
  • @return 如果是对象返回 true,否则返回 false
  • 示例:
  • wenger.isObject({}) == true
  • wenger.isObject(null) == false
  • isSafeInteger:检查 value 是否是安全整数。 这个整数应该是符合 IEEE-754 标准的非双精度浮点数。
  • @param (value)
  • @return 如果是安全整数返回true,否则返回 false
  • 示例:
  • wenger.isSafeInteger(3) == true
  • isString:检查 value 是否是原始字符串或者对象。
  • @param (value)
  • @return 如果是正确的类型,返回 true,否则返回 false
  • 示例:
  • wenger.isString('3') == true
  • isUndefined:检查 value 是否是 undefined。
  • @param (value)
  • @return 如果是正确的类型,返回 true,否则返回 false
  • 示例:
  • wenger.isUndefined(undefined) == true
  • toInteger:转换 value 为整数 。
  • @param (value)
  • @return 返回转换后的整数
  • 示例:
  • wenger.toInteger('3') == 3
  • toNumber:转换 value 为整数 。
  • @param (value)
  • @return 返回数值
  • 示例:
  • wenger.toNumber('3') == 3
  • toSafeInteger:转换 value 为安全整数。 安全整数可以用于比较和准确的表示。
  • @param (value)
  • @return 返回转换后的整数
  • 示例:
  • wenger.toSafeInteger('3') == 3
  • random:转换 value 为安全整数。 安全整数可以用于比较和准确的表示。
  • @param (value)
  • @return 返回转换后的整数
  • 示例:
  • wenger.random(0, 5) 0 和 5 之间的数
  • wenger.random(0, 5, true) 0 和 5 之间的浮点数
  • forIn:使用 iteratee 遍历对象的自身和继承的可枚举属性。
  • @param (object, iteratee=_.identity)
  • @return 返回对象
  • forOwn:使用 iteratee 遍历自身的可枚举属性。
  • @param (object, iteratee=_.identity)
  • @return 返回对象
  • get:根据对象路径获取值。
  • @param (object, path, defaultValue)
  • @return 返回解析的值
  • keys:创建 object 自身可枚举属性名为一个数组。
  • @param (object)
  • @return 返回解析的值
  • pick:创建一个从 object 中选中的属性的对象。
  • @param (object, props)
  • @return 返回新对象
  • escape:转义字符 "&", "<", ">", '"', "'", 以及 "`" 为HTML实体字符。
  • @param (string='')
  • @return 返回转义后的字符串
  • escapeRegExp:转义RegExp 中特殊的字符 "^", "$", "\", ".", "*", "+", "?", "(", ")", "", "", "{", "}", 以及 "|"。
  • @param (string='')
  • @return 返回转义后的字符串
  • trim:去掉字符串首尾两端的空格。
  • @param (string='')
  • @return 返回处理后的字符串
  • unescape:反向版 _.escape。 这个方法转换 HTML 实体 &, <, >, ", ', 以及 ` 为对应的字符。
  • @param (string='')
  • @return 返回处理后的字符串
  • startsWith: 参数字符串是否在原字符串的头部。
  • @param (str, value)
  • @return true or false
  • isSupportWebP:判断浏览器是否支持webP格式图片。
  • @param ()
  • @return ture or false
  • isIp:是否为 IP,支持ipv4和ipv6两种格式。
  • @param (str)
  • @return ture or false
  • 示例: wenger.isIp('127.0.0.1') == true;
  • isDomain:是否为 域名。
  • @param (str)
  • @return ture or false
  • 示例:wenger.isDomain('www.baidu.com') == true;
  • isMD5:是否为MD5。
  • @param (str)
  • @return ture or false
  • 示例:wenger.isMD5('32755257ee521e95abc307bb472c40bf') == true;
  • isIMEI:是否为IMEI。
  • @param (str)
  • @return ture or false
  • isIdCard:是否为判断是否为身份证号.
  • @param (str)
  • @return ture or false
  • 示例:wenger.isIdCard('110101201609102014') == true;
  • isPhoneNum:判断是否为手机号。
  • @param (str)
  • @return ture or false
  • 示例:wenger.isPhoneNum('18612481388') == true;
  • isEmail:是否为邮箱。
  • @param (str)
  • @return ture or false
  • 示例:wenger.isEmail('1861248138@qq.com') == true;
  • isURL:是否为URL
  • @param (str)
  • @return ture or false
  • 示例:wenger.isURL('http://baidu.com') == true;
  • isBase64:检查字符串是否为base64编码
  • @param (str)
  • @return ture or false
  • isCreditCard:信用卡
  • @param (str)
  • @return ture or false
  • 示例:wenger.isCreditCard('6225768744320969') == true
  • isJSON:检查字符串是否为JSON格式
  • @param (str)
  • @return ture or false
  • 示例:wenger.isJSON('{"a":1}') == true
  • isMACAddress:检查字符串是否为MAC格式
  • @param (str)
  • @return ture or false
  • 示例:wenger.isMACAddress('00:01:6C:06:A6:29') == true
  • isPrimitive:检查是否是简单类型
  • @param value
  • @return ture or false
  • toRawType:监测变量(复杂类型)数据类型
  • @param value
  • @return 变量的数据类型

##有问题反馈 在使用中有任何问题,欢迎反馈给我,可以用以下联系方式跟我交流

  • 邮件(meng010387#126.com, 把#换成@)
  • QQ: 912918198

##说明 本包依赖于lodash(https://www.npmjs.com/package/lodash)和validatorhttps://www.npmjs.com/package/validator)。