better-util-tools

一个简单的方法合集

使用方法

• npm i better-util-tools
• or
• yarn add better-util-tools

way1：

import BetterUtilTools from "better-util-tools"
or
const BetterUtilTools = require('better-util-tools')

way2：

<script src="xxx/xxx/better-util-tools.js"></script>
or
<script src="xxx/xxx/better-util-tools.min.js"></script>

• 具体使用

const UtilTools = new BetterUtilTools()
UtilTools.random(2,10)  //8

方法集合如下：

* 判断两个数组是否相等
  arrayEqual(arr1, arr2),
* 判断该属性是否在json中的key存在
  jsonHasKey(json, key),
* 判断对象为空
  isEmptyObj(obj),
* 判断类型
  typeIs(instance),
* 判断元素是否有某个class
  hasClass(ele, cls),
* 为元素添加class
  addClass(ele, cls),
* 为元素移除class
  removeClass(ele, cls),
* 获取浏览器类型和版本
  getExplore(),
* 获取操作系统类型 MacOSX|windows|linux
  getOS(),
* 获取移动端运行系统 ios|android|windowsPhone
  getMobileSys(),
* 获取微信环境 enterprise:企业微信 wechat:微信
  getWechatEnv(),
* 判断终端 pc|mobile
  getClient(),
* 随机生成颜色
  randomColor(),
* 16进制颜色转RGB/RGBA字符串
  colorToRGB(val, opa)
* 范围内随机数
  random(low, high),
* 范围内随机字符串
  randomName(randomFlag=true, min=8, max=20),
* 判断为有效时间
  isDate(date),
* 判断是否为身份证号
  isIdCard(str),
* 判断是否为手机号
  isPhoneNum(str),
* 判断是否为URL
  isUrl(str),
* 判断是否为Email
  isEmail(str),
* 判断是否含有中文
  isChineseName(str),
* 现金额转大写
  digitUppercase(n),
* 倒计时
  formatRemainTime(endTime),
* 获取元素属性值
  getStyle(elem, style),
* 转换成北京时间
  date:new Date();
  getBJDate(date),
* 时区转换
  date:new Date()
  timezone:8
  transformTimeZone({date,timezone=8}),
* 时间格式化
  date:new Date()
  type:YYYY MM DD hh mm ss任意组合
  timeZoneBJ(是否限定为北京时间):Boolean
  formatDateTime({date, type,timeZoneBJ=true,log=true}),
* 根据年月日得知星期几
  getWeek(year, month, day),
* 获取指定年月的日历
  getMonthData(year, month),
* 获取指定年月的最大日
  getMonthMaxDay(year, month),
* 获取相对时间 day:天
  getAbsoluteDay(day=1),
* 调用支付宝验证银行卡接口
  isBankCard(axios,bankCard, cb),
* 获取url参数
  getUrlParams(url),
* 对象参数转字符串
  queryString(obj),
* 节流函数--规定在一个单位时间内，只能触发一次函数。如果这个单位时间内触发多次函数，只有一次生效。
  var throttleFn = UtilTools.throttle(() => console.log('throttleFn函数执行了'+UtilTools.formatDateTime({ type: 'hh:mm:ss' })), 1000)
  setInterval(throttleFn, 10)
  throttle(fun, delay),
* 防抖函数--在事件被触发n秒后再执行回调，如果在这n秒内又被触发，则重新计时
  const debounceFn = UtilTools.debounce(() =>{}, 1000);
  document.addEventListener('scroll', debounceFn)
  debounce(fun, delay),
* 下划线转换驼峰
  toHump(name),
* 驼峰转换下划线
  toLine(name),
* 深克隆
  deepCopy(copyObj)
* 数组去重合并
  unique([1,2,3,1,2,3,6,8,4,2])
  unique(originArray,objectArray=false,objectKey='')
* 合并对象 第一个参数为true代表深度合并（可选参数）
  extend([boolean],obj1,obj2,...objN)
* 千分位逗号格式化
  //37864.318 -> 37,864.318
  formatDecimals(num)
* 字符文本集数值转换
  //xx有限公司1已付款10086.6.846未到1303820元,采购6162108.18元 -> xx有限公司1已付款10,086.6.846未到1,303,820元,采购6,162,108.18元
  textDecimalsNum(numStr)  
* 求两个集合的交集
  intersect(a, b)
* 求两个集合的并集
  union(a, b)
* 判断一个元素是否在数组中
  contains(arr, val)
* 加
  a:数据a
  b:数据b
  fixed:Number 小数点省略到几位(>=0) 可选
  add(a, b,fixed)
* 减
  cut(a, b,fixed)
* 乘
  mul(a, b,fixed)
* 除
  div(a, b,fixed)
* 连续加
  continuityAdd(numbers=[1,2,3],fixed)
* 连续减
  continuityCut(numbers,fixed)
* 连续乘
  continuityMul(numbers,fixed)
* 连续除
  continuityDiv(numbers,fixed)
* 指定小数点位数取值,非四舍五入
  toFixed(n=12.681, fixed=2)
* 劫持粘贴板
  copyTextToClipboard(value,cb)
* 动态引入资源文件
  loadResources(['/script/element-ui/index.css','/script/vue.js','/script/element-ui/index.js'],()=>{引入所有资源后回调})
