@heybox/hb-sdk API Reference - v0.9.5
    正在准备搜索索引...

    接口 PickFilesOptions

    用户选择文件时的筛选和授权选项。

    省略 options 或传 {} 等同于 { mode: 'read', multiple: false },且不设置扩展名筛选。 Host 返回的整批文件会先校验数量、结构、名称、mode 和 session 配额,再一次性注册;任一项 失败都不会保留部分授权。

    interface PickFilesOptions {
        accept?: string[];
        mode?: FileMode;
        multiple?: boolean;
    }
    索引

    属性

    accept?: string[]

    传给系统选择器的文件扩展名筛选,例如 ['.json', '.txt', '.tar.gz']。

    必须是数组;每项匹配 /^\.[a-z0-9][a-z0-9._-]*$/i,即以 . 和 ASCII 字母/数字开头, 后续只允许 ASCII 字母、数字、点、下划线或连字符。空串、缺少前导点、路径、通配符、空格 或 MIME type 会以 INVALID_PARAMS 拒绝。重复项在进入 Host 前按首次出现顺序去重。 该字段只影响系统选择器筛选,不读取或转换文件内容;不需要筛选时应省略。

    mode?: FileMode

    请求的访问模式,默认 read。Host 即使授予更高权限也会被 Runtime 收窄为 read;请求 readwrite 但平台/选择器只能授予只读时返回 FILE_ACCESS_DENIED,不会静默降级。外部 File 即使为 readwrite 也不能调用 remove()。

    multiple?: boolean

    是否允许选择多个文件,默认 false。false 时成功结果恰好一个;只有显式为 true 时 才接受多个结果,实际数量由系统选择器决定,但成功结果仍至少一个。