@ivujs/i-utils 1.1.1

package/dist/es/object/index.mjs

@@ -0,0 +1,203 @@
+import { isEmpty, isObject, isArray, isDate } from '../validate/index.mjs';
+
+/* 对象转换 */
+/**
+ * map转object
+ * @param {Map} map 参数
+ * @returns {Object} 返回Object
+ */
+function mapToObject(map) {
+  let obj = Object.create(null);
+  for (let [k, v] of map) {
+    obj[k] = v;
+  }
+  return obj;
+}
+
+/**
+ * map转json字符串
+ * @param {Map} map 参数
+ * @returns {String} 返回Json字符串
+ */
+function mapToJson(map) {
+  return JSON.stringify(mapToObject(map));
+}
+
+/**
+ * object转map
+ * @param {Object} obj 参数
+ * @returns {Map} 返回Map
+ */
+function objectToMap(obj) {
+  let map = new Map();
+  for (let k of Object.keys(obj)) {
+    map.set(k, obj[k]);
+  }
+  return map;
+}
+
+/**
+ * json字符串转map
+ * @param {String} json json字符串
+ * @returns {Map} 返回Map
+ */
+function jsonToMap(json) {
+  return objectToMap(JSON.parse(json));
+}
+
+/**
+ * json对象转json字符串
+ * @param {Object} json json对象
+ * @returns {String} 返回Json字符串
+ */
+function stringifyJson(json) {
+  return JSON.stringify(json);
+}
+
+/**
+ * json字符串转json对象
+ * @param {String} json json字符串
+ * @returns {Object} 返回Json对象
+ */
+function parseJson(json) {
+  if (isEmpty(json)) return;
+  return JSON.parse(json);
+}
+
+/* 数据拷贝，对比，合并等操作 */
+/**
+ * 浅拷贝数据
+ * @param {*} source 拷贝的数据
+ * @returns {*} 返回浅拷贝的数据
+ */
+function clone(source) {
+  return Object.assign(source);
+}
+
+/**
+ * 深拷贝数据
+ * @param {*} source 拷贝的数据
+ * @returns {*} 返回深拷贝的数据
+ */
+function cloneDeep(source) {
+  //  Object
+  if (isObject(source)) {
+    let copy = {};
+    for (let attr in source) {
+      if (source.hasOwnProperty(attr)) copy[attr] = cloneDeep(source[attr]);
+    }
+    return copy;
+  }
+
+  //  Array
+  else if (isArray(source)) {
+    let copy = [];
+    for (let i = 0, len = source.length; i < len; i++) {
+      copy[i] = cloneDeep(source[i]);
+    }
+    return copy;
+  }
+
+  //  Date
+  else if (isDate(source)) {
+    let copy = new Date();
+    copy.setTime(source.getTime());
+    return copy;
+  }
+
+  // Other 原路返回源数据
+  else {
+    return source;
+  }
+}
+
+/**
+ * 比较两个对象是否相等
+ * @description 方法只能对比简单的对象，不能包含function，另外对象的属性顺序不一致也是相等的
+ * @param {Object} obj1 对象1
+ * @param {Object} obj2 对象2
+ * @returns {Boolean} 返回true和false
+ */
+function objectEquals(obj1, obj2) {
+  // 比较值相等
+  if (obj1 === obj2) {
+    return true;
+  }
+  // 比较Date
+  if (obj1 instanceof Date && obj2 instanceof Date) {
+    return obj1.getTime() === obj2.getTime();
+  }
+  // 对象比较引用
+  if (!obj1 || !obj2 || (typeof obj1 !== "object" && typeof obj2 !== "object")) {
+    return obj1 === obj2;
+  }
+  // 比较原型
+  if (obj1.prototype !== obj2.prototype) {
+    return false;
+  }
+  // 比较对象的值
+  const keys = Object.keys(obj1);
+  if (keys.length !== Object.keys(obj2).length) {
+    return false;
+  } else {
+    return keys.every((k) => objectEquals(obj1[k], obj2[k]));
+  }
+}
+
+/**
+ * 合并对象
+ * @param {Object} target 目标对象
+ * @param {Object[]} source 原对象列表
+ * @returns {Object} 返回合并后的对象
+ */
+function merge(target, ...source) {
+  return Object.assign(target, ...source);
+}
+
+/* 根据字符串属性路径操作目标对象 */
+/**
+ * 根据字符串属性路径获取目标对象的值
+ * @example
+ * let res = {code:200, data:{rows:[], pages:{current:1,pageSize:20}}}
+ * this._getTargetValueByPath(res, 'data.pages.pageSize'); // 这里会输出20
+ * @param {Object} target 目标对象
+ * @param {String} path 字符串属性路径
+ * @returns {Object} 返回目标对象
+ */
+function getTargetValueByPath(target, path = "data") {
+  const paths = (path || "data").split(".");
+  let data = target;
+  // 属性总个数
+  let lastIndex = paths.length - 1;
+  for (const index in paths) {
+    // 如果路径中没有该属性，则创建一个
+    if (data[paths[index]] === null || data[paths[index]] === undefined) {
+      data[paths[index]] = Number(index) !== lastIndex ? {} : undefined;
+    }
+    // 逐层向下找到对应属性的值
+    data = data[paths[index]];
+  }
+  return data;
+}
+
+/**
+ * 根据字符串属性路径设置目标对象的值
+ * @example
+ * let res = {code:200, data:{rows:[], pages:{current:1,pageSize:20}}}
+ * this._setTargetValueByPath(res, 'data.pages.pageSize', 30); // 打印res对象会发现pageSize的值改为了30
+ * @param {Object} target 目标对象
+ * @param {String} path 字符串属性路径
+ * @param {*} value 值
+ */
+function setTargetValueByPath(target, path = "data", value) {
+  const paths = (path || "data").split(".");
+  // 变量表达式拼接，最终结果如：target['personInfo']['personName']='xxx';
+  let fxStr = "";
+  for (const name of paths) {
+    fxStr += `['${name}']`;
+  }
+  const fn = new Function("target", `target${fxStr}=${value}`);
+  fn(target);
+}
+
+export { clone, cloneDeep, getTargetValueByPath, jsonToMap, mapToJson, mapToObject, merge, objectEquals, objectToMap, parseJson, setTargetValueByPath, stringifyJson };

