SuperAPI AI 工具集

cloud-storage-web

前端与建站

查看项目

更新于 10-16 07:13

技能介绍

用途:面向需要在 Web 应用中通过 @cloudbase/js-sdk 操作 CloudBase 云存储的开发者,覆盖浏览器端文件上传、下载、临时下载链接生成与文件删除。不适用于小程序文件操作、后端 Node SDK 操作和数据库操作。

主要能力:uploadFile 上传文件(支持 method 为 post 或 put,默认 put,可用 onUploadProgress 回调显示进度);getTempFileURL 为私有文件生成带 maxAge 有效期的临时下载链接,支持批量;deleteFile 批量删除文件;downloadFile 将文件下载到浏览器。

使用方式:先用 cloudbase.init({ env: "your-env-id" }) 同步初始化并保持单一共享实例,不要用动态导入懒加载。上传示例:await app.uploadFile({ cloudPath: "folder/filename.jpg", filePath: fileInput.files[0] }),返回 fileID。临时链接需传入 fileList 数组,每项含 fileID 与 maxAge(秒),响应中检查 code 是否为 SUCCESS。删除传入 fileID 字符串数组。

路径规则:cloudPath 仅允许 [0-9a-zA-Z]、/、!、-、_、.、空格、* 及中文字符,用 / 表示目录层级。

限制与注意事项:需在 CloudBase 控制台“环境 → 安全来源 → 安全域名”添加前端域名(如 https://your-app.com、http://localhost:3000),否则会出现 CORS 错误,必要时移除后重新添加。所有操作应做错误处理,常见错误码有 INVALID_PARAM、PERMISSION_DENIED、RESOURCE_NOT_FOUND、SYS_ERR。临时链接应设置合理有效期并注意缓存过期。文件大小上限、并发上传限制、收费与价格等资料暂未提供。