本文详细介绍 Node.js 中 fs.stat 方法的用法。该方法用于获取指定路径的文件信息,返回包含权限、大小、时间戳等详细数据的 Stats 对象。文章涵盖语法定义、参数说明、完整的代码示例以及底层源码逻辑,帮助开发者正确使用文件状态检测功能。
Node.js fs.stat 方法详解:语法、参数与返回值解析
方法说明:
fs.stat 方法用于获取指定路径的文件或目录的详细信息。
语法:
代码如下:
fs.stat(path, [callback(err, stats)])
由于该方法属于 fs 模块,使用前需要通过 require('fs') 引入模块。
接收参数:
path:文件路径。
callback:回调函数,接收两个参数。第一个参数为异常对象 err(若发生错误),第二个参数为文件信息对象 stats。
stats 对象包含以下信息:(注:以下数据为案例中读取的具体文件信息,非默认值)
代码如下:
{
dev : 0 ,
mode : 33206 ,
nlink : 1 ,
uid : 0 ,
gid : 0 ,
rdev : 0 ,
ino : 0 ,
size : 378(字节) ,
atime : Tue Jun 10 2014 13:57:13 GMT +0800 <中国标准时间> ,
mtime : Tue Jun 13 2014 09:48:31 GMT +0800 <中国标准时间> ,
ctime : Tue Jun 10 2014 13:57:13 GMT +0800 <中国标准时间>
}
例子:
代码如下:
var fs = require('fs');
fs.stat('content.txt', function(err, stats){
if(err){
throw err;
}else{
console.log(stats);
}
})
源码:
代码如下:
fs.stat = function(path, callback) {
callback = makeCallback(callback);
if (!nullCheck(path, callback)) return;
binding.stat(pathModule._makeLong(path), callback);
};