package/dist/es/pagination/index.mjs

@@ -0,0 +1,134 @@
+/**
+ * 获得分页起始数
+ * @param {Object} pagination 分页参数
+ * @returns {Array} 返回起始数
+ */
+function getLimit(pagination = { page: 1, pageSize: 10, total: 0, totalPage: 0, pagerCount: 7 }) {
+  return [pagination.pageSize * (pagination.page - 1), pagination.pageSize * pagination.page];
+}
+
+/**
+ * 获得总条数
+ * @param {Object} pagination 分页参数
+ * @returns {Number} 返回总条数
+ */
+function getTotalPage(pagination = { page: 1, pageSize: 10, total: 0, totalPage: 0, pagerCount: 7 }) {
+  return Math.ceil((pagination.total || 0) / (pagination.pageSize || 0));
+}
+
+/**
+ * 获得彩虹分页器
+ * @param {Object} pagination 分页参数
+ * @param {Function} callback 回调函数
+ * @returns {Promise} 返回彩虹分页器数据
+ */
+function getRainbowPager(
+  pagination = {
+    page: 1,
+    pageSize: 10,
+    total: 0,
+    totalPage: 0,
+    pagerCount: 7,
+  },
+  callback,
+) {
+  return new Promise((resolve) => {
+    // 分页参数
+    let page = pagination.page || 1;
+    let totalPage = pagination.totalPage > 0 ? pagination.totalPage : getTotalPage(pagination);
+    let pagerCount = pagination.pagerCount || 7;
+
+    // 计算参数
+    let isEven = (pagerCount & 1) === 0;
+    let left = pagerCount >> 1;
+    let right = pagerCount >> 1;
+    let pagerLength = pagerCount;
+
+    // 计算生成的分页器数量
+    if (isEven) {
+      right++;
+    }
+    if (totalPage < pagerCount) {
+      pagerLength = totalPage;
+    }
+
+    // 分页器数组
+    let pager = new Array(pagerLength);
+
+    // 生成分页器
+    if (totalPage >= pagerCount) {
+      if (page <= left) {
+        for (let i = 0; i < pager.length; i++) {
+          pager[i] = i + 1;
+        }
+      } else if (page > totalPage - right) {
+        for (let i = 0; i < pager.length; i++) {
+          pager[i] = i + totalPage - pagerCount + 1;
+        }
+      } else {
+        for (let i = 0; i < pager.length; i++) {
+          pager[i] = i + page - left + (isEven ? 1 : 0);
+        }
+      }
+    } else {
+      for (let i = 0; i < pager.length; i++) {
+        pager[i] = i + 1;
+      }
+    }
+
+    // 支持回调函数和Promise
+    callback && callback(pager);
+    resolve(pager);
+  });
+}
+
+/**
+ * 获得上一页
+ * @param {Object} pagination 分页参数
+ * @param {Function} callback 回调函数
+ * @returns {Promise} 返回上一页
+ */
+function getPrevPage(pagination = { page: 1, pageSize: 10, total: 0, totalPage: 0, pagerCount: 7 }, callback) {
+  return new Promise((resolve) => {
+    if (pagination.page > 1) {
+      pagination.page--;
+    } else {
+      pagination.page = 1;
+    }
+
+    // 支持回调函数和Promise
+    callback && callback(pagination.page);
+    resolve(pagination.page);
+  });
+}
+
+/**
+ * 获得下一页
+ * @description 最后一页会根据totalPage参数判断，如果不传此参数，则会根据参数中pageSize和total重新计算总页数
+ * @param {Object} pagination 分页参数
+ * @param {Function} callback 回调函数
+ * @returns {Promise} 返回下一页
+ */
+function getNextPage(pagination = { page: 1, pageSize: 10, total: 0, totalPage: 0, pagerCount: 7 }, callback) {
+  return new Promise((resolve) => {
+    // 获得总页数，如果没有传totalPage，则需要根据传的pageSize和total计算
+    let totalPage = pagination.totalPage > 0 ? pagination.totalPage : getTotalPage(pagination);
+
+    // 计算当前页大于0和小与0的情况
+    if (pagination.page > 0) {
+      if (pagination.page < totalPage) {
+        pagination.page++;
+      } else {
+        pagination.page = totalPage;
+      }
+    } else {
+      pagination.page = 1;
+    }
+
+    // 支持回调函数和Promise
+    callback && callback(pagination.page);
+    resolve(pagination.page);
+  });
+}
+
+export { getLimit, getNextPage, getPrevPage, getRainbowPager, getTotalPage };

