@whitesev/utils 2.6.7 → 2.6.8

package/dist/index.umd.js

@@ -5256,7 +5256,7 @@
             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类型");
@@ -8523,6 +8523,74 @@
                 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();