轻函数

前身自封装常用的工具函数 👉

封装常用量、轻量的工具函数。

1️⃣ 性能优化

防抖

debounce

防抖函数：指定时间间隔内相同的事件触发只执行最后一次。

javascript

/**
 * 前端性能优化：防抖函数
 * @param {Function} fn 防抖处理回调
 * @param {Number} delay 时间间隔阈值
 * @returns {Function} 封装好的防抖函数
 */
export const debounce = function (fn, delay = 200) {
  let timer;
  return function () {
    const context = this;
    const args = arguments;
    clearTimeout(timer);
    timer = setTimeout(() => {
      fn.apply(context, args);
    }, delay);
  };
};

节流

throttle

节流函数: 指定时间间隔内只会执行一次任务。

javascript

/**
 * 前端性能优化：节流函数
 * @param {Function} fn 节流处理回调
 * @param {Number} delay 时间间隔阈值
 * @returns {Function} 封装好的节流函数
 */
export const throttle = function (fn, delay = 200) {
  let timer;
  return function () {
    if (!timer) {
      fn.apply(this, arguments);
      timer = setTimeout(() => {
        timer = null;
      }, delay);
    }
  };
},

2️⃣ 项目开发

浅拷贝

ShallowClone

浅拷贝

javascript

/**
 * 浅拷贝对象或数组
 * @param {any} value - 需要浅拷贝的值
 * @returns {any} - 浅拷贝后的值
 */
export const shallowClone = function (value) {
  if (value === null || typeof value !== "object") {
    return value;
  }

  const type = Object.prototype.toString.call(value);

  if (type === "[object Array]") {
    return [...value];
  } else if (type === "[object Object]") {
    return { ...value };
  } else {
    return value; // 对于 Date, RegExp, Map, Set 等非普通对象类型，直接返回原值
  }
};

深拷贝

DeepClone

深拷贝

javascript

/**
 * 深拷贝对象或数组
 * @param {any} value - 需要深拷贝的值
 * @param {WeakMap} [hash=new WeakMap()] - 用于处理循环引用的WeakMap
 * @returns {any} - 深拷贝后的值
 */
export const deepClone = function (value, hash = new WeakMap()) {
  if (value === null || typeof value !== "object") {
    return value;
  }

  if (hash.has(value)) {
    return hash.get(value);
  }

  let result;
  const type = Object.prototype.toString.call(value);

  if (type === "[object Array]") {
    result = [];
    hash.set(value, result);
    value.forEach((item, index) => {
      result[index] = deepClone(item, hash);
    });
  } else if (type === "[object Date]") {
    result = new Date(value);
  } else if (type === "[object RegExp]") {
    result = new RegExp(value);
  } else if (type === "[object Map]") {
    result = new Map();
    hash.set(value, result);
    value.forEach((val, key) => {
      result.set(key, deepClone(val, hash));
    });
  } else if (type === "[object Set]") {
    result = new Set();
    hash.set(value, result);
    value.forEach((val) => {
      result.add(deepClone(val, hash));
    });
  } else {
    result = Object.create(Object.getPrototypeOf(value));
    hash.set(value, result);
    for (const key in value) {
      if (value.hasOwnProperty(key)) {
        result[key] = deepClone(value[key], hash);
      }
    }
  }

  return result;
};

GUID

GetGuid

全局唯一标识符

javascript

/**
 * 全局唯一标识符 GUID
 * @returns {String} xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx
 */
export const getGuid = function () {
  return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, function (c) {
    const r = (Math.random() * 16) | 0;
    const v = c === "x" ? r : (r & 0x3) | 0x8;
    return v.toString(16);
  });
};

浏览器环境

GetBrowserEnvironment

获取浏览器环境

javascript

/**
 * 获取浏览器环境
 * @returns {Object} 浏览器环境对象 {isMobile: boolean, isPc: boolean, isWeixin: boolean}
 */
export const getBrowserEnvironment = function () {
  const { userAgent } = navigator;
  const isMobile = /Android|webOS|iPhone|iPad|iPod|BlackBerry|IEMobile|Opera Mini/i.test(navigator);
  const isPc = !isMobile;
  const isWeixin = /MicroMessenger/i.test(navigator);

  return { isMobile, isPc, isWeixin };
};

地址栏参数

GetParams

根据传入的网址，自动解析提取所有参数，并返回

javascript

/**
 * 提取地址栏中所有参数
 * @param {String} url 网址
 * @returns {Object} 解析后的参数对象
 */