package/dist/es/random/index.mjs

@@ -0,0 +1,22 @@
+/**
+ * 生成指定大小的随机整数
+ * @description n和m参数表示最小和最大范围值，默认0-9之间范围
+ * @param {Number} min 随机数的最小值，默认 0
+ * @param {Number} max 随机数的最大值，默认 9
+ * @returns {Number} 返回指定大小的随机整数
+ */
+function getRandom(min = 0, max = 9) {
+  return Math.floor(Math.random() * (max - min + 1) + min);
+}
+
+/**
+ * 生成固定位数的随机整数
+ * @description 默认是1，代表生成0-9之间一位，如果是2，则生成10-99之间两位，以此类推
+ * @param {Number} len 固定的位数
+ * @returns {Number} 返回固定位数的随机数
+ */
+function getRandomDigit(len = 1) {
+  return Math.floor((Math.random() + Math.floor(Math.random() * 9 + 1)) * Math.pow(10, len - 1));
+}
+
+export { getRandom, getRandomDigit };

package/dist/es/regexp/index.mjs

@@ -0,0 +1,98 @@
+import { REGEXP } from '../constants/regexp.mjs';
+
+/* 正则校验方法 */
+/**
+ * 正则校验的方法
+ * @description 类型为REGEXP对应的正则
+ * @param {String|Number} value 校验的参数
+ * @param {RegExp} regex 使用的REGEXP中的正则
+ * @returns {Boolean} 返回校验的结果
+ */
+function regexpTest(value, regex) {
+  return new RegExp(regex).test(value);
+}
+
+/* 常用校验 */
+/**
+ * 是中文
+ * @param {String} value 校验的参数
+ * @returns {Boolean} 返回校验的结果
+ */
+function isChinese(value) {
+  return regexpTest(value, REGEXP.CH);
+}
+
+/**
+ * 是英文
+ * @param {String} value 校验的参数
+ * @returns {Boolean} 返回校验的结果
+ */
+function isEnglish(value) {
+  return regexpTest(value, REGEXP.EN);
+}
+
+/**
+ * 是外链
+ * @description 支持http，https，mail，tel电话
+ * @param {String} value 校验的参数
+ * @returns {Boolean} 返回校验的结果
+ */
+function isExternal(value) {
+  return regexpTest(value, REGEXP.EXTERNAL);
+}
+
+/**
+ * 是小写字母
+ * @param {String} value 校验的参数
+ * @returns {Boolean} 返回校验的结果
+ */
+function isLowerCase(value) {
+  return regexpTest(value, REGEXP.LOWER_CASE);
+}
+
+/**
+ * 是大写字母
+ * @param {String} value 校验的参数
+ * @returns {Boolean} 返回校验的结果
+ */
+function isUpperCase(value) {
+  return regexpTest(value, REGEXP.UPPER_CASE);
+}
+
+/**
+ * 是11位手机号码
+ * @param {String} value 校验的参数
+ * @returns {Boolean} 返回校验的结果
+ */
+function isMobile(value) {
+  return regexpTest(value, REGEXP.MOBILE);
+}
+
+/**
+ * 是邮箱
+ * @param {String} value 校验的参数
+ * @returns {Boolean} 返回校验的结果
+ */
+function isEmail(value) {
+  return regexpTest(value, REGEXP.EMAIL);
+}
+
+/**
+ * 是身份证号码（15-18位）
+ * @param {String} value 校验的参数
+ * @returns {Boolean} 返回校验的结果
+ */
+function isIdCard(value) {
+  return regexpTest(value, REGEXP.ID_CARD);
+}
+
+/**
+ * 是url链接
+ * @param {String} value 校验的参数
+ * @returns {Boolean} 返回校验的结果
+ */
+function isUrl(value) {
+  return regexpTest(value, REGEXP.URL);
+}
+
+export { isChinese, isEmail, isEnglish, isExternal, isIdCard, isLowerCase, isMobile, isUpperCase, isUrl, regexpTest };

