my-uniapp-tools 1.0.13 → 1.0.14

package/dist/my-uniapp-tools.esm.js

@@ -1331,6 +1331,72 @@ const getTopNavBarHeight = () => {
         };
     }
 };
+/**
+ * 修改浏览器标题
+ * @param title 新的页面标题
+ * @description 动态修改浏览器标签页显示的标题，仅在H5/Web平台有效
+ * @example
+ * // 修改页面标题
+ * setPageTitle('新的页面标题')
+ */
+const setPageTitle = (title) => {
+    return safeSync(() => {
+        const platform = getPlatform();
+        // 只在H5/Web平台执行
+        if (platform === 'h5' || platform === 'web') {
+            // #ifdef H5 || WEB
+            if (typeof document !== 'undefined') {
+                document.title = title;
+                console.log('页面标题已更新为:', title);
+                return true;
+            }
+            // #endif
+        }
+        else {
+            console.warn('setPageTitle 仅在H5/Web平台有效');
+        }
+        return false;
+    }, 'system', 'SET_PAGE_TITLE_ERROR', false);
+};
+/**
+ * 修改浏览器图标（favicon）
+ * @param iconUrl 新的图标URL地址
+ * @param iconType 图标类型，默认为 'image/x-icon'
+ * @description 动态修改浏览器标签页显示的图标，仅在H5/Web平台有效
+ * @example
+ * // 修改页面图标
+ * setPageIcon('https://example.com/new-icon.ico')
+ * // 或使用PNG格式
+ * setPageIcon('https://example.com/new-icon.png', 'image/png')
+ */
+const setPageIcon = (iconUrl, iconType = 'image/x-icon') => {
+    return safeSync(() => {
+        const platform = getPlatform();
+        // 只在H5/Web平台执行
+        if (platform === 'h5' || platform === 'web') {
+            // #ifdef H5 || WEB
+            if (typeof document !== 'undefined') {
+                // 移除现有的favicon链接
+                const existingLinks = document.querySelectorAll('link[rel*="icon"]');
+                existingLinks.forEach(link => link.remove());
+                // 创建新的favicon链接
+                const link = document.createElement('link');
+                link.rel = 'icon';
+                link.type = iconType;
+                link.href = iconUrl;
+                // 添加到head中
+                document.head.appendChild(link);
+                console.log('页面图标已更新为:', iconUrl);
+                return true;
+            }
+            // #endif
+        }
+        else {
+            console.warn('setPageIcon 仅在H5/Web平台有效');
+        }
+        return false;
+    }, 'system', 'SET_PAGE_ICON_ERROR', false);
+};
 
 /**
  * 本地存储相关工具函数（优化版本）
@@ -1687,46 +1753,500 @@ function batchGetStorage(keys) {
     return result;
 }
 
-// 核心功能
-
-// 版本信息
-const VERSION = '1.0.8';
-
-// 初始化函数
-async function initUniAppTools(config = {}) {
-  const {
-    enablePerformanceMonitor = false,
-    enableErrorHandler = true,
-    logLevel = 'warn'
-  } = config;
-
-  if (enableErrorHandler) {
-    const { ErrorHandler } = await Promise.resolve().then(function () { return errorHandler; });
-    const errorHandler$1 = ErrorHandler.getInstance();
-
-    // 设置全局错误监听
-    if (enablePerformanceMonitor) {
-      errorHandler$1.onError((error) => {
-        console.log(`[UniAppTools] ${error.module} - ${error.code}: ${error.message}`);
-      });
-    }
-  }
-
-  if (enablePerformanceMonitor) {
-    const { PerformanceMonitor } = await Promise.resolve().then(function () { return performance$1; });
-    const monitor = PerformanceMonitor.getInstance();
-
-    // 定期输出性能报告
-    setInterval(() => {
-      const report = monitor.getReport();
-      if (report.slowest.length > 0) {
-        console.log('[UniAppTools] 性能报告:', report);
-      }
-    }, 60000); // 每分钟输出一次
-  }
-
-  console.log(`[UniAppTools] v${VERSION} 初始化完成`);
+/**
+ * 文件上传相关工具函数
+ * 支持微信小程序、支付宝小程序、H5多端兼容
+ */
+/**
+ * 默认上传配置
+ */
+const DEFAULT_UPLOAD_CONFIG = {
+    name: 'file',
+    maxSize: 10, // 10MB
+    allowedTypes: ['jpg', 'jpeg', 'png', 'gif', 'webp'],
+    showToast: true,
+    timeout: 60000, // 60秒
+    successMessage: '上传成功',
+    failMessage: '上传失败'
+};
+/**
+ * 默认选择文件配置
+ */
+const DEFAULT_CHOOSE_CONFIG = {
+    type: 'image',
+    count: 1,
+    sizeType: ['original', 'compressed'],
+    sourceType: ['album', 'camera'],
+    extension: [],
+    maxSize: 10, // 10MB
+    showToast: true,
+    failMessage: '选择文件失败'
+};
+/**
+ * 验证文件大小和类型
+ * @param filePath 文件路径
+ * @param config 配置
+ * @returns 验证结果
+ */
+function validateFile(filePath, config) {
+    if (!filePath) {
+        return { valid: false, message: '文件路径不能为空' };
+    }
+    // 验证文件类型
+    if (config.allowedTypes && config.allowedTypes.length > 0) {
+        const fileExtension = filePath.split('.').pop()?.toLowerCase();
+        if (!fileExtension || !config.allowedTypes.includes(fileExtension)) {
+            return {
+                valid: false,
+                message: `不支持的文件类型，仅支持：${config.allowedTypes.join(', ')}`
+            };
+        }
+    }
+    return { valid: true };
+}
+/**
+ * 验证文件大小
+ * @param fileSize 文件大小(字节)
+ * @param maxSize 最大大小(MB)
+ * @returns 验证结果
+ */
+function validateFileSize(fileSize, maxSize) {
+    if (!maxSize)
+        return { valid: true };
+    const maxSizeBytes = maxSize * 1024 * 1024;
+    if (fileSize > maxSizeBytes) {
+        return {
+            valid: false,
+            message: `文件大小不能超过 ${maxSize}MB`
+        };
+    }
+    return { valid: true };
+}
+/**
+ * 检查平台是否支持指定的文件选择类型
+ */
+const isPlatformSupported = (type) => {
+    // #ifdef MP-WEIXIN
+    if (type === 'messagefile') {
+        return typeof uni.chooseMessageFile === 'function';
+    }
+    // #endif
+    if (type === 'local') {
+        // #ifdef H5
+        return true; // H5支持本地文件选择
+        // #endif
+    }
+    // image类型所有平台都支持
+    if (type === 'image') {
+        return true;
+    }
+    return false;
+};
+/**
+ * 选择文件
+ * @param config 选择配置
+ * @returns Promise<ChooseFileResult> 选择结果
+ */
+// #ifdef H5
+/**
+ * 创建H5文件选择的input元素, 并处理文件选择回调
+ * @param {ChooseFileConfig} config - 文件选择的配置
+ * @param {(res: ChooseFileResult) => void} resolve - Promise的resolve函数
+ * @private
+ */
+function _createH5FileInput(config, resolve) {
+    const input = document.createElement('input');
+    input.type = 'file';
+    input.multiple = config.count > 1;
+    if (config.type === 'image') {
+        input.accept = 'image/*';
+    }
+    else if (config.extension.length > 0) {
+        input.accept = config.extension.map(ext => (ext.startsWith('.') ? ext : `.${ext}`)).join(',');
+    }
+    input.onchange = (event) => {
+        const files = event.target.files;
+        if (files && files.length > 0) {
+            const tempFiles = Array.from(files).map(file => {
+                /**
+                 * @description 创建一个临时的对象URL。
+                 * 注意：这个URL在不再需要时，建议调用 URL.revokeObjectURL() 来释放内存，以避免内存泄漏。
+                 */
+                const path = URL.createObjectURL(file);
+                return {
+                    path,
+                    size: file.size,
+                    name: file.name,
+                    type: file.type,
+                    file // H5 only
+                };
+            });
+            const normalizedTempFiles = tempFiles.map(file => ({
+                path: file.path,
+                size: file.size,
+            }));
+            resolve({
+                success: true,
+                tempFilePaths: tempFiles.map(f => f.path),
+                tempFiles: normalizedTempFiles,
+                type: config.type
+            });
+        }
+        else {
+            // 用户取消了文件选择
+            resolve({
+                success: false,
+                message: '用户取消选择',
+                type: config.type
+            });
+        }
+        // 从DOM中移除input元素以进行清理
+        document.body.removeChild(input);
+    };
+    // 触发文件选择对话框
+    input.style.display = 'none';
+    document.body.appendChild(input);
+    input.click();
+}
+// #endif
+async function chooseFile(config = {}) {
+    const monitor = PerformanceMonitor.getInstance();
+    monitor.start('chooseFile', 'upload', { count: config.count, type: config.type });
+    const finalConfig = { ...DEFAULT_CHOOSE_CONFIG, ...config };
+    let actualType = finalConfig.type;
+    // 检查平台支持，不支持则降级到image
+    if (!isPlatformSupported(actualType)) {
+        actualType = 'image';
+        console.warn(`当前平台不支持${finalConfig.type}类型，已降级为image类型`);
+    }
+    const result = await safeAsync(() => new Promise((resolve) => {
+        const failCallback = (err) => {
+            const message = err.errMsg || finalConfig.failMessage;
+            if (finalConfig.showToast) {
+                useToast(message, false, 'error');
+            }
+            resolve({ success: false, message, type: actualType });
+        };
+        // #ifdef H5
+        if (actualType === 'image' || actualType === 'local') {
+            _createH5FileInput(finalConfig, resolve);
+            return;
+        }
+        // #endif
+        // #ifdef MP-WEIXIN
+        if (actualType === 'messagefile') {
+            uni.chooseMessageFile({
+                count: finalConfig.count,
+                type: 'all',
+                success: (res) => {
+                    // chooseMessageFile 返回的 tempFiles 结构是标准的，直接使用
+                    resolve({
+                        success: true,
+                        tempFilePaths: res.tempFiles.map(f => f.path),
+                        tempFiles: res.tempFiles,
+                        type: 'messagefile'
+                    });
+                },
+                fail: failCallback
+            });
+        }
+        else 
+        // #endif
+        if (actualType === 'image') {
+            // #ifndef H5
+            uni.chooseImage({
+                count: finalConfig.count,
+                sizeType: finalConfig.sizeType,
+                sourceType: finalConfig.sourceType,
+                success: (res) => {
+                    const tempFilePaths = Array.isArray(res.tempFilePaths) ? res.tempFilePaths : [res.tempFilePaths];
+                    const tempFilesArr = Array.isArray(res.tempFiles) ? res.tempFiles : [res.tempFiles];
+                    // 规范化 tempFiles
+                    const tempFiles = tempFilesArr.map((file, index) => ({
+                        path: tempFilePaths[index], // 确保 path 存在
+                        size: file.size,
+                    }));
+                    resolve({
+                        success: true,
+                        tempFilePaths,
+                        tempFiles,
+                        type: 'image'
+                    });
+                },
+                fail: failCallback
+            });
+            // #endif
+        }
+        else if (actualType === 'local') {
+            // #ifndef H5
+            if (typeof uni.chooseFile === 'function') {
+                uni.chooseFile({
+                    count: finalConfig.count,
+                    extension: finalConfig.extension,
+                    success: (res) => {
+                        const tempFilePaths = Array.isArray(res.tempFilePaths) ? res.tempFilePaths : [res.tempFilePaths];
+                        const tempFilesArr = Array.isArray(res.tempFiles) ? res.tempFiles : [res.tempFiles];
+                        // 规范化 tempFiles
+                        const tempFiles = tempFilesArr.map((file, index) => ({
+                            path: tempFilePaths[index],
+                            size: file.size,
+                        }));
+                        resolve({
+                            success: true,
+                            tempFilePaths,
+                            tempFiles,
+                            type: 'local'
+                        });
+                    },
+                    fail: failCallback
+                });
+            }
+            else {
+                resolve({
+                    success: false,
+                    message: '当前平台不支持选择本地文件',
+                    type: actualType
+                });
+            }
+            // #endif
+        }
+    }).then((res) => {
+        // 仅当成功时验证文件大小
+        if (!res.success || !res.tempFiles || !finalConfig.maxSize) {
+            return res;
+        }
+        const invalidFiles = res.tempFiles.filter((file) => {
+            const sizeValidation = validateFileSize(file.size, finalConfig.maxSize);
+            return !sizeValidation.valid;
+        });
+        if (invalidFiles.length > 0) {
+            const message = `部分文件大小超过 ${finalConfig.maxSize}MB 限制`;
+            if (finalConfig.showToast) {
+                useToast(message, false, 'error');
+            }
+            // 保留已选择的文件，但标记为失败
+            return {
+                ...res,
+                success: false,
+                message,
+            };
+        }
+        return res;
+    }), 'upload', 'CHOOSE_FILE_ERROR');
+    monitor.end('chooseFile');
+    return result || { success: false, message: '选择文件失败', type: actualType };
+}
+/**
+ * 选择图片（向后兼容）
+ * @param config 选择配置
+ * @returns Promise<ChooseImageResult> 选择结果
+ */
+async function chooseImage(config = {}) {
+    const result = await chooseFile({ ...config, type: 'image' });
+    return {
+        success: result.success,
+        tempFilePaths: result.tempFilePaths,
+        tempFiles: result.tempFiles,
+        message: result.message
+    };
+}
+/**
+ * 上传文件
+ * @param filePath 文件路径
+ * @param config 上传配置
+ * @param onProgress 进度回调
+ * @returns Promise<UploadResult> 上传结果
+ */
+async function uploadFile(filePath, config, onProgress) {
+    const monitor = PerformanceMonitor.getInstance();
+    monitor.start('uploadFile', 'upload', { filePath });
+    const finalConfig = { ...DEFAULT_UPLOAD_CONFIG, ...config };
+    // 验证必要参数
+    if (!finalConfig.url) {
+        const message = '上传地址不能为空';
+        if (finalConfig.showToast) {
+            useToast(message, false, 'error');
+        }
+        monitor.end('uploadFile');
+        return { success: false, message };
+    }
+    // 验证文件
+    const fileValidation = validateFile(filePath, finalConfig);
+    if (!fileValidation.valid) {
+        if (finalConfig.showToast) {
+            useToast(fileValidation.message, false, 'error');
+        }
+        monitor.end('uploadFile');
+        return { success: false, message: fileValidation.message };
+    }
+    const result = await safeAsync(() => new Promise((resolve) => {
+        const uploadTask = uni.uploadFile({
+            url: finalConfig.url,
+            filePath,
+            name: finalConfig.name,
+            formData: finalConfig.formData,
+            header: finalConfig.header,
+            timeout: finalConfig.timeout,
+            success: (res) => {
+                let data;
+                try {
+                    data = JSON.parse(res.data);
+                }
+                catch {
+                    data = res.data;
+                }
+                if (res.statusCode === 200) {
+                    if (finalConfig.showToast) {
+                        useToast(finalConfig.successMessage, false, 'success');
+                    }
+                    resolve({
+                        success: true,
+                        data,
+                        tempFilePath: filePath,
+                        statusCode: res.statusCode
+                    });
+                }
+                else {
+                    const message = `上传失败，状态码：${res.statusCode}`;
+                    if (finalConfig.showToast) {
+                        useToast(message, false, 'error');
+                    }
+                    resolve({
+                        success: false,
+                        message,
+                        statusCode: res.statusCode
+                    });
+                }
+            },
+            fail: (err) => {
+                const message = err.errMsg || finalConfig.failMessage;
+                if (finalConfig.showToast) {
+                    useToast(message, false, 'error');
+                }
+                resolve({
+                    success: false,
+                    message,
+                    tempFilePath: filePath
+                });
+            }
+        });
+        // 监听上传进度
+        if (onProgress && uploadTask) {
+            uploadTask.onProgressUpdate((res) => {
+                onProgress({
+                    progress: res.progress,
+                    totalBytesSent: res.totalBytesSent,
+                    totalBytesExpectedToSend: res.totalBytesExpectedToSend
+                });
+            });
+        }
+    }), 'upload', 'UPLOAD_FILE_ERROR');
+    monitor.end('uploadFile');
+    return result || { success: false, message: '上传文件失败' };
+}
+/**
+ * 选择并上传文件（一体化功能）
+ * @param config 上传配置
+ * @param chooseConfig 选择文件配置
+ * @param onProgress 进度回调
+ * @returns Promise<UploadResult[]> 上传结果数组
+ */
+async function chooseAndUploadFile(config, chooseConfig = {}, onProgress) {
+    const monitor = PerformanceMonitor.getInstance();
+    monitor.start('chooseAndUploadFile', 'upload');
+    // 选择文件
+    const chooseResult = await chooseFile(chooseConfig);
+    if (!chooseResult.success || !chooseResult.tempFilePaths) {
+        monitor.end('chooseAndUploadFile');
+        return [{ success: false, message: chooseResult.message || '选择文件失败' }];
+    }
+    // 批量上传
+    const uploadPromises = chooseResult.tempFilePaths.map(filePath => uploadFile(filePath, config, onProgress));
+    const results = await Promise.all(uploadPromises);
+    monitor.end('chooseAndUploadFile');
+    return results;
+}
+/**
+ * 选择并上传图片（向后兼容）
+ * @param config 上传配置
+ * @param chooseConfig 选择图片配置
+ * @param onProgress 进度回调
+ * @returns Promise<UploadResult[]> 上传结果数组
+ */
+async function chooseAndUploadImage(config, chooseConfig = {}, onProgress) {
+    return chooseAndUploadFile(config, { ...chooseConfig, type: 'image' }, onProgress);
+}
+/**
+ * 检查是否支持文件上传
+ * @returns boolean 是否支持
+ */
+function isUploadSupported() {
+    return typeof uni !== 'undefined' &&
+        typeof uni.chooseImage === 'function' &&
+        typeof uni.uploadFile === 'function';
+}
+/**
+ * 获取文件信息
+ * @param filePath 文件路径
+ * @returns Promise<{size: number, type?: string}> 文件信息
+ */
+async function getFileInfo(filePath) {
+    return await safeAsync(() => new Promise((resolve, reject) => {
+        uni.getFileInfo({
+            filePath,
+            digestAlgorithm: 'md5', // 明确指定算法，虽然默认是md5
+            success: (res) => {
+                const result = res;
+                resolve({
+                    size: result.size,
+                    digest: result.digest
+                });
+            },
+            fail: reject
+        });
+    }), 'upload', 'GET_FILE_INFO_ERROR');
+}
+
+// 核心功能
+
+// 版本信息
+const VERSION = '1.0.8';
+
+// 初始化函数
+async function initUniAppTools(config = {}) {
+  const {
+    enablePerformanceMonitor = false,
+    enableErrorHandler = true,
+    logLevel = 'warn'
+  } = config;
+
+  if (enableErrorHandler) {
+    const { ErrorHandler } = await Promise.resolve().then(function () { return errorHandler; });
+    const errorHandler$1 = ErrorHandler.getInstance();
+
+    // 设置全局错误监听
+    if (enablePerformanceMonitor) {
+      errorHandler$1.onError((error) => {
+        console.log(`[UniAppTools] ${error.module} - ${error.code}: ${error.message}`);
+      });
+    }
+  }
+
+  if (enablePerformanceMonitor) {
+    const { PerformanceMonitor } = await Promise.resolve().then(function () { return performance$1; });
+    const monitor = PerformanceMonitor.getInstance();
+
+    // 定期输出性能报告
+    setInterval(() => {
+      const report = monitor.getReport();
+      if (report.slowest.length > 0) {
+        console.log('[UniAppTools] 性能报告:', report);
+      }
+    }, 60000); // 每分钟输出一次
+  }
+
+  console.log(`[UniAppTools] v${VERSION} 初始化完成`);
 }
 
