@ivujs/i-utils 1.1.1

package/dist/cjs/file/index.cjs

@@ -0,0 +1,339 @@
+'use strict';
+
+var index = require('../validate/index.cjs');
+
+/* 文件信息处理 */
+/**
+ * 格式化文件大小自动转为 B，KB，MB，GB
+ * @param {Number} size 文件的大小，单位byte字节
+ * @returns {String} 返回格式化后的字符串
+ */
+function formatFileSize(size) {
+  if (index.isEmpty(size)) return "0B";
+  if (size < 1024) {
+    return size + "B";
+  } else if (size < 1024 * 1024) {
+    return (size / 1024).toFixed(2) + "KB";
+  } else if (size < 1024 * 1024 * 1024) {
+    return (size / (1024 * 1024)).toFixed(2) + "MB";
+  } else {
+    return (size / (1024 * 1024 * 1024)).toFixed(2) + "GB";
+  }
+}
+
+/**
+ * 获得文件名称
+ * @param {String} fileName 文件的全名称，例如：测试图片.jpg
+ * @returns {String} 返回文件的名称
+ */
+function getFileName(fileName) {
+  if (index.isEmpty(fileName)) return;
+  return fileName.substring(0, fileName.lastIndexOf("."));
+}
+
+/**
+ * 获得文件后缀名
+ * @param {String} value 文件地址路径或者文件全名称，例如：http://xxx.com/mytest.jpg，测试图片.jpg
+ * @returns {String} 返回文件后缀名
+ */
+function getFileSuffix(value) {
+  if (index.isEmpty(value)) return;
+  return value.substring(value.lastIndexOf(".") + 1).toLowerCase();
+}
+
+/* 文件转换 */
+/**
+ * file转blob
+ * @param {File} file file文件
+ * @returns {Promise} 返回Promise的blob
+ */
+function fileToBlob(file) {
+  return new Promise((resolve, reject) => {
+    // 读取解析文件
+    let reader = new FileReader();
+    reader.readAsArrayBuffer(file);
+
+    // 加载成功
+    reader.onload = (e) => {
+      const blob = new Blob([e.target.result], { type: file.type });
+      resolve(blob);
+    };
+    // 加载失败
+    reader.onerror = function (err) {
+      console.error(err);
+      reject(err);
+    };
+  });
+}
+
+/**
+ * file转base64
+ * @param {File} file file文件
+ * @returns {Promise} 返回Promise的base64
+ */
+function fileToBase64(file) {
+  return new Promise((resolve, reject) => {
+    // 读取解析文件
+    let reader = new FileReader();
+    reader.readAsDataURL(file);
+
+    // 加载成功
+    reader.onload = function (e) {
+      resolve(e.target.result);
+    };
+    // 加载失败
+    reader.onerror = function (err) {
+      console.error(err);
+      reject(err);
+    };
+  });
+}
+
+/**
+ * file转url
+ * @description 适用于本地上传图片并预览，需要注意 URL.revokeObjectURL(file) 内存释放
+ * @param {File} file file文件
+ * @returns {Promise} 返回Promise的url
+ */
+function fileToUrl(file) {
+  return new Promise((resolve, reject) => {
+    try {
+      resolve(URL.createObjectURL(file));
+    } catch (err) {
+      // 捕捉异常
+      console.error(err);
+      URL.revokeObjectURL(file);
+      reject(err);
+    }
+  });
+}
+
+/**
+ * url赚file
+ * @param {String} url url地址
+ * @returns {Promise} 返回Promise的file
+ */
+function urlToFile(url) {
+  return new Promise(async (resolve, reject) => {
+    try {
+      let res = await window.fetch(url);
+      if (res.status === 200) {
+        let blob = await res.blob();
+        let file = await blobToFile(blob);
+        resolve(file);
+      }
+    } catch (err) {
+      console.error(err);
+      reject(err);
+    }
+  });
+}
+
+/**
+ * blob转file
+ * @param {Blob} blob blob数据
+ * @param {String} fileName 文件名称，默认以时间戳命名
+ * @returns {Promise} 返回Promise的file
+ */
+function blobToFile(blob, fileName = Date.now()) {
+  return new Promise((resolve, reject) => {
+    try {
+      const mime = blob.type;
+      const size = blob.size;
+      const fileSuffix = mime.split("/")[1];
+      const file = new File([blob], `${Date.now()}.${fileSuffix}`, {
+        type: mime,
+        size: size,
+        name: `${fileName}.${fileSuffix}`,
+        lastModified: Date.now(),
+        lastModifiedDate: new Date(),
+      });
+      resolve(file);
+    } catch (err) {
+      // 捕捉异常
+      console.error(err);
+      reject(err);
+    }
+  });
+}
+
+/**
+ * blob转文本
+ * @param {Blob} blob blob数据
+ * @returns {Promise} 返回Promise的文本
+ */
+function blobToText(blob) {
+  return new Promise((resolve, reject) => {
+    const reader = new FileReader();
+    reader.onload = function (event) {
+      resolve(event.target.result);
+    };
+    reader.onerror = function (error) {
+      reject(error);
+    };
+    reader.readAsText(blob);
+  });
+}
+
+/**
+ * blob转base64
+ * @param {Blob} blob blob数据
+ * @returns {Promise} 返回Promise的base64
+ */
+function blobToBase64(blob) {
+  return new Promise((resolve, reject) => {
+    // 读取解析文件
+    let reader = new FileReader();
+    reader.readAsDataURL(blob);
+
+    // 加载成功
+    reader.onload = function (e) {
+      resolve(e.target.result);
+    };
+    // 加载失败
+    reader.onerror = function (err) {
+      console.error(err);
+      reject(err);
+    };
+  });
+}
+
+/**
+ * base64转file
+ * @param {String} base64 base64数据
+ * @param {String} fileName 文件名称，默认以时间戳命名
+ * @returns {Promise} 返回Promise的file
+ */
+function base64ToFile(base64, fileName = Date.now()) {
+  return new Promise((resolve, reject) => {
+    try {
+      const arr = base64.split(",");
+      const mime = arr[0].match(/:(.*?);/)[1];
+      const fileSuffix = mime.split("/")[1];
+      const bstr = window.atob(arr[1]);
+      let n = bstr.length;
+      const u8arr = new Uint8Array(n);
+
+      while (n--) {
+        u8arr[n] = bstr.charCodeAt(n);
+      }
+      resolve(new File([u8arr], `${fileName}.${fileSuffix}`, { type: mime }));
+    } catch (err) {
+      // 捕捉异常
+      console.error(err);
+      reject(err);
+    }
+  });
+}
+
+/**
+ * base64转成blob
+ * @param {String} base64 base64数据
+ * @returns {Promise} 返回Promise的blob
+ */
+function base64ToBlob(base64) {
+  return new Promise((resolve, reject) => {
+    try {
+      const arr = base64.split(",");
+      const mime = arr[0].match(/:(.*?);/)[1];
+      const bstr = window.atob(arr[1]);
+      let n = bstr.length;
+      const u8arr = new Uint8Array(n);
+
+      while (n--) {
+        u8arr[n] = bstr.charCodeAt(n);
+      }
+      resolve(new Blob([u8arr], { type: mime }));
+    } catch (err) {
+      // 捕捉异常
+      console.error(err);
+      reject(err);
+    }
+  });
+}
+
+/**
+ * 图片url转base64
+ * @param {String} imgUrl 图片url地址
+ * @returns {Promise} 返回Promise的base64
+ */
+function urlToBase64(imgUrl) {
+  return new Promise((resolve, reject) => {
+    // 设置图片
+    const img = new Image();
+    img.src = imgUrl;
+
+    // 加载成功
+    img.onload = function () {
+      // 画图
+      const canvas = document.createElement("canvas");
+      const context = canvas.getContext("2d");
+      canvas.width = img.width;
+      canvas.height = img.height;
+      context.drawImage(img, 0, 0, img.width, img.height);
+      // 转为base64
+      const base64 = canvas.toDataURL("image/png");
+      resolve(base64);
+    };
+    // 加载失败
+    img.onerror = function (err) {
+      console.error(err);
+      reject(err);
+    };
+  });
+}
+
+/* 下载文件 */
+/**
+ * 下载blob格式的文件
+ * @param {Blob} blob blob数据
+ * @param {String} fileName 下载的文件名，不写后缀名则默认为原文件类型
+ */
+function downloadBlobFile(blob, fileName) {
+  try {
+    const objUrl = window.URL.createObjectURL(blob);
+    const link = window.document.createElement("a");
+    link.download = fileName;
+    link.href = objUrl;
+    link.click();
+    URL.revokeObjectURL(objUrl);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+/**
+ * 通过文件url地址下载
+ * @param {String} fileUrl url文件地址
+ * @param {String} fileName 下载的文件名，不写后缀名则默认为原文件类型
+ */
+function downloadFileUrl(fileUrl, fileName) {
+  try {
+    const link = window.document.createElement("a");
+    link.download = fileName;
+    link.href = fileUrl;
+    // 生成节点点击
+    window.document.body.appendChild(link);
+    link.click();
+    // 点击后移除节点
+    window.document.body.removeChild(link);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+exports.base64ToBlob = base64ToBlob;
+exports.base64ToFile = base64ToFile;
+exports.blobToBase64 = blobToBase64;
+exports.blobToFile = blobToFile;
+exports.blobToText = blobToText;
+exports.downloadBlobFile = downloadBlobFile;
+exports.downloadFileUrl = downloadFileUrl;
+exports.fileToBase64 = fileToBase64;
+exports.fileToBlob = fileToBlob;
+exports.fileToUrl = fileToUrl;
+exports.formatFileSize = formatFileSize;
+exports.getFileName = getFileName;
+exports.getFileSuffix = getFileSuffix;
+exports.urlToBase64 = urlToBase64;
+exports.urlToFile = urlToFile;

package/dist/cjs/function/index.cjs

@@ -0,0 +1,67 @@
+'use strict';
+
+/**
+ * 防抖函数
+ * @description 事件执行后，在延迟时间内如果再次执行，会清空定时器重新延迟执行，举例：用户在输入框进行输入搜索，最终是会获取到最后一次输入，节约请求资源
+ * @param {Function} fn 目标函数
+ * @param {Number} delay 延迟时间，单位毫秒，默认 1*1000 毫秒
+ * @param {Boolean} immediate 是否立即执行，默认true
+ * @returns {Function} 返回function()
+ */
+function debounce(fn, delay = 1 * 1000, immediate = true) {
+  let timer;
+  return function () {
+    const _args = arguments;
+    // 先关闭定时器
+    if (timer) clearTimeout(timer);
+    // 立即执行判断
+    if (immediate) {
+      // 如果需要立即执行
+      // 开启新定时器防止短时间内再次触发
+      const canExecute = !timer;
+      timer = setTimeout(function () {
+        timer = null;
+      }, delay);
+      if (canExecute) fn.apply(this, _args);
+    } else {
+      // 如果不需要立即执行
+      // 每次触发开启新定时器即可
+      timer = setTimeout(function () {
+        fn.apply(this, _args);
+      }, delay);
+    }
+  };
+}
+
+/**
+ * 节流函数
+ * @description 高频触发时，在指定时间间隔内只执行一次，举例：监听页面滚动，不会频繁触发，只会在固定时间内获取一次
+ * @param {Function} fn 目标函数
+ * @param {Number} interval 时间间隔，单位毫秒，默认1*1000毫秒
+ * @returns {Function} 返回function()
+ */
+function throttle(fn, interval = 1 * 1000) {
+  let timer;
+  return function () {
+    const _args = arguments;
+    // 有定时器则返回
+    if (timer) return;
+    timer = setTimeout(() => {
+      timer = null;
+      fn.apply(this, _args);
+    }, interval);
+  };
+}
+
+/**
+ * 睡眠延迟执行
+ * @description 需要配合 async/await 来达到延迟效果
+ * @param {Number} delay 延迟时间，单位毫秒，默认1*1000毫秒
+ */
+function sleep(delay = 1 * 1000) {
+  return new Promise((resolve) => setTimeout(resolve, delay));
+}
+
+exports.debounce = debounce;
+exports.sleep = sleep;
+exports.throttle = throttle;

package/dist/cjs/id/index.cjs

@@ -0,0 +1,46 @@
+'use strict';
+
+/**
+ * 生成UUID
+ * @param {Number} len 生成的长度，默认32位
+ * @param {Number} radix 进制数，默认16进制
+ * @example
+ * getUUID() // 输出：0a559343dbbf0e7e6c1de90163e7aa0a
+ * @returns {String} 返回字符串
+ */
+function getUUID(len = 32, radix = 16) {
+  const CHARS = "0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ".split("");
+  let uuid = [],
+    i;
+  radix = radix || CHARS.length;
+  if (len) {
+    for (i = 0; i < len; i++) uuid[i] = CHARS[0 | (Math.random() * radix)];
+  } else {
+    let r;
+    uuid[8] = uuid[13] = uuid[18] = uuid[23] = "-";
+    uuid[14] = "4";
+    for (i = 0; i < 36; i++) {
+      if (!uuid[i]) {
+        r = 0 | (Math.random() * 16);
+        uuid[i] = CHARS[i === 19 ? (r & 0x3) | 0x8 : r];
+      }
+    }
+  }
+  return uuid.join("");
+}
+
+/**
+ * 生成GUID
+ * @example
+ * getGUID() // 输出：275ec770-0853-6767-4875-7b270220ce9c
+ * @returns {String} 返回字符串
+ */
+function getGUID() {
+  let s4 = function () {
+    return (((1 + Math.random()) * 0x10000) | 0).toString(16).substring(1);
+  };
+  return s4() + s4() + "-" + s4() + "-" + s4() + "-" + s4() + "-" + s4() + s4() + s4();
+}
+
+exports.getGUID = getGUID;
+exports.getUUID = getUUID;