Skip to content

sanitizeOssObjectName ​

净化 OSS 对象名或路径段,用于 COS key、IM 附件路径、work 直传文件名等。

函数签名 ​

typescript
function sanitizeOssObjectName(raw: string, fallback?: string): string

参数 ​

参数名类型必填说明
rawstring是原始名称或路径段
fallbackstring否净化后为空时使用,默认 file

返回值 ​

类型说明
string仅含 [a-zA-Z0-9._-],最长 200 字符

工作原理 ​

  1. 将连续非法字符(非字母数字与 ._-)折叠为单个 _。
  2. 截断至 200 字符;空串回退 fallback。

使用场景 ​

  • 朝夕工作 work/{userId}/…(见 OSS / work 模块)
  • IM 会话头像 im-conv-avatars/{conversationId}.png
  • IM 附件 conversations/{id}/{attachmentId}/{fileName}