export const getParams = function (url = "") {
  // str为？之后的参数部分字符串
  const str = url.substr(url.indexOf("?") + 1);
  // arr每个元素都是完整的参数键值
  const arr = str.split("&");
  // result为存储参数键值的集合
  const result = {};
  for (let i = 0; i < arr.length; i++) {
    // item的两个元素分别为参数名和参数值
    const item = arr[i].split("=");
    result[item[0]] = item[1];
  }
  return result;
};

地址栏参数(指定)

GetUrlParam

自动获取当前页面地址，根据指定参数名进行查找，返回查找到的参数值，如果没有返沪 null

javascript

/**
 * 自动获取当前页面地址，根据指定参数名进行查找，返回查找到的参数值，如果没有返沪 null
 * @param {String} name 需要查找的参数名
 * @returns {String||Null} 查找值结果
 */
export const getUrlParam = function (name) {
  var reg = new RegExp("(^|&)" + name + "=([^&]*)(&|$)"); // 构造一个含有目标参数的正则表达式对象
  var r = window.location.search.substr(1).match(reg); // 匹配目标参数
  if (r != null) return unescape(r[2]);
  return null; // 返回参数值
};

数据类型

GetTypeOf

自动获取当前页面地址，根据指定参数名进行查找，返回查找到的参数值，如果没有返沪 null

javascript

/**
 * 返回数据类型
 * @param value 待检测数据
 * @returns {String} [undefined | object | boolean | number | bigint | string | symbol | function]
 */
export const getTypeof = function (value) {
  let type = "";
  if (isArray(value)) {
    type = "array";
  } else if (isObject(value)) {
    type = "object";
  } else {
    type = typeof value;
  }
  return type;
};

/* 是否为数组 */
export const isArray = function (value) {
  return Array.isArray(value);
};

/* 是否为对象 */
export const isObject = function (value) {
  return value !== null && typeof value === "object" && !Array.isArray(value);
};

3️⃣ 时间处理

时间戳

GetTimestamp

获取现在的时间戳

javascript

/**
 * 获取当前时刻的时间戳
 * @return {String} 时间戳
 */
export const getTimestamp = function () {
  return new Date().getTime();
};

时间戳格式

TimestampToFormatTime

将时间戳转换为用户自定义的时间格式

javascript

/**
 * 将时间戳转换为用户自定义的时间格式
 * @param {Number} timestamp 时间戳
 * @param {String} rule 时间格式
 * @returns {String}
 */
export const timestampToFormatTime = function (timestamp, rule = "YYYY-MM-DD hh:mm:ss") {
  const D = new Date(timestamp);
  const timeObj = {};
  const rules = rule.match(/\w+/g);
  let ft = rule;

  timeObj["YYYY"] = D.getFullYear();
  timeObj["MM"] = D.getMonth() + 1;
  timeObj["DD"] = D.getDate();
  timeObj["hh"] = D.getHours();
  timeObj["mm"] = D.getMinutes();
  timeObj["ss"] = D.getSeconds();
  timeObj["ms"] = D.getMilliseconds();

  rules.map((f) => {
    let ff = f.length === 1 ? `${f}${f}` : f;
    ft = ft.replace(new RegExp(f, "g"), fillingZero(f, timeObj[ff]));
  });

  return ft;
};

时间格式

FormatTime

根据规则，对时间进行格式处理

javascript

/**
 * 根据规则，对时间进行格式处理
 * @param {String} time 需格式的时间 2023-05-23T12:25:42.9703802 || 2023-05-23 12:25:42.9703802
 * @param {String} rule 格式规则 yyyy-MM-dd HH:mm:ss || yyyy-M-d H:m:s 对填充零进行了判断
 * @returns {String}
 */
export const formatTime = (time, rule = "yyyy-MM-dd HH:mm:ss") => {
  const times = time.match(/\d+/g);
  const timeObj = {};
  const rules = rule.match(/\w+/g);
  let mapping = ["yyyy", "MM", "dd", "HH", "mm", "ss", "ms"];
  let ft = rule;

  // 数组转对象
  times.map((t, k) => {
    timeObj[mapping[k]] = times[k];
  });

  rules.map((f) => {
    let ff = f.length === 1 ? `${f}${f}` : f;
    ft = ft.replace(new RegExp(f, "g"), timeObj[ff]);
    // ft = ft.replace(new RegExp(f, "g"), fillingZero(f, timeObj[ff])); // 可搭配 fillingZero 使用
  });

  return ft;
};

前补零

FillingZero

根据时间字段名，自动判断是否需要填充零

javascript

