Object 内置对象

对象 Stat

文件的基础信息对象

Stat 对象通过 fs.stat, File.stat, fs.readdir 查询,不可独立创建

继承关系

成员属性

name

String, 文件名称

1
readonly String Stat.name;

dev

Integer, 包含该文件的设备 ID

1
readonly Integer Stat.dev;

ino

Integer, 文件中的 Inode 数量

1
readonly Integer Stat.ino;

mode

Integer, 文件权限,Windows 不支持此属性

1
readonly Integer Stat.mode;

Integer, 与此文件相关联的硬链接数量

1
readonly Integer Stat.nlink;

uid

Integer, 文件拥有者的id

1
readonly Integer Stat.uid;

gid

Integer, 文件所属的组id

1
readonly Integer Stat.gid;

rdev

Integer, 对于特殊类型的文件, 包含该文件的设备 ID

1
readonly Integer Stat.rdev;

size

Number, 文件尺寸

1
readonly Number Stat.size;

blksize

Integer, 在 I/O 操作中文件系统区块大小

1
readonly Integer Stat.blksize;

blocks

Integer, 分配给该文件的区块数量

1
readonly Integer Stat.blocks;

mtime

Date, 文件最后修改时间

1
readonly Date Stat.mtime;

mtimeMs

Number, 文件最后修改时间(ms)

1
readonly Number Stat.mtimeMs;

atime

Date, 文件最后访问时间

1
readonly Date Stat.atime;

atimeMs

Number, 文件最后访问时间(ms)

1
readonly Number Stat.atimeMs;

ctime

Date, 文件创建时间

1
readonly Date Stat.ctime;

ctimeMs

Number, 文件创建时间(ms)

1
readonly Number Stat.ctimeMs;

birthtime

Date, 文件产生时间

1
readonly Date Stat.birthtime;

birthtimeMs

Number, 文件产生时间(ms)

1
readonly Number Stat.birthtimeMs;

成员函数

isWritable

查询文件是否有写入权限

1
Boolean Stat.isWritable();

返回结果:

  • Boolean, 为 true 则有写入权限

isReadable

查询文件是否有读权限

1
Boolean Stat.isReadable();

返回结果:

  • Boolean, 为 true 则有读权限

isExecutable

查询文件是否有执行权限

1
Boolean Stat.isExecutable();

返回结果:

  • Boolean, 为 true 则有执行权限

isHidden

查询文件是否隐藏

1
Boolean Stat.isHidden();

返回结果:

  • Boolean, 为 true 则隐藏

isBlockDevice

查询 Stat 是否描述了一个 block device

1
Boolean Stat.isBlockDevice();

返回结果:

  • Boolean, 为 true 表示描述了一个 block device

isCharacterDevice

查询 Stat 是否描述了一个 character device

1
Boolean Stat.isCharacterDevice();

返回结果:

  • Boolean, 为 true 表示描述了一个 character device

isDirectory

查询文件是否是目录

1
Boolean Stat.isDirectory();

返回结果:

  • Boolean, 为 true 则是目录

isFIFO

查询 Stat 是否描述了一个 FIFO 管道

1
Boolean Stat.isFIFO();

返回结果:

  • Boolean, 为 true 表示描述了一个 FIFO 管道

isFile

查询文件是否是文件

1
Boolean Stat.isFile();

返回结果:

  • Boolean, 为 true 则是文件

查询文件是否是符号链接

1
Boolean Stat.isSymbolicLink();

返回结果:

  • Boolean, 为 true 则是符号链接

isMemory

查询文件是否是内存文件

1
Boolean Stat.isMemory();

返回结果:

  • Boolean, 为 true 则是内存文件

isSocket

查询文件是否是 Socket

1
Boolean Stat.isSocket();

返回结果:

  • Boolean, 为 true 则是 Socket

toString

返回对象的字符串表示,一般返回 "[Native Object]",对象可以根据自己的特性重新实现

1
String Stat.toString();

返回结果:

  • String, 返回对象的字符串表示

toJSON

返回对象的 JSON 格式表示,一般返回对象定义的可读属性集合

1
Value Stat.toJSON(String key = "");

调用参数:

  • key: String, 未使用

返回结果:

  • Value, 返回包含可 JSON 序列化的值