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

    接口 CreateOptions

    两个字段都只接受 boolean,省略 options、传 {} 或省略单个字段时均使用 false。这些选项只影响 当前代理所指向的目标:不会把外部 File 授权扩张到父目录或兄弟项,也不会绕过当前代理的 mode、 Runtime session、Mini-program identity、filesystem 权限或 Host capability 检查。

    interface CreateOptions {
        exclusive?: boolean;
        recursive?: boolean;
    }
    索引

    属性

    exclusive?: boolean

    目标已存在时是否失败,默认 false。

    false 是不破坏内容的 ensure-exists:同类型目标已存在时成功,不清空已有文件。true 要求本次 新建目标,文件或目录已存在时分别返回 FILE_ALREADY_EXISTS / DIRECTORY_ALREADY_EXISTS。 该字段只约束最终目标,不要求 recursive 创建的父目录也必须全新。

    recursive?: boolean

    是否同时创建目标路径中缺失的父目录,默认 false。

    false 时任一父目录缺失会失败;true 时 Host 在当前 sandbox 或已授权目录范围内创建缺失父目录。 它不改变目标已存在时的处理方式,也不能跨出当前逻辑 root。