↑

CloudBase Web 端云存储开发指南v1.0.0

cloudbase-references-cloud-storage-web3 KB

面向使用 @cloudbase/js-sdk 的 Web 项目,提供浏览器端文件上传、下载、临时链接生成与删除的完整代码方案。用户提及前端直传文件到 CloudBase 存储、处理上传进度、配置 CORS 或管理云文件时触发。

0 0 0 0 更新于 2026-10-28 18:24

免责声明:本站部分 Skill 来源于公开渠道,使用前请注意识别相关风险,内容版权归原作者所有,如 Skill 涉及版权问题,请在线反馈,核实后予以下架处理。

概述

本 Skill 聚焦浏览器环境下通过 @cloudbase/js-sdk 操作 CloudBase 云存储的完整开发流程。覆盖文件上传(含进度监听)、批量生成带时效的临时下载链接、云文件删除及浏览器直下等核心操作,同时内置 CORS 域名配置指引、合法路径命名规则与常见错误码处理。输出可直接嵌入 Vue / React / 原生 HTML 项目的初始化代码、调用示例与参数说明,帮助前端开发者快速跑通云存储接入,避开跨域与权限类陷阱。

技能包含

  • SKILL.md(本文件):技能主说明,涵盖 SDK 初始化、uploadFile / getTempFileURL / deleteFile / downloadFile 四大方法的用法、参数表、最佳实践与安全建议

核心能力

  • SDK 初始化与实例管理:提供标准同步初始化模板,强调单实例复用,避免动态引入导致的上下文丢失
  • 浏览器文件上传:支持基础上传与带 onUploadProgress 进度的进阶上传,明确 cloudPath 合法字符与文件夹层级规则
  • 临时下载链接生成:通过 getTempFileURL 为私有文件批量创建时效 URL,可自定义 maxAge,返回结构含成功/失败状态码
  • 云文件删除与清理:支持单文件与批量删除,建议用于旧头像、临时文件等定期清理场景
  • CORS 与错误排查:给出控制台安全域名配置步骤,罗列 INVALID_PARAM、PERMISSION_DENIED 等常见错误及处理建议

应用场景

用户怎么说本技能做什么
"网页里怎么把用户选的图片传到 CloudBase"给出 uploadFile 完整代码,含 file input 取值、cloudPath 命名、进度回调与结果解析
"前端如何拿到云存储文件的临时下载地址"提供 getTempFileURL 调用示例,设置合理有效期,并演示如何遍历结果提取可用 URL
"上传时报 CORS 错误怎么解决"引导检查 CloudBase 控制台安全域名配置,给出添加、删除重加的排查步骤
"要批量删掉用户之前上传的旧头像"组装 deleteFile 的 fileList 数组,展示如何按返回码确认每条删除结果
"想在页面上显示上传进度条"补充 onUploadProgress 回调实现,计算百分比并建议绑定到 UI 状态更新