@whitesev/utils 2.6.7 → 2.6.8

package/dist/index.esm.js

@@ -5250,7 +5250,7 @@ class Utils {
         this.windowApi = new WindowApi(option);
     }
     /** 版本号 */
-    version = "2025.5.26";
+    version = "2025.5.28";
     addStyle(cssText) {
         if (typeof cssText !== "string") {
             throw new Error("Utils.addStyle 参数cssText 必须为String类型");
@@ -8517,6 +8517,74 @@ class Utils {
             globalThis.clearInterval(timeId);
         }
     }
+    /**
+     * 获取剪贴板信息
+     */
+    async getClipboardInfo() {
+        return new Promise((resolve) => {
+            /** 读取剪贴板 */
+            function readClipboardText() {
+                navigator.clipboard
+                    .readText()
+                    .then((clipboardText) => {
+                    resolve({
+                        error: null,
+                        content: clipboardText,
+                    });
+                })
+                    .catch((error) => {
+                    resolve({
+                        error: error,
+                        content: "",
+                    });
+                });
+            }
+            /** 申请读取剪贴板的权限 */
+            function requestPermissionsWithClipboard() {
+                navigator.permissions
+                    .query({
+                    // @ts-ignore
+                    name: "clipboard-read",
+                })
+                    .then((permissionStatus) => {
+                    readClipboardText();
+                })
+                    .catch((error) => {
+                    /* 该权限申请Api可能在该环境下不生效，尝试直接读取剪贴板 */
+                    readClipboardText();
+                });
+            }
+            /**
+             * 检查当前环境是否支持读取剪贴板Api
+             */
+            function checkClipboardApi() {
+                if (typeof navigator?.clipboard?.readText !== "function") {
+                    return false;
+                }
+                if (typeof navigator?.permissions?.query !== "function") {
+                    return false;
+                }
+                return true;
+            }
+            if (!checkClipboardApi()) {
+                resolve({
+                    error: new Error("当前环境不支持读取剪贴板Api"),
+                    content: "",
+                });
+                return;
+            }
+            if (document.hasFocus()) {
+                requestPermissionsWithClipboard();
+            }
+            else {
+                window.addEventListener("focus", () => {
+                    requestPermissionsWithClipboard();
+                }, {
+                    once: true,
+                });
+            }
+        });
+    }
 }
 let utils = new Utils();