nhanh-pure-function 1.3.21 → 1.4.0

package/lib/User/User.d.ts

@@ -6,109 +6,6 @@ export function _ScrollEndListener(
   callback: (trigger: "vertical" | "horizontal") => void
 ): (payload: Event) => void;
 
-/**
- * 设置量词属性
- * @param {*} data 需修改对象
- * @param {*} options 配置
- * @returns data
- */
-export function _SetQuantifierAttribute<T>(
-  data: T,
-  options?: (
-    | keyof T
-    | [
-        keyof T,
-        {
-          join?: boolean;
-          suffix?: string;
-          integer?: boolean;
-        }
-      ]
-  )[]
-): T;
-
-/**
- * 为属性值为null | undefined的属性设置默认值
- * @param data 需修改对象
- * @param options 配置
- * @returns
- */
-export function _SetDefaultValue<T>(
-  data: T,
-  options?: {
-    defaultValue?: string;
-    fieldsNotRequiringAction?: (string | number | symbol)[];
-  }
-): T;
-
-/**
- * 将字典value转为对应label
- * @param data 需修改对象
- * @param options 配置
- * @returns
- */
-export function _SetDictionary<T>(
-  data: T,
-  options: {
-    dictionaryOptions?: { [key in keyof T]: { [key: string | number]: any } };
-    dictionaryLabel?: (keyof T)[];
-    dictionaryLabelJoin?: (keyof T)[];
-    defaultValue?: string;
-  }
-): T;
-
-/**
- * 将字符串拼接的图片地址转为数组
- * @param data 需修改对象
- * @param options 配置
- * @returns
- */
-export function _SetPhoto<T>(
-  data: T,
-  options: {
-    label?: (keyof T)[];
-    defaultUrl?: {
-      [key in keyof T]: string[];
-    };
-  }
-): T;
-
-/**
- * 将接口返回的数据进行处理，得到展示数据
- * @param data object 类型的数据
- * @param options 配置
- * @returns exhibit_data
- */
-export function _Exhibit_details<T>(
-  data: T,
-  options?: {
-    dictionaryOptions?: { [key in keyof T]: { [key: string | number]: any } };
-    dictionaryLabel?: (keyof T)[];
-    dictionaryLabelJoin?: (keyof T)[];
-
-    photoLabel?: (keyof T)[];
-    photoDefaultUrl?: {
-      [key in keyof T]: string[];
-    };
-
-    quantifierLabel?: (
-      | keyof T
-      | [
-          keyof T,
-          {
-            join?: boolean;
-            suffix?: string;
-            integer?: boolean;
-          }
-        ]
-    )[];
-
-    filterLabel?: (keyof T)[];
-
-    defaultValue?: string;
-  }
-): T;
-
 type UiLibrary = "naiveUI" | "ElementPlus" | "Element";
 /**
  * 点击非指定dom(包含子级dom)时执行 callback

package/lib/User/User.js

@@ -44,205 +44,6 @@ export function _ScrollEndListener(callback) {
   };
 }
 
-/**
- * 设置量词属性
- * @param {*} data 需修改对象
- * @param {*} options 配置
- * @returns data
- */
-export function _SetQuantifierAttribute(data, options = []) {
-  if (!_IsObject(data)) {
-    console.error("异常输入：", data);
-    return data;
-  }
-
-  options.forEach((item) => {
-    if (typeof item === "string") {
-      data[item] = _FormatNumberWithUnit(data[item]);
-    } else if (Array.isArray(item)) {
-      const [label, config] = data[item];
-      if (_NotNull(label) && _IsObject(config))
-        data[label] = _FormatNumberWithUnit(label, config);
-    }
-  });
-  return data;
-}
-
-/**
- * 为属性值为null | undefined的属性设置默认值
- * @param data 需修改对象
- * @param options 配置
- * @returns
- */
-export function _SetDefaultValue(data, options = {}) {
-  if (!_IsObject(data)) {
-    console.error("异常输入：", data);
-    return data;
-  }
-
-  const { defaultValue = "--", fieldsNotRequiringAction } = options;
-
-  for (const key in data) {
-    if (Object.prototype.hasOwnProperty.call(data, key)) {
-      const element = data[key];
-      if (fieldsNotRequiringAction) {
-        if (!fieldsNotRequiringAction.includes(key) && !_NotNull(element)) {
-          data[key] = defaultValue;
-        }
-      } else if (!_NotNull(element)) {
-        data[key] = defaultValue;
-      }
-    }
-  }
-
-  return data;
-}
-
-/**
- * 将字典value转为对应label
- * @param data 需修改对象
- * @param options 配置
- * @returns
- */
-export function _SetDictionary(data, options = {}) {
-  if (!_IsObject(data)) {
-    console.error("异常输入：", data);
-    return data;
-  }
-
-  const {
-    dictionaryLabel = [],
-    dictionaryLabelJoin = [],
-    dictionaryOptions,
-    defaultValue = "--",
-  } = options;
-
-  if (dictionaryOptions) {
-    dictionaryLabel.forEach((label) => {
-      if (_NotNull(data[label])) {
-        const options = dictionaryOptions[label];
-
-        if (options) {
-          data[label] = options[data[label]];
-        } else {
-          data[label] = defaultValue;
-        }
-      } else {
-        data[label] = defaultValue;
-      }
-    });
-    dictionaryLabelJoin.forEach((label) => {
-      if (_NotNull(data[label]) && data[label] != "") {
-        const options = dictionaryOptions[label];
-        if (options) {
-          const oldvalue = data[label].split(",");
-          data[label] = "";
-          oldvalue.forEach((_label) => {
-            data[label] += options[_label];
-          });
-        } else {
-          data[label] = defaultValue;
-        }
-      } else {
-        data[label] = defaultValue;
-      }
-    });
-  }
-
-  return data;
-}
-
-/**
- * 将字符串拼接的图片地址转为数组
- * @param data 需修改对象
- * @param options 配置
- * @returns
- */
-export function _SetPhoto(data, options = {}) {
-  if (!_IsObject(data)) {
-    console.error("异常输入：", data);
-    return data;
-  }
-
-  const { label, defaultUrl } = options;
-
-  if (label) {
-    label.forEach((label) => {
-      const defaultValue = (defaultUrl && defaultUrl[label]) || [];
-      const value = data[label];
-      if (typeof value === "string") {
-        data[label] = value.split(",").filter(Boolean);
-      } else {
-        data[label] = defaultValue;
-      }
-    });
-  }
-
-  return data;
-}
-
-/**
- * 将接口返回的数据进行处理，得到展示数据
- * @param data object 类型的数据
- * @param options 配置
- * @returns exhibit_data
- */
-export function _Exhibit_details(data, options = {}) {
-  if (!_IsObject(data)) {
-    console.error("异常输入：", data);
-    return {};
-  }
-
-  data = JSON.parse(JSON.stringify(data));
-
-  const {
-    dictionaryLabel = [],
-    dictionaryLabelJoin = [],
-    dictionaryOptions,
-
-    photoLabel = [],
-    photoDefaultUrl,
-
-    quantifierLabel = [],
-
-    filterLabel = [],
-
-    defaultValue = "--",
-  } = options;
-
-  _SetDictionary(data, {
-    dictionaryLabel,
-    dictionaryLabelJoin,
-    dictionaryOptions,
-    defaultValue,
-  });
-
-  _SetPhoto(data, {
-    label: photoLabel,
-    defaultUrl: photoDefaultUrl,
-  });
-
-  _SetQuantifierAttribute(data, quantifierLabel);
-
-  _SetDefaultValue(data, {
-    defaultValue,
-    fieldsNotRequiringAction: dictionaryLabel
-      .concat(dictionaryLabelJoin)
-      .concat(photoLabel)
-      .concat(
-        quantifierLabel
-          .map((item) => {
-            if (typeof item == "string") return item;
-            if (Array.isArray(item)) return item[0];
-          })
-          .filter(Boolean)
-      )
-      .concat(filterLabel),
-  });
-
-  return data;
-}
-
 /**
  * 点击非指定dom(包含子级dom)时执行 callback
  * @param  querySelector 允许点击的 dom 顶层祖先元素选择器

package/lib/Utility/Utility.d.ts

@@ -287,7 +287,6 @@ export class _FileTypeChecker {
    * 检查给定URL的文件类型
    * @param {string} url - 文件的URL
    * @returns {keyof _FileTypeChecker['fileExtensions'] | 'unknown'} - 返回文件类型或 "unknown"
-   * @throws {Error} - 如果URL无效或指定的文件类型未知，则抛出错误
    */
   static check(url: string): keyof FileExtensions | "unknown";
   /**
@@ -295,7 +294,6 @@ export class _FileTypeChecker {
    * @param {string} url - 文件的URL
    * @param {keyof _FileTypeChecker['fileExtensions']} [type] - 可选参数，指定要检查的文件类型
    * @returns {boolean} - 返回布尔值
-   * @throws {Error} - 如果URL无效或指定的文件类型未知，则抛出错误
    */
   static check(url: string, type: keyof FileExtensions): boolean;
 