package/dist/es/storage/index.mjs

@@ -0,0 +1,9 @@
+/**
+ * 浏览器是否支持 Storage
+ * @returns {Boolean} 返回true和false
+ */
+function isSupportStorage() {
+  return !!(window.localStorage && window.sessionStorage);
+}
+
+export { isSupportStorage };

package/dist/es/storage/localStorage.mjs

@@ -0,0 +1,35 @@
+/* localStorage存储 */
+/**
+ * 通过key从localStorage缓存中获取数据
+ * @param {String} key key值
+ * @returns {String} 返回数据
+ */
+function getLocalStorage(key) {
+  return window.localStorage.getItem(key) || undefined;
+}
+
+/**
+ * 设置localStorage缓存数据
+ * @param {String} key key值
+ * @param {String} value value值
+ */
+function setLocalStorage(key, value) {
+  window.localStorage.setItem(key, value);
+}
+
+/**
+ * 通过key从localStorage缓存中删除数据
+ * @param {String} key key值
+ */
+function removeLocalStorage(key) {
+  window.localStorage.removeItem(key);
+}
+
+/**
+ * 清空localStorage缓存中所有数据
+ */
+function clearLocalStorage() {
+  window.localStorage.clear();
+}
+
+export { clearLocalStorage, getLocalStorage, removeLocalStorage, setLocalStorage };

package/dist/es/storage/sessionStorage.mjs

@@ -0,0 +1,35 @@
+/* sessionStorage存储 */
+/**
+ * 通过key从sessionStorage缓存中获取数据
+ * @param {String} key key值
+ * @returns {String} 返回数据
+ */
+function getSessionStorage(key) {
+  return window.sessionStorage.getItem(key) || "";
+}
+
+/**
+ * 设置sessionStorage缓存数据
+ * @param {String} key key值
+ * @param {String} value value值
+ */
+function setSessionStorage(key, value) {
+  window.sessionStorage.setItem(key, value);
+}
+
+/**
+ * 通过key从sessionStorage缓存中删除数据
+ * @param {String} key key值
+ */
+function removeSessionStorage(key) {
+  window.sessionStorage.removeItem(key);
+}
+
+/**
+ * 清空sessionStorage缓存中所有数据
+ */
+function clearSessionStorage() {
+  window.sessionStorage.clear();
+}
+
+export { clearSessionStorage, getSessionStorage, removeSessionStorage, setSessionStorage };