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

    接口 FileStat

    FileHandle.stat 返回的文件元数据快照。

    Runtime 与 SDK 会把 Host 结果规范为这四个公开字段;Host 的额外字段不会进入结果。每次 stat() 返回新对象,它不是缓存或 live view,也不冻结;调用方修改字段不会改变文件或后续快照。

    单位是公开合同而不是可从 number 结构证明的事实:size 按 byte 解释,时间字段按 Unix epoch milliseconds 解释。SDK 无法验证 Host 实际单位、时间来源、字段之间的顺序关系或快照 resolve 后是否仍 与磁盘一致。

    interface FileStat {
        createdAt?: number;
        kind: "file";
        modifiedAt?: number;
        size: number;
    }
    索引

    属性

    createdAt?: number

    Host 可提供的创建时间,公开约定为 Unix epoch milliseconds。可独立省略;范围规则与 FileStat.modifiedAt 相同,也不保证早于或等于 modifiedAt。

    kind: "file"

    固定为 'file',用于和 Host 的目录状态区分。

    modifiedAt?: number

    Host 可提供的最后修改时间,公开约定为 Unix epoch milliseconds。可独立省略;存在时只保证为 非负有限 number,允许小数和超过 Number.MAX_SAFE_INTEGER 的值,不保证可构造有效 Date。

    size: number

    本次快照中的文件大小,公开约定单位为 byte。必须是 0 到 Number.MAX_SAFE_INTEGER 的整数; 0 表示空文件。负数、小数、NaN、Infinity、unsafe integer 或数字字符串会使 stat() 以 FILE_IO_FAILED 拒绝。