@@ -306,11 +304,18 @@ export class _FileTypeChecker {
    *
    * @param {string} url - 以逗号分隔的URL字符串，每个URL代表一个资源的位置
    * @returns {Array} - 包含每个URL及其相关信息（名称和类型）的对象数组
-   * @throws {Error} - 如果提供的URL为空或不是字符串，则抛出错误
    */
   static parseAddresses(
     url: string
-  ): { url: string; name: string; type: string }[];
+  ): { url: string; name: string; type: keyof FileExtensions | "unknown" }[];
+
+  /**
+   * 检查 MIME 类型是否与指定的模式匹配
+   * @param {string} type - 要检查的 MIME 类型（如 "image/png"）
+   * @param {string} [accept] - 可接受的 MIME 类型模式（如 "image/*, text/plain"）
+   * @returns {boolean} - 如果类型匹配，则返回 true，否则返回 false
+   */
+  static matchesMimeType(type: string, accept?: string): boolean;
 
   /**
    * 检查URL是否具有任何指定的文件扩展名

package/lib/Utility/Utility.js

@@ -269,48 +269,6 @@ export function _DownloadFile(href, fileName) {
         }
       })
       .catch(reject);
-
-    // try {
-    //   // 验证 href 和 fileName 是否为合法字符串
-    //   if (typeof href !== "string" || !href.trim()) {
-    //     throw new Error("无效的 href 参数");
-    //   }
-    //   if (typeof fileName !== "string") {
-    //     fileName = _GetHrefName(href, "downloaded_file");
-    //   }
-
-    //   fetch(href)
-    //     .then((response) => {
-    //       if (!response.ok) {
-    //         throw new Error(`文件下载失败，状态码: ${response.status}`);
-    //       }
-    //       return response.blob();
-    //     })
-    //     .then((blob) => {
-    //       const url = URL.createObjectURL(blob); // 创建文件 URL
-
-    //       const a = document.createElement("a");
-    //       a.href = url;
-    //       a.download = decodeURIComponent(fileName);
-
-    //       // 临时将 a 标签添加到 DOM，然后触发点击事件，最后移除
-    //       document.body.appendChild(a);
-    //       a.click();
-    //       document.body.removeChild(a);
-
-    //       // 释放 URL 对象
-    //       URL.revokeObjectURL(url);
-
-    //       resolve();
-    //     })
-    //     .catch((error) => {
-    //       console.error("下载文件时发生错误:", error.message);
-    //       reject(error);
-    //     });
-    // } catch (error) {
-    //   console.error("下载文件时发生错误:", error.message);
-    //   reject(error);
-    // }
   });
 }
 
@@ -448,13 +406,17 @@ export function _Debounce(fn, delay) {
  * @returns {Function}
  */
 export function _Throttle(fn, delay) {
-  let timer;
+  let lastCallTime = -Infinity;
+
   return function (...args) {
-    if (!timer) {
-      timer = setTimeout(() => {
-        fn.apply(this, args);
-        timer = null;
-      }, delay);
+    const now = performance.now();
+    if (now - lastCallTime > delay) {
+      lastCallTime = now;
+      try {
+        fn(...args);
+      } catch (error) {
+        console.error("Throttled function execution failed:", error);
+      }
     }
   };
 }
@@ -783,12 +745,12 @@ export class _FileTypeChecker {
    * @param {string} url - 文件的URL
    * @param {string} [type] - 可选参数，指定要检查的文件类型
    * @returns {string} - 如果URL与指定类型或任何已知类型匹配，则返回文件类型，否则返回"unknown"
-   * @throws {Error} - 如果URL无效或指定的文件类型未知，则抛出错误
    */
   static check(url, type) {
     // 确保提供的URL是字符串且非空
     if (!url || typeof url !== "string") {
-      throw new Error("Invalid URL provided");
+      console.error("Invalid URL provided");
+      return type ? false : "unknown";
     }
 
     // 将URL转换为小写，以确保文件扩展名匹配不区分大小写
@@ -798,7 +760,8 @@ export class _FileTypeChecker {
     if (type) {
       // 确保指定的文件类型是已知的
       if (!_FileTypeChecker.fileExtensions.hasOwnProperty(type)) {
-        throw new Error(`Unknown file type: ${type}`);
+        console.error(`Unknown file type: ${type}`);
+        return "unknown";
       }
       const extensions = _FileTypeChecker.fileExtensions[type];
       return _FileTypeChecker._checkExtension(lowerCaseUrl, extensions);
@@ -815,12 +778,12 @@ export class _FileTypeChecker {
    *
    * @param {string} url - 以逗号分隔的URL字符串，每个URL代表一个资源的位置
    * @returns {Array} - 包含每个URL及其相关信息（名称和类型）的对象数组
-   * @throws {Error} - 如果提供的URL为空或不是字符串，则抛出错误
    */
   static parseAddresses(url) {
     // 确保提供的URL是字符串且非空
     if (!url || typeof url !== "string") {
-      throw new Error("Invalid URL provided");
+      console.error("Invalid URL provided");
+      return [];
     }
 
     // 分割URL字符串并映射每个URL到包含其详细信息的对象
@@ -834,6 +797,45 @@ export class _FileTypeChecker {
     });
   }
 
+  /**
+   * 检查 MIME 类型是否与指定的模式匹配
+   * @param {string} type - 要检查的 MIME 类型（如 "image/png"）
+   * @param {string} [accept] - 可接受的 MIME 类型模式（如 "image/*, text/plain"）
+   * @returns {boolean} - 如果类型匹配，则返回 true，否则返回 false
+   */
+  static matchesMimeType(type, accept) {
+    if (
+      !accept ||
+      !type ||
+      typeof accept !== "string" ||
+      typeof type !== "string"
+    )
+      return true;
+
+    const [typeMain, typeSub] = type.split("/");
+    const mimePatterns = accept.split(",");
+
+    return mimePatterns.some((pattern) => {
+      const [patternMain, patternSub] = pattern.split("/");
+
+      // 处理简写格式（如 "image" 等价于 "image/*"）
+      const effectivePatternSub = patternSub || "*";
+      const effectiveTypeSub = typeSub || "*";
+
+      // 主类型匹配：模式包含通配符 或 类型包含通配符 或 精确匹配
+      const mainMatch =
+        patternMain === "*" || typeMain === "*" || patternMain === typeMain;
+
+      // 子类型匹配：同上逻辑
+      const subMatch =
+        effectivePatternSub === "*" ||
+        effectiveTypeSub === "*" ||
+        effectivePatternSub === effectiveTypeSub;
+
+      return mainMatch && subMatch;
+    });
+  }
+
   /**
    * 检查URL是否具有任何指定的文件扩展名
    * @param {string} url - 文件的URL

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nhanh-pure-function",
-  "version": "1.3.21",
+  "version": "1.4.0",
   "description": "纯函数工具",
   "main": "lib/Index.js",
   "scripts": {