/**
 * 根据时间字段名，自动判断是否需要填充零
 * @param {String} field 时间字段名
 * @param {String} value 预处理值
 * @returns {String|Number}
 */
export const fillingZero = function (field, value) {
  switch (field) {
    case "MM":
    case "dd":
    case "HH":
    case "mm":
    case "ss":
      return value < 10 ? `0${+value}` : value;
    case "M":
    case "d":
    case "H":
    case "m":
    case "s":
      return +value;
    default:
      return value;
  }
};

4️⃣ 数学运算

四则运算

Calc

基本数学运算，能够有效避免 javascript 精度问题。

javascript

/**
 * 基本数学运算，能够有效避免javascript精度问题。
 * @param { String | Number } num1 操作数
 * @param { String | Number } num2 被操作数
 * @param { String } type 计算类型
 * @return { Number } result 计算结果
 */
export const calc = function (num1, num2, type) {
  const n1 = num1.toString().split(".")[1] ?? "0";
  const n2 = num2.toString().split(".")[1] ?? "0";
  const point = 10 ** (+n1 > +n2 ? n1.length : n2.length); // 精度
  let result = 0;
  switch (type) {
    case "+":
      result = (num1 * point + num2 * point) / point;
      break;
    case "-":
      result = (num1 * point - num2 * point) / point;
      break;
    case "*":
      result = (num1 * point * (num2 * point)) / point / point;
      break;
    case "/":
      result = (num1 * point) / (num2 * point);
      break;
  }
  return result;
};

随机数

GetRandomInt

获取指定间距 [min, max] 内的随机整数

javascript

/**
 * 获取指定间距 [min, max] 内的随机整数
 * @param {Number} min 最小值
 * @param {Number} max 最大值
 * @returns 随机整数
 */
export const getRandomInt = function (min, max) {
  // 使用 Math.floor() 向下取整，确保结果是整数
  // 使用 Math.random() 生成一个介于 0 到 1 之间的随机小数
  // 然后将其乘以 (max - min + 1) 来获取一个介于 0 到 (max - min) 之间的随机小数
  // 最后再加上 min，将结果移动到指定的间距内
  return Math.floor(Math.random() * (max - min + 1)) + min;
};

随机数(相邻去重)

GetRandomIntWithExclusion

随机一个指定区间的整型数值，且允许限制重值，避免连续随机数重复

javascript

/**
 * 随机一个指定区间的整型数值，且允许限制重值，避免连续随机数重复
 * @param {Number} min 最小值
 * @param {Number} max 最大值
 * @param {Number|undefined} excludeValue 限制重值
 * @returns {Number}
 */
export const getRandomIntWithExclusion = function (min, max, excludeValue) {
  let randomValue;
  do {
    randomValue = Math.floor(Math.random() * (max - min + 1)) + min;

    // 结合 getRandomInt 的使用
    // randomValue =  getRandomInt(min, max)
  } while (excludeValue !== undefined && randomValue === excludeValue);
  return randomValue;
};

5️⃣ 字符串处理

替换字符串

ReplaceString

替换指定字符串

javascript

/**
 * 替换指定字符串
 * @param {String} sourceStr 源修改内容
 * @param {String} checkStr 需检验匹配的内容
 * @param {String} replaceStr 计划替换内容
 * @returns {String} 替换结果
 */
export const replaceString = function (sourceStr, checkStr, replaceStr = "") {
  if (!sourceStr) return console.error("sourceStr 为必传字段");
  if (!checkStr) return console.error("checkStr 为必传字段");
  const reg = new RegExp(checkStr);
  return sourceStr.replace(reg, replaceStr);
};

轻函数 ​

1️⃣ 性能优化 ​

防抖 ​

节流 ​

2️⃣ 项目开发 ​

浅拷贝 ​

深拷贝 ​

GUID ​

浏览器环境 ​

地址栏参数 ​

地址栏参数(指定) ​

数据类型 ​

3️⃣ 时间处理 ​

时间戳 ​

时间戳格式 ​

时间格式 ​

前补零 ​

4️⃣ 数学运算 ​

四则运算 ​

随机数 ​

随机数(相邻去重) ​

5️⃣ 字符串处理 ​

替换字符串 ​

轻函数

1️⃣ 性能优化

防抖

节流

2️⃣ 项目开发

浅拷贝

深拷贝

GUID

浏览器环境

地址栏参数

地址栏参数(指定)

数据类型

3️⃣ 时间处理

时间戳

时间戳格式

时间格式

前补零

4️⃣ 数学运算

四则运算

随机数

随机数(相邻去重)

5️⃣ 字符串处理

替换字符串