nhanh-pure-function 1.2.4 → 1.2.6

package/lib/User.d.ts

@@ -128,47 +128,6 @@ export function _Exhibit_details<T>(
   }
 ): T;
 
-// 定义加载状态更新函数类型
-type LoadingStateUpdater = (newState: boolean) => void;
-// 定义加载控制器的类型
-interface LoadingController {
-  invokers: Set<any>; // 假设invoker可以是任何类型
-  timer: number | null;
-  startTime: number;
-  loadingState: LoadingStateUpdater;
-  delayTime: number;
-  minDisplayTime: number;
-}
-/** 多组loading控制器 */
-export class _LoadingController {
-  #controllersCollection: Map<string, LoadingController>;
-
-  // addController方法的类型定义
-  addController(
-    key: string,
-    config: {
-      loadingState: LoadingStateUpdater;
-      delayTime?: number;
-      minDisplayTime?: number;
-    }
-  ): void;
-
-  // deleteController方法的类型定义
-  deleteController(key: string): void;
-
-  // getController方法的类型定义
-  getController(key?: string): LoadingController;
-
-  // resetController方法的类型定义
-  resetController(key: string): void;
-
-  // startLoading方法的类型定义
-  startLoading(invoker: any, key?: string): void;
-
-  // stopLoading方法的类型定义
-  stopLoading(invoker: any, key?: string): void;
-}
-
 type UiLibrary = "naiveUI" | "ElementPlus" | "Element";
 /**
  * 点击非指定dom(包含子级dom)时执行 callback

package/lib/User.js

@@ -294,97 +294,6 @@ export function _Exhibit_details(data, options = {}) {
   return data;
 }
 
-/** 多组loading控制器 */
-export class _LoadingController {
-  #controllersCollection = new Map();
-  constructor() {}
-
-  addController(key = "default", config) {
-    if (this.#controllersCollection.has(key))
-      throw new Error("key为: " + key + " 的loading控制器已存在, 请重命名。");
-
-    const {
-      loadingState /** 更新/获取 loading 状态的方法 */,
-      delayTime = 200 /** 延迟时间 */,
-      minDisplayTime = 400 /** 最少显示时间 */,
-    } = config;
-    this.#controllersCollection.set(key, {
-      invokers: new Set(),
-      timer: null,
-      startTime: 0,
-      loadingState,
-      delayTime,
-      minDisplayTime,
-    });
-  }
-
-  deleteController(key) {
-    this.#controllersCollection.delete(key);
-  }
-
-  getController(key = "default") {
-    const controller = this.#controllersCollection.get(key);
-    if (!controller)
-      throw new Error("还未添加key为: " + key + " 的loading控制器");
-    return controller;
-  }
-
-  resetController(key) {
-    const controller = this.getController(key);
-    const { invokers, loadingState, timer } = controller;
-    invokers.clear();
-    loadingState(false);
-    controller.startTime = 0;
-    if (timer) clearTimeout(timer);
-    controller.timer = null;
-  }
-
-  startLoading(invoker, key) {
-    const controller = this.getController(key);
-    const { invokers, timer, loadingState, delayTime } = controller;
-
-    invokers.add(invoker);
-
-    if (invokers.size > 1) return;
-
-    if (delayTime) {
-      if (timer) {
-        return;
-      } else if (!loadingState()) {
-        controller.timer = setTimeout(() => {
-          loadingState(true);
-          controller.startTime = +new Date();
-          controller.timer = null;
-        }, delayTime);
-      }
-    } else {
-      loadingState(true);
-      controller.startTime = +new Date();
-    }
-  }
-
-  stopLoading(invoker, key) {
-    const controller = this.getController(key);
-    const { invokers, startTime, minDisplayTime } = controller;
-
-    const isFinished = invokers.has(invoker) && invokers.size == 1;
-
-    if (isFinished) {
-      const displayTime = +new Date() - startTime;
-      if (displayTime >= minDisplayTime) {
-        this.resetController(key);
-      } else {
-        setTimeout(
-          () => this.stopLoading(invoker, key),
-          displayTime - minDisplayTime
-        );
-      }
-    } else {
-      invokers.delete(invoker);
-    }
-  }
-}
-
 /**
  * 点击非指定dom(包含子级dom)时执行 callback
  * @param  querySelector 允许点击的 dom 顶层祖先元素选择器

package/lib/Utility.d.ts

@@ -81,7 +81,7 @@ export function _MergeObjects<T, T1>(A: T, B: T1): T & T1;
 export function _TimeTransition(
   time: number | Date,
   template: string,
-  pad: boolean
+  pad?: boolean
 ): string;
 
 /**
@@ -202,3 +202,35 @@ export function _Throttle<T extends Function>(
   fn: T,
   delay: number
 ): (...args: ExtractParameters<T>) => void;
+
+/**
+ * 数据类型
+ * @param {any} value
+ * @returns string
+ */
+export function _DataType(
+  value: string
+):
+  | "string"
+  | "number"
+  | "bigint"
+  | "boolean"
+  | "symbol"
+  | "undefined"
+  | "object"
+  | "function"
+  | "array"
+  | "null";
+
+/**
+ * 复制到剪贴板
+ * @param {string} text
+ */
+export function _CopyToClipboard(text: string): Promise<void>;
+
+/**
+ * 格式化文件大小
+ * @param {number} size
+ * @returns string
+ */
+export function _FormatFileSize(size: number): string;