* 去除html标签
  removeHtmlTag(str)
* el是否在视口范围内
  elementIsVisibleInViewport(el, partiallyVisible = false)
* 根据url地址下载
  download(url)
* 文件操作
  file:{
    fileToBase64(file):Promise<any>,
    blobToFile(blob, fileName, mimeType),
    base64ToFile(base64, filename),
    base64ToBlob(base64),
    *根据文件file创建url
    getObjectURL(file),
    *文件流下载 res:原始response对象(含有res.headers) preview:是否新开窗口预览(非必传) success:成功回调(非必传) fail:失败回调(非必传)
    res:{
      data:Blob,
      headers:{
        'content-type':'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
        'content-disposition':'attachment; filename=excel.xlsx'
      }
    }
    streamToFile: ({ res={}, preview = false, success, fail })
  }
* 订阅观察者模式
/**
 *example:
  let em = UtilTools.EventEmitter;
  let w = 0;
  let timer = setInterval(() => {
    em.emit('work', { a: Date.now() });
    if (w == 5) {
        console.log('w>=5');
        clearInterval(timer)
    }
    w++;
  }, 20);
  em.on('work', (args) => {
      console.log(args)
  });
 */
  EventEmitter:{
    //订阅事件的方法
    on(eventName, cb)
    //触发订阅事件
    emit(eventName, args)
    //移除订阅事件
    removeListener(eventName, cb)
    //只执行一次订阅
    once(eventName, cb)
  }
* 获取图片信息
/**
 *example:
 *let izExif = UtilTools.izExif;
  izExif.getImageData(src).then(res=>{
    console.log(res)
    console.log(izExif.getFloatLocationByExif(res.exif))
  }).catch(e=>{
    console.log(e)
  })
 */
  izExif:{
    解析图片  url地址/base64/blob
    getImageData(src)
    获取图片信息
    getFloatLocationByExif(res.exif)
  }
  
* 异步并发调度
/**
 *example:
 *传入并发数量最多2个
  const scheduler = new UtilTools.scheduler(2);
  for (let index = 0; index < 10; index++) {
    scheduler.add(()=>fetch('https://xxx.xx.com')).then(()=>{
      console.log(index);
    })
  }
 */
  scheduler:{
    add
  }
 
* retry异步重试
/**
 * promise重试方法
 * options:{
 *   fn:返回异步方法
 *   max:最大重试次数，默认3次
 *   flag:{
 *      key:'status' 调用成功标志key 默认status
 *      value:200  调用成功标志value 默认200
 *   }
 * }
 *  example:
    const fn = () => axios.get('http://xxx.xx.com')
    UtilTools.retry({fn}).then(result=>{
        console.log('result!!!!');
        console.log(result);
    }).catch(e=>{
      console.log(e)
    })
*/
 retry(options).then(result=>{
      console.log('result!!!!');
      console.log(result);
  }).catch(e=>{
    /* {
          "code": "-1",
          "success": false,
          "msg": "Sorry, failed to retry 3 times"
        }
    */
    console.log(e)
  }

程序更新日志

0.0.15-beta.33 更新时间：2024-09-07

1. 优化getUrlParams方法，解决中文解析异常问题

0.0.15-beta.32 更新时间：2024-03-13

1. 优化formatDecimals方法，新增textDecimalsNum文本中数值替换转换

0.0.15-beta.31 更新时间：2024-02-24

1. 优化retry异步重试方法

0.0.15-beta.30 更新时间：2024-01-20

1. 新增retry异步重试方法

0.0.15-beta.29 更新时间：2023-10-16

1. 修复getWechatEnv获取微信环境异常问题

0.0.15-beta.28 更新时间：2023-09-23

1. 新增异步并发调度类

0.0.15-beta.27 更新时间：2023-4-28

1. 配置生产环境去除 console、debugger

0.0.15-beta.26 更新时间：2023-4-28

1. 修复格式化时间打包异常问题

0.0.15-beta.25 更新时间：2023-4-27

1. 修复格式化 iso 时间异常问题

0.0.15-beta.24 更新时间：2023-4-27

1. 修复手机号校验包含不全问题
2. fileToBase64 返回 promise

0.0.15-beta.23 更新时间：2023-3-17

1. 新增解析、获取图片信息方法 getImageData getFloatLocationByExif
2. formatDateTime 方法修改,date 传入值检测，无效时间默认返回空

0.0.15-beta.22 更新时间：2022-12-23

1. streamToFile 方法调用报错修复

0.0.15-beta.21 更新时间：2022-12-22

1. 文件操作新增根据文件 file 创建 url 方法：getObjectURL
2. 文件操作新增文件流下载方法：streamToFile

0.0.15-beta.20 更新时间：2022-11-19

1. 修复 intersect 交集方法没有交集时返回[null],改为返回[]

0.0.15-beta.19 更新时间：2022-11-12

1. formatDateTime 方法修改,date 传入值检测，无效时间默认使用系统当前时间，抛出错误提示(log 参数可关闭提示)
2. 新增 isDate 方法判断是否为有效时间

0.0.15-beta.18 更新时间：2022-07-08

1. deepCopy 方法传入参数由两个(空值,克隆对象)改为一个(克隆对象),方法自动推导