类型别名 DownloadOptions

类型声明

• { overwrite?: never; suggestedName?: never; to: FileHandle }

  • 可选overwrite?: never

    File target 固定原子替换，不接受该字段；即使显式传入 boolean 也返回 INVALID_PARAMS。

  • 可选suggestedName?: never

    File target 不接受该字段；即使显式传入字符串也返回 INVALID_PARAMS。

  • to: FileHandle

    当前 SDK session 创建的 readwrite File 代理；目标文件必须已存在。成功后返回同一代理。

• { overwrite?: boolean; suggestedName?: string; to: DirectoryHandle }

  • 可选overwrite?: boolean

    是否允许原子创建或替换目录内的同名文件，默认 false；false 时采用独占创建。

  • 可选suggestedName?: string

    建议的安全子文件 basename。服务端安全 Content-Disposition filename* / filename 优先于该值；之后依次回退 URL basename 与 download.bin。不能包含路径分隔符、点段、 控制字符、Windows 保留名或尾随点/空格，最长 255 个 Unicode 字符。

  • to: DirectoryHandle

    当前 SDK session 创建的、已存在的 readwrite Directory 代理；成功后返回其直接子 File 代理。