ph-utils 0.4.7 → 0.5.0

package/README.md

@@ -1,7 +1,7 @@
-## ph-utils
-
-整理了 js 前后端开发(web + nodejs)时常用的一些工具；[详细文档](https://gitee.com/towardly/ph/wikis/Home?sort_id=4035190)
-
-### 包含如下工具文件
-
-`index` 基础工具类、`date` 跟日期相关的工具类、`file` 文件操作相关工具类[**服务端**]、`server` 服务端工具类、`validator` 数据验证、`dom` 浏览器节点操作相关[**前端**]、`web` 一些只适用于前端相关的工具、`color` 颜色相关工具
+## ph-utils
+
+整理了 js 前后端开发(web + nodejs)时常用的一些工具；[详细文档](https://gitee.com/towardly/ph/wikis/Home?sort_id=4035190)
+
+### 包含如下工具文件
+
+`index` 基础工具类、`date` 跟日期相关的工具类、`file` 文件操作相关工具类[**服务端**]、`server` 服务端工具类、`validator` 数据验证、`dom` 浏览器节点操作相关[**前端**]、`web` 一些只适用于前端相关的工具、`color` 颜色相关工具

package/lib/crypto.d.ts

@@ -14,7 +14,7 @@ export declare function bufferToHex(bf: ArrayBuffer | Uint8Array, upper?: boolea
  */
 export declare function sha(message: string, upper?: boolean, algorithm?: string): Promise<string>;
 /** 返回结果类似 */
-type AlgorithmResType = 'hex' | 'hexUpper' | 'base64' | 'raw';
+type AlgorithmResType = "hex" | "hexUpper" | "base64" | "raw";
 /**
  * AES 加密
  * @param message 待加密的数据

package/lib/crypto.js

@@ -10,10 +10,10 @@ export function bufferToHex(bf, upper = false) {
     const hashArray = Array.from(u8Array);
     return hashArray
         .map((b) => {
-        let hx = b.toString(16).padStart(2, '0');
+        let hx = b.toString(16).padStart(2, "0");
         return upper === true ? hx.toUpperCase() : hx;
     })
-        .join('');
+        .join("");
 }
 /**
  * 将16进制的数据转换为 UInt8Array
@@ -38,7 +38,7 @@ function hexToBuffer(data) {
 function bufferToBase64(bf) {
     const u8Array = bf instanceof Uint8Array ? bf : new Uint8Array(bf);
     const hashArray = Array.from(u8Array);
-    return window.btoa(String.fromCharCode.apply(null, hashArray));
+    return globalThis.btoa(String.fromCharCode.apply(null, hashArray));
 }
 /**
  * 将 Base64 转换为 UInt8Array 数据
@@ -46,9 +46,9 @@ function bufferToBase64(bf) {
  * @returns
  */
 function base64ToBuffer(data) {
-    return new Uint8Array(window
+    return new Uint8Array(globalThis
         .atob(data)
-        .split('')
+        .split("")
         .map((char) => char.charCodeAt(0)));
 }
 /**
@@ -58,14 +58,14 @@ function base64ToBuffer(data) {
  * @param algorithm   hash算法, 支持: SHA-1、SHA-256、SHA-384、SHA-512; 默认为: SHA-256
  * @returns
  */
-export async function sha(message, upper = false, algorithm = 'SHA-256') {
+export async function sha(message, upper = false, algorithm = "SHA-256") {
     const msgUint8 = new TextEncoder().encode(message);
-    const hashBuffer = await window.crypto.subtle.digest(algorithm || 'SHA-256', msgUint8);
+    const hashBuffer = await globalThis.crypto.subtle.digest(algorithm || "SHA-256", msgUint8);
     return bufferToHex(hashBuffer, upper);
 }
 function parseRsaKey(pem) {
-    const pemHeader = '-----BEGIN PUBLIC KEY-----';
-    const pemFooter = '-----END PUBLIC KEY-----';
+    const pemHeader = "-----BEGIN PUBLIC KEY-----";
+    const pemFooter = "-----END PUBLIC KEY-----";
     if (pem.indexOf(pemHeader) !== -1 && pem.indexOf(pemFooter) !== -1) {
         pem = pem.substring(pemHeader.length, pem.indexOf(pemFooter)).trim();
     }
@@ -79,34 +79,34 @@ function parseRsaKey(pem) {
  * @returns
  */
 // eslint-disable-next-line no-undef
-async function importKey(key, algorithmName, usages, encoding = 'hex') {
-    let name = 'AES-CBC';
+async function importKey(key, algorithmName, usages, encoding = "hex") {
+    let name = "AES-CBC";
     if (algorithmName == null) {
-        name = 'AES-CBC';
+        name = "AES-CBC";
     }
     else {
-        if (algorithmName.toUpperCase() === 'AES') {
-            name = 'AES-CBC';
+        if (algorithmName.toUpperCase() === "AES") {
+            name = "AES-CBC";
         }
-        else if (algorithmName.toUpperCase() === 'RSA') {
-            name = 'RSA-OAEP';
+        else if (algorithmName.toUpperCase() === "RSA") {
+            name = "RSA-OAEP";
         }
     }
     name = name.toUpperCase();
     if (usages == null || usages.length === 0) {
-        usages = ['encrypt'];
+        usages = ["encrypt"];
     }
-    let format = 'raw';
+    let format = "raw";
     let algorithm = { name };
-    if (name.includes('RSA')) {
-        format = 'spki';
-        algorithm.hash = { name: 'SHA-256' };
+    if (name.includes("RSA")) {
+        format = "spki";
+        algorithm.hash = { name: "SHA-256" };
         key = parseRsaKey(key);
     }
-    const keyBuf = encoding === 'base64' ? base64ToBuffer(key) : hexToBuffer(key);
+    const keyBuf = encoding === "base64" ? base64ToBuffer(key) : hexToBuffer(key);
     // importKey时传 false 表明该密钥不能被导出
     return Promise.all([
-        window.crypto.subtle.importKey(format, keyBuf, algorithm, false, usages),
+        globalThis.crypto.subtle.importKey(format, keyBuf, algorithm, false, usages),
         Promise.resolve({ name }),
     ]);
 }
@@ -118,18 +118,18 @@ async function importKey(key, algorithmName, usages, encoding = 'hex') {
  * @param encode     解密后返回数据格式
  * @returns
  */
-async function encrypt(algorithm, key, message, encode = 'hex') {
-    if (typeof message === 'string') {
+async function encrypt(algorithm, key, message, encode = "hex") {
+    if (typeof message === "string") {
         message = new TextEncoder().encode(message);
     }
-    const encrypted = await window.crypto.subtle.encrypt(algorithm, key, message);
-    if (encode === 'hex') {
+    const encrypted = await globalThis.crypto.subtle.encrypt(algorithm, key, message);
+    if (encode === "hex") {
         return bufferToHex(encrypted);
     }
-    else if (encode === 'hexUpper') {
+    else if (encode === "hexUpper") {
         return bufferToHex(encrypted, true);
     }
-    else if (encode === 'base64') {
+    else if (encode === "base64") {
         return bufferToBase64(encrypted);
     }
     else {
@@ -144,8 +144,8 @@ async function encrypt(algorithm, key, message, encode = 'hex') {
  * @returns
  */
 async function decrypt(algorithm, key, message) {
-    const decrypted = await window.crypto.subtle.decrypt(algorithm, key, message);
-    return new TextDecoder('utf-8').decode(decrypted);
+    const decrypted = await globalThis.crypto.subtle.decrypt(algorithm, key, message);
+    return new TextDecoder("utf-8").decode(decrypted);
 }
 /**
  * AES 加密
@@ -155,15 +155,15 @@ async function decrypt(algorithm, key, message) {
  * @param iv 加解密向量
  * @returns [加密数据,向量]
  */
-export async function aesEncrypt(message, key, encode = 'hex', iv = null) {
-    let ciphertext = '';
-    let resIv = '';
+export async function aesEncrypt(message, key, encode = "hex", iv = null) {
+    let ciphertext = "";
+    let resIv = "";
     // 导入密钥
-    const [cryptoKey, algorithm] = await importKey(key, 'aes', ['encrypt']);
+    const [cryptoKey, algorithm] = await importKey(key, "aes", ["encrypt"]);
     if (iv == null) {
-        iv = window.crypto.getRandomValues(new Uint8Array(16));
+        iv = globalThis.crypto.getRandomValues(new Uint8Array(16));
     }
-    else if (typeof iv === 'string') {
+    else if (typeof iv === "string") {
         iv = hexToBuffer(iv);
     }
     const encodeData = await encrypt({ ...algorithm, iv }, cryptoKey, message, encode);
@@ -179,8 +179,8 @@ export async function aesEncrypt(message, key, encode = 'hex', iv = null) {
  */
 function parseEncryptData(message, type) {
     let input;
-    if (typeof message === 'string') {
-        if (type === 'hex' || type === 'hexUpper') {
+    if (typeof message === "string") {
+        if (type === "hex" || type === "hexUpper") {
             input = hexToBuffer(message);
         }
         else {
@@ -200,9 +200,9 @@ function parseEncryptData(message, type) {
  * @param encode  加密后数据的形式: hex | base64
  * @returns
  */
-export async function aesDecrypt(message, key, iv, encode = 'hex') {
+export async function aesDecrypt(message, key, iv, encode = "hex") {
     // 导入密钥
-    const [cryptoKey, algorithm] = await importKey(key, 'aes', ['decrypt']);
+    const [cryptoKey, algorithm] = await importKey(key, "aes", ["decrypt"]);
     const input = parseEncryptData(message, encode);
     return await decrypt({ ...algorithm, iv: hexToBuffer(iv) }, cryptoKey, input);
 }
@@ -213,9 +213,9 @@ export async function aesDecrypt(message, key, iv, encode = 'hex') {
  * @param encode  返回类型
  * @returns
  */
-export async function rsaEncrypt(message, publicKey, encode = 'hex') {
+export async function rsaEncrypt(message, publicKey, encode = "hex") {
     // 导入密钥
-    const [cryptoKey, algorithm] = await importKey(publicKey, 'rsa', ['encrypt'], 'base64');
+    const [cryptoKey, algorithm] = await importKey(publicKey, "rsa", ["encrypt"], "base64");
     return await encrypt(algorithm, cryptoKey, message, encode);
 }
 /**
@@ -225,8 +225,10 @@ export async function rsaEncrypt(message, publicKey, encode = 'hex') {
  * @param encode  加密后的数据形式
  * @returns
  */
-export async function rsaDecrypt(privateKey, message, encode = 'hex') {
+export async function rsaDecrypt(privateKey, message, encode = "hex") {
     // 导入密钥
-    const [cryptoKey, algorithm] = await importKey(privateKey, 'rsa', ['decrypt']);
+    const [cryptoKey, algorithm] = await importKey(privateKey, "rsa", [
+        "decrypt",
+    ]);
     return await decrypt({ ...algorithm }, cryptoKey, parseEncryptData(message, encode));
 }

package/lib/file.d.ts

@@ -1,9 +1,14 @@
 /**
  * 读取文件内容为JSON格式
  * @param filepath 读取的文件路径
+ * @param errIsNull 读取失败时，是否返回 null，默认为 false[抛出异常]
+ *
+ * @example <caption>1. 文件不存在时, 返回null，而不是 catch</caption>
+ * await readJSON("./not-exists.json", true);
+ *
  * @returns Promise<unknown>
  */
-export declare function readJSON<T>(filepath: string): Promise<T>;
+export declare function readJSON<T>(filepath: string, errIsNull?: boolean): Promise<T>;
 /**
  * 写入 JSON 格式的数据到文件
  * @param file 待写入的文件
@@ -16,13 +21,6 @@ export declare function write(file: string, data: any, opts?: {
     json: boolean;
     format: boolean;
 }): Promise<unknown>;
-/**
- * 遍历文件夹
- * @param dir 待遍历的目录
- * @param callback 遍历到文件后的回调
- * @param done 遍历完成后的回调
- */
-export declare function traverseDir(dir: string, callback?: (filename: string) => void, done?: () => void): void;
 /**
  * 根据文件的 stat 获取文件的 etag
  * @param filePath 文件地址

package/lib/file.js

@@ -4,13 +4,23 @@ import fs from "node:fs";
 /**
  * 读取文件内容为JSON格式
  * @param filepath 读取的文件路径
+ * @param errIsNull 读取失败时，是否返回 null，默认为 false[抛出异常]
+ *
+ * @example <caption>1. 文件不存在时, 返回null，而不是 catch</caption>
+ * await readJSON("./not-exists.json", true);
+ *
  * @returns Promise<unknown>
  */
-export function readJSON(filepath) {
+export function readJSON(filepath, errIsNull = false) {
     return new Promise((resolve, reject) => {
         fs.readFile(path.resolve(filepath), "utf-8", (err, data) => {
             if (err) {
-                reject(err);
+                if (errIsNull) {
+                    resolve(null);
+                }
+                else {
+                    reject(err);
+                }
             }
             else {
                 resolve(JSON.parse(data));
@@ -43,48 +53,6 @@ export function write(file, data, opts) {
         });
     });
 }
-/**
- * 遍历文件夹
- * @param dir 待遍历的目录
- * @param callback 遍历到文件后的回调
- * @param done 遍历完成后的回调
- */
-export function traverseDir(dir, callback, done) {
-    let t = -1; // 定时任务，简单延迟作为遍历完成计算
-    function list(dr, cb, d) {
-        fs.readdir(path.resolve(dr), { withFileTypes: true }, (err, files) => {
-            if (err && err.errno === -4052) {
-                // 本身就是文件
-                if (typeof cb === "function")
-                    cb(dr);
-                if (typeof d === "function")
-                    d(); // 遍历完成
-            }
-            else {
-                for (let i = 0, len = files.length; i < len; i++) {
-                    const file = files[i];
-                    if (file.isFile()) {
-                        if (typeof cb === "function")
-                            cb(path.join(dr, file.name));
-                        clearTimeout(t);
-                        t = setTimeout(() => {
-                            setImmediate(() => {
-                                if (typeof done === "function") {
-                                    done();
-                                }
-                            });
-                        }, 10);
-                    }
-                    else {
-                        // 文件夹
-                        list(path.join(dr, file.name), cb, d);
-                    }
-                }
-            }
-        });
-    }
-    list(dir, callback, done);
-}
 /**
  * 根据文件的 stat 获取文件的 etag
  * @param filePath 文件地址

package/lib/validator.d.ts

@@ -2,7 +2,7 @@
  * 数据验证器
  */
 interface RuleItem {
-    rule: RegExp | ((v: any) => boolean) | 'required';
+    rule: RegExp | ((v: any) => boolean) | "required";
     message: string;
     sameKey?: string;
 }
@@ -18,7 +18,7 @@ export interface SchemaType {
     message?: string;
 }
 /**
- * 数据验证器，除了进行数据验证外，还可以同时进行数据转化
+ * 数据验证器
  */
 declare class Validator {
     rules: {
@@ -40,7 +40,10 @@ declare class Validator {
      * @param key   指定待验证的 key
      * @param value 待验证的数据
      */
-    validateKey(key: string, value: any, data?: any): Promise<boolean>;
+    validateKey(key: string, value: any, data?: any): Promise<{
+        key: string;
+        value: any;
+    }>;
     private _validateRule;
     private _parseStringRule;
 }

package/lib/validator.js

@@ -3,17 +3,17 @@
  */
 // 默认的错误提示信息
 const defaultMsgs = {
-    mobile: '请输入正确的手机号',
-    same: '两次输入不一致',
-    required: '%s为必填字段',
+    mobile: "请输入正确的手机号",
+    same: "两次输入不一致",
+    required: "%s为必填字段",
 };
-const defaultMsg = '请输入正确的数据';
+const defaultMsg = "请输入正确的数据";
 // 一些常用的验证正则
 const ruleRegexs = {
     /** 验证跟其余数据相等的正则，一般用于验证再次输入密码 */
     same: /^same:(.+)$/i,
     /** 验证手机号的正则表达式 */
-    mobile: /^1[34578]\d{9}$/,
+    mobile: /^1[345678]\d{9}$/,
     /** 非空验证的正则表达式 */
     required: /^\S{1}.*/,
 };
@@ -36,12 +36,12 @@ class ValidateError extends Error {
     key;
     constructor(key, msg) {
         super(msg);
-        this.name = 'ValidateError';
+        this.name = "ValidateError";
         this.key = key;
     }
 }
 /**
- * 数据验证器，除了进行数据验证外，还可以同时进行数据转化
+ * 数据验证器
  */
 class Validator {
     rules;
@@ -56,22 +56,23 @@ class Validator {
             let rules = [];
             let rule = schema.rules;
             if (rule != null) {
-                if (typeof rule === 'string') {
+                if (typeof rule === "string") {
                     rules = rules.concat(this._parseStringRule(rule, schema.message));
                 }
                 else if (rule instanceof Array) {
                     for (let ruleItem of rule) {
-                        if (typeof ruleItem === 'string') {
+                        if (typeof ruleItem === "string") {
                             rules.push(...this._parseStringRule(ruleItem, schema.message));
                         }
-                        else if (ruleItem instanceof RegExp || typeof ruleItem === 'function') {
+                        else if (ruleItem instanceof RegExp ||
+                            typeof ruleItem === "function") {
                             rules.push({
                                 rule: ruleItem,
                                 message: schema.message || defaultMsg,
                             });
                         }
                         else {
-                            if (typeof ruleItem.rule === 'string') {
+                            if (typeof ruleItem.rule === "string") {
                                 rules.push(...this._parseStringRule(ruleItem.rule, ruleItem.message));
                             }
                             else {
@@ -87,8 +88,9 @@ class Validator {
                     rules.push({ rule, message: defaultMsg });
                 }
             }
-            if (schema.required === true && (rules == null || rules.findIndex((r) => r.rule === 'required') === -1)) {
-                rules.push(...this._parseStringRule('required', schema.message));
+            if (schema.required === true &&
+                (rules == null || rules.findIndex((r) => r.rule === "required") === -1)) {
+                rules.push(...this._parseStringRule("required", schema.message));
             }
             parsedRules[schema.key] = rules;
         }
@@ -99,57 +101,54 @@ class Validator {
      * @param data 待验证的数据
      * @returns
      */
-    validate(data) {
-        return new Promise((resolve, reject) => {
-            let errMsg = '';
-            let errKey = '';
-            for (let key in this.rules) {
-                // eslint-disable-next-line no-prototype-builtins
-                if (this.rules.hasOwnProperty(key)) {
-                    errMsg = this._validateRule(this.rules[key], data[key], data);
-                    if (errMsg !== '') {
-                        errKey = key;
-                        errMsg = errMsg.replace('%s', key);
-                        break;
-                    }
+    async validate(data) {
+        let errMsg = "";
+        let errKey = "";
+        for (let key in this.rules) {
+            // eslint-disable-next-line no-prototype-builtins
+            if (this.rules.hasOwnProperty(key)) {
+                errMsg = this._validateRule(this.rules[key], data[key], data);
+                if (errMsg !== "") {
+                    errKey = key;
+                    errMsg = errMsg.replace("%s", key);
+                    break;
                 }
             }
-            if (errMsg === '') {
-                resolve(true);
-            }
-            else {
-                reject(new ValidateError(errKey, errMsg));
-            }
-        });
+        }
+        if (errMsg === "") {
+            return true;
+        }
+        else {
+            throw new ValidateError(errKey, errMsg);
+        }
     }
     /**
      * 只验证指定 key 的数据格式
      * @param key   指定待验证的 key
      * @param value 待验证的数据
      */
-    validateKey(key, value, data) {
-        return new Promise((resolve, reject) => {
-            let keyRules = this.rules[key];
-            let errMsg = this._validateRule(keyRules, value, data);
-            if (errMsg !== '') {
-                errMsg = errMsg.replace('%s', key);
-                reject(new ValidateError(key, errMsg));
-            }
-            else {
-                resolve(true);
-            }
-        });
+    async validateKey(key, value, data) {
+        let keyRules = this.rules[key];
+        let errMsg = this._validateRule(keyRules, value, data);
+        if (errMsg !== "") {
+            errMsg = errMsg.replace("%s", key);
+            throw new ValidateError(key, errMsg);
+        }
+        else {
+            return { key, value };
+        }
     }
     _validateRule(rules, value, data) {
-        let errMsg = '';
+        this.validateKey("", 1).catch((err) => { });
+        let errMsg = "";
         for (let rule of rules) {
             // 如果数据为空，则判断是否是必填
-            if (rule.rule === 'required') {
+            if (rule.rule === "required") {
                 if (value == null || !ruleFns.pattern(ruleRegexs.required, value)) {
                     errMsg = rule.message;
                 }
             }
-            if (typeof rule.rule === 'function') {
+            if (typeof rule.rule === "function") {
                 if (!rule.rule(value)) {
                     errMsg = rule.message;
                 }
@@ -161,7 +160,7 @@ class Validator {
                     }
                 }
             }
-            else if (rule.rule === 'required') {
+            else if (rule.rule === "required") {
                 if (!ruleFns.pattern(ruleRegexs.required, String(value))) {
                     errMsg = rule.message;
                 }
@@ -171,7 +170,7 @@ class Validator {
                     errMsg = rule.message;
                 }
             }
-            if (errMsg !== '') {
+            if (errMsg !== "") {
                 break;
             }
         }
@@ -179,7 +178,7 @@ class Validator {
     }
     _parseStringRule(rule, ruleErrMsg) {
         let rules = [];
-        let trule = rule.split('|');
+        let trule = rule.split("|");
         for (let r of trule) {
             let message = ruleErrMsg;
             let rrule = null;
@@ -192,11 +191,11 @@ class Validator {
                     if (m != null) {
                         sameKey = m[1];
                     }
-                    message = message || defaultMsgs['same'];
+                    message = message || defaultMsgs["same"];
                 }
             }
-            else if (rule === 'required') {
-                rrule = 'required';
+            else if (rule === "required") {
+                rrule = "required";
                 message = message || ruleErrMsg || defaultMsgs.required;
                 // eslint-disable-next-line no-prototype-builtins
             }

package/package.json

@@ -52,7 +52,7 @@
     },
     "./*": "./lib/*"
   },
-  "version": "0.4.7",
+  "version": "0.5.0",
   "type": "module",
   "repository": {
     "type": "git",

package/lib/clipboard.d.ts

@@ -1,11 +0,0 @@
-/**
- * 复制数据, 可以从多种类型的数据
- *    1. 直接复制文本: await copy("待复制的文本")
- *    2. 复制节点上的 data-copy-text:
- *      <button data-copy-text="这是待复制的文本">复制</button>
- *      await copy(e.target) // or await copy("#a") or await copy(document.querySelector('#a'))
- *    3. 直接复制节点本身数据: await copy('#a')
- * @param {string | HTMLElement} source 复制源, 从中解析待复制的数据
- * @returns {Promise<boolean>} 是否复制成功
- */
-export declare function copy(source: string | HTMLElement): Promise<boolean>;

package/lib/clipboard.js

@@ -1,101 +0,0 @@
-/**
- * 创建一个临时节点缓存待复制数据
- * @param {String} value - 待复制文本
- * @return {HTMLElement}
- */
-function createFakeElement(value) {
-    const fakeElement = document.createElement("textarea");
-    fakeElement.style.border = "0";
-    fakeElement.style.padding = "0";
-    fakeElement.style.margin = "0";
-    fakeElement.style.position = "absolute";
-    fakeElement.style.left = "-9999px";
-    fakeElement.style.top = "-9999";
-    fakeElement.setAttribute("readonly", "");
-    fakeElement.value = value;
-    return fakeElement;
-}
-/** 通过执行 execCommand 来执行复制 */
-function copyFromCommand(text) {
-    // 添加节点
-    const fakeEl = createFakeElement(text);
-    document.body.append(fakeEl);
-    fakeEl.focus();
-    fakeEl.select();
-    // 执行复制
-    const res = document.execCommand("copy");
-    fakeEl.remove(); // 删除节点
-    return Promise.resolve(res);
-}
-/** 使用 navigator.clipboard 复制 */
-function copyFromClipboard(text) {
-    const theClipboard = navigator.clipboard;
-    if (theClipboard != null) {
-        return theClipboard
-            .writeText(text)
-            .then(() => {
-            Promise.resolve(true);
-        })
-            .catch(() => Promise.resolve(false));
-    }
-    return Promise.resolve(false);
-}
-/** 解析待复制的文本 */
-function parseCopyText(source) {
-    let copyText = null; // 待复制文本
-    let sourceEl = null;
-    // 获取待复制数据
-    if (typeof source === "string") {
-        // 从节点拿数据
-        if (source.startsWith("#") || source.startsWith(".")) {
-            sourceEl = document.querySelector(source);
-            if (sourceEl == null) {
-                copyText = source;
-            }
-        }
-        else {
-            copyText = source;
-        }
-    }
-    if (source instanceof HTMLElement) {
-        sourceEl = source;
-    }
-    // 从节点获取待复制数据
-    if (sourceEl != null) {
-        if (sourceEl.hasAttribute("data-copy-text")) {
-            copyText = sourceEl.getAttribute("data-copy-text");
-        }
-        else {
-            const tagName = sourceEl.tagName;
-            if (tagName === "INPUT" || tagName === "TEXTAREA") {
-                copyText = sourceEl.value;
-            }
-            else {
-                copyText = sourceEl.textContent;
-            }
-        }
-    }
-    return copyText;
-}
-/**
- * 复制数据, 可以从多种类型的数据
- *    1. 直接复制文本: await copy("待复制的文本")
- *    2. 复制节点上的 data-copy-text:
- *      <button data-copy-text="这是待复制的文本">复制</button>
- *      await copy(e.target) // or await copy("#a") or await copy(document.querySelector('#a'))
- *    3. 直接复制节点本身数据: await copy('#a')
- * @param {string | HTMLElement} source 复制源, 从中解析待复制的数据
- * @returns {Promise<boolean>} 是否复制成功
- */
-export async function copy(source) {
-    // 待复制文本
-    const copyText = parseCopyText(source);
-    if (copyText == null) {
-        return Promise.resolve(false);
-    }
-    const v = await copyFromClipboard(copyText);
-    if (v === false) {
-        return copyFromCommand(copyText);
-    }
-    return Promise.resolve(true);
-}