package/lib/Utility.js

@@ -335,7 +335,15 @@ export function _CreateAndDownloadFile(content, fileName, options) {
  * @returns {Object}
  */
 export function _GetQueryParams(url) {
-  return Object.fromEntries(new URL(url).searchParams);
+  const queryString = url.split("?")[1] || "";
+  const params = new URLSearchParams(queryString);
+  const result = {};
+
+  params.forEach((value, key) => {
+    result[key] = value;
+  });
+
+  return result;
 }
 
 /**
@@ -381,3 +389,100 @@ export function _Throttle(fn, delay) {
     }
   };
 }
+
+/**
+ * 数据类型
+ * @param {any} value
+ * @returns string
+ */
+export function _DataType(value) {
+  if (Array.isArray(value)) return "array";
+  if (value === null) return "null";
+  return typeof value;
+}
+
+/**
+ * 复制到剪贴板
+ * @param {string} text
+ */
+export function _CopyToClipboard(text) {
+  const handleSuccess = () => Promise.resolve();
+  const handleError = (error) => {
+    console.error(error);
+    return Promise.reject(error);
+  };
+
+  /** 最新方式 */
+  function writeText() {
+    return navigator.clipboard
+      .writeText(text)
+      .then(handleSuccess)
+      .catch(handleError);
+  }
+  /** 旧方式 - createRange */
+  function createRange() {
+    const div = document.createElement("div");
+    div.innerText = text;
+    document.body.appendChild(div);
+
+    const range = document.createRange();
+    range.selectNodeContents(div);
+    const selection = window.getSelection();
+
+    let isFinished = false;
+    if (selection) {
+      selection.removeAllRanges();
+      selection.addRange(range);
+
+      isFinished = document.execCommand("copy");
+    }
+    document.body.removeChild(div);
+    return isFinished ? Promise.resolve() : Promise.reject();
+  }
+  /** 旧方式 - execCommand */
+  function execCommand() {
+    const textarea = document.createElement("textarea");
+    textarea.value = text;
+    document.body.appendChild(textarea);
+
+    textarea.select();
+    textarea.setSelectionRange(0, text.length); // 对于移动设备
+
+    let isFinished = false;
+
+    /** aria-hidden 及 tabindex 可能会影响聚焦元素 */
+    if (document.activeElement === textarea)
+      isFinished = document.execCommand("Copy", true);
+
+    document.body.removeChild(textarea);
+    return isFinished ? Promise.resolve() : Promise.reject();
+  }
+
+  function old() {
+    return createRange()
+      .then(handleSuccess)
+      .catch(() => {
+        execCommand()
+          .then(handleSuccess)
+          .catch(() => handleError("复制方式尽皆失效"));
+      });
+  }
+
+  if (navigator.clipboard) return writeText().catch(old);
+  return old();
+}
+
+/**
+ * 格式化文件大小
+ * @param {number} size
+ * @returns string
+ */
+export function _FormatFileSize(size) {
+  const units = ["B", "KB", "MB", "GB", "TB", "PB"];
+  let unitIndex = 0;
+  while (size > 1024) {
+    size /= 1024;
+    unitIndex++;
+  }
+  return `${Math.round(size * 100) / 100} ${units[unitIndex]}`;
+}

package/package.json

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