nhanh-pure-function 1.3.19 → 1.3.21

package/lib/Utility/Utility.d.ts

@@ -299,6 +299,19 @@ export class _FileTypeChecker {
    */
   static check(url: string, type: keyof FileExtensions): boolean;
 
+  /**
+   * 静态方法，用于解析地址信息
+   * 该方法接受一个URL字符串，将其解析为一个包含地址详情的对象数组
+   * 主要用于批量处理以逗号分隔的URL列表，为每个URL生成相应的名称和类型
+   *
+   * @param {string} url - 以逗号分隔的URL字符串，每个URL代表一个资源的位置
+   * @returns {Array} - 包含每个URL及其相关信息（名称和类型）的对象数组
+   * @throws {Error} - 如果提供的URL为空或不是字符串，则抛出错误
+   */
+  static parseAddresses(
+    url: string
+  ): { url: string; name: string; type: string }[];
+
   /**
    * 检查URL是否具有任何指定的文件扩展名
    * @param {string} url - 文件的URL

package/lib/Utility/Utility.js

@@ -226,28 +226,92 @@ export function _GetHrefName(href, defaultName = "file") {
  * @param {string} href - 文件路径
  * @param {string} [fileName] - 导出文件名
  */
-export async function _DownloadFile(href, fileName) {
-  try {
-    const response = await fetch(href); // 获取文件
-    if (!response.ok) throw new Error("文件下载失败");
-
-    const blob = await response.blob(); // 将响应转换为 Blob 对象
-    const url = URL.createObjectURL(blob); // 创建文件 URL
-
-    const a = document.createElement("a");
-    a.href = url;
-    a.download = fileName || _GetHrefName(href, "image");
-
-    // 临时将 a 标签添加到 DOM，然后触发点击事件，最后移除
-    document.body.appendChild(a);
-    a.click();
-    document.body.removeChild(a);
-
-    // 释放 URL 对象
-    URL.revokeObjectURL(url);
-  } catch (error) {
-    console.error("下载文件时发生错误:", error);
-  }
+export function _DownloadFile(href, fileName) {
+  return new Promise((resolve, reject) => {
+    _CheckConnectionWithXHR(href)
+      .then(() => {
+        try {
+          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);
+        }
+      })
+      .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);
+    // }
+  });
 }
 
 /**
@@ -556,16 +620,52 @@ export function _UpdateTargetByPath(model, path, value) {
  */
 export function _CheckConnectionWithXHR(url) {
   return new Promise((resolve, reject) => {
+    // 前置校验：确保 URL 合法
+    if (typeof url !== "string" || url.trim() === "" || !url.includes("://")) {
+      reject(new Error("Invalid URL: Must be a non-empty string"));
+      return;
+    }
+
+    // 显式处理浏览器兼容性错误（如无效协议或非法字符）
+    try {
+      const xhr = new XMLHttpRequest();
+      xhr.open("HEAD", url, true);
+    } catch (error) {
+      reject(new Error(`Invalid URL format: ${error.message}`));
+      return;
+    }
+
     const xhr = new XMLHttpRequest();
-    xhr.open("HEAD", url, true); // 发送 HEAD 请求
+    xhr.open("HEAD", url, true);
+
+    // 统一错误处理逻辑
+    const handleError = (event) => {
+      reject(new Error(`Request failed: ${event.type}`));
+    };
+
     xhr.onreadystatechange = function () {
       if (xhr.readyState === XMLHttpRequest.DONE) {
-        if (xhr.status >= 200 && xhr.status < 300) resolve();
-        else reject(xhr);
+        // 兼容性处理：status=0 可能是跨域或网络错误
+        if (xhr.status === 0) {
+          reject(new Error("Network error or CORS blocked"));
+        } else if (xhr.status >= 200 && xhr.status < 300) {
+          resolve();
+        } else {
+          reject(new Error(`HTTP Error: ${xhr.status}`));
+        }
       }
     };
-    xhr.onerror = reject;
-    xhr.send();
+
+    // 绑定所有可能的错误事件
+    xhr.onerror = handleError; // 网络层错误（如 DNS 解析失败）
+    xhr.onabort = handleError; // 请求被中止
+    xhr.ontimeout = handleError; // 超时
+
+    try {
+      xhr.send();
+    } catch (error) {
+      reject(new Error(`Request send failed: ${error.message}`));
+    }
   });
 }
 
@@ -708,6 +808,32 @@ export class _FileTypeChecker {
     return _FileTypeChecker._detectFileType(lowerCaseUrl);
   }
 
+  /**
+   * 静态方法，用于解析地址信息
+   * 该方法接受一个URL字符串，将其解析为一个包含地址详情的对象数组
+   * 主要用于批量处理以逗号分隔的URL列表，为每个URL生成相应的名称和类型
+   *
+   * @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");
+    }
+
+    // 分割URL字符串并映射每个URL到包含其详细信息的对象
+    return url.split(",").map((url) => {
+      // 从URL中提取名称
+      const name = _GetHrefName(url);
+      // 检查URL的类型
+      const type = this.check(url);
+      // 返回包含URL、名称和类型的对象
+      return { url, name, type };
+    });
+  }
+
   /**
    * 检查URL是否具有任何指定的文件扩展名
    * @param {string} url - 文件的URL

package/lib/test.ts

@@ -1,7 +1,12 @@
-import { _GetHrefName } from "./Utility/Utility";
+import { _FileTypeChecker, _GetHrefName } from "./Utility/Utility";
 
-const value = _GetHrefName(
+let value: any = _GetHrefName(
   "https://fastly.picsum.photos/id/841/805/453.jpg?hmac=RMVB2BBB6T34wI08nwWz1urBgdzSQxNR6L48hkOsTNo"
 );
 
 console.log(value);
+
+value = _FileTypeChecker.parseAddresses(
+  "https://emergency.wjtsc.com:1128/resources/life-cycle/test/1-110000251006481.pcm,https://emergency.wjtsc.com:1128/resources/life-cycle/test/car-828972667665784.mp3,https://emergency.wjtsc.com:1128/resources/life-cycle/test/317361004975528.jpg"
+);
+console.log(value);

package/package.json

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