可选createdHost 可提供的创建时间,公开约定为 Unix epoch milliseconds。可独立省略;范围规则与
FileStat.modifiedAt 相同,也不保证早于或等于 modifiedAt。
固定为 'file',用于和 Host 的目录状态区分。
可选modifiedHost 可提供的最后修改时间,公开约定为 Unix epoch milliseconds。可独立省略;存在时只保证为
非负有限 number,允许小数和超过 Number.MAX_SAFE_INTEGER 的值,不保证可构造有效 Date。
本次快照中的文件大小,公开约定单位为 byte。必须是 0 到 Number.MAX_SAFE_INTEGER 的整数;
0 表示空文件。负数、小数、NaN、Infinity、unsafe integer 或数字字符串会使 stat() 以
FILE_IO_FAILED 拒绝。
FileHandle.stat 返回的文件元数据快照。
备注
Runtime 与 SDK 会把 Host 结果规范为这四个公开字段;Host 的额外字段不会进入结果。每次
stat()返回新对象,它不是缓存或 live view,也不冻结;调用方修改字段不会改变文件或后续快照。单位是公开合同而不是可从 number 结构证明的事实:
size按 byte 解释,时间字段按 Unix epoch milliseconds 解释。SDK 无法验证 Host 实际单位、时间来源、字段之间的顺序关系或快照 resolve 后是否仍 与磁盘一致。