-export { ErrorHandler, PerformanceMonitor, UniAppToolsError, VERSION, batchGetStorage, batchSetStorage, cleanExpiredStorage, clearClipboard, clearNavigationQueue, clearStorageSync, copyText, debounce, deepClone, deepMerge, getCurrentEnv, getCurrentPageInfo, getMenuButtonBoundingClientRect, getNavHeight, getPageStack, getPlatform, getStatusBarHeight, getStorage, getStorageInfo, getStorageSync, getTopNavBarHeight, initUniAppTools, isClipboardSupported, measurePerformance, mergeObjects, navigateTo, onCheckForUpdate, reLaunch, readClipboard, redirectTo, safeAsync, safeNavigateTo, safeSync, setStorage, setStorageSync, switchTab, throttle, useBack, useBackDebounced, useBackOrHome, useDeepCopyByObj, useToast, useWindowInfo };
+export { ErrorHandler, PerformanceMonitor, UniAppToolsError, VERSION, batchGetStorage, batchSetStorage, chooseAndUploadFile, chooseAndUploadImage, chooseFile, chooseImage, cleanExpiredStorage, clearClipboard, clearNavigationQueue, clearStorageSync, copyText, debounce, deepClone, deepMerge, getCurrentEnv, getCurrentPageInfo, getFileInfo, getMenuButtonBoundingClientRect, getNavHeight, getPageStack, getPlatform, getStatusBarHeight, getStorage, getStorageInfo, getStorageSync, getTopNavBarHeight, initUniAppTools, isClipboardSupported, isUploadSupported, measurePerformance, mergeObjects, navigateTo, onCheckForUpdate, reLaunch, readClipboard, redirectTo, safeAsync, safeNavigateTo, safeSync, setPageIcon, setPageTitle, setStorage, setStorageSync, switchTab, throttle, uploadFile, useBack, useBackDebounced, useBackOrHome, useDeepCopyByObj, useToast, useWindowInfo };
 //# sourceMappingURL=my-uniapp-tools.esm.js.map