Node.js内置基础模块fs, Node.js 提供了基础的文件操作,并同时提供文件的同步和异步操作,如:
.....................
All the methods have asynchronous and synchronous forms.
同样,如果想使用Node.js该内置模块,需要在使用之前导入该模块,如:
To use this module do require('fs')
//这里,Node.js有规范,如果require
参数为非路径字符,则会当做内置模块导入。所以,使用Node内置模块规范语句为:
var modu = require('fs') ;
//非内置模块为:
var nModu = require('./server') ; //这里的路径可以是相对路径,也可以是绝对路径
大概瞄了一眼api,基本上提供的每个同步操作函数都是在异步操作函数名字之后追加Sync
,也就是说Sync
结尾的函数基本可以认定为同步操作,需要注意。
fs模块异步操作需要提供一个回调函数作为最后的参数传递,该回调函数接受两个参数:
- 第一个参数为操作状态标示,如果操作成功返回null 或undefined ,否则,该参数为一个error对象。
- 第二个参数为返回的数据(data),如果失败,则为undefined.
例如 fs.readFile:
//这是官网api 栗子
fs.readFile('/etc/passwd', (err, data) => {
if (err) throw err; console.log(data);
});
同步操作,不需要提供回调函数,只需要使用一个变量接受结果就可以,不过如果有异常需要使用try..... catch....
, 栗子如下:
var fdata = fs.readFileSync('/etc/passwd','utf-8') ;
console.log('fdata') ;
//异常捕获
try{
var fdata = fs.readFileSync('/etc/passwd','utf-8') ;
console.log('fdata') ;
}catch(e) {
console.log(' exception: ',e) ;
}
fs模块提供了细致的api,包含查看文件当前属性信息(fs.stat(path, callback)),通过它可以看到指定文件的创建时间,文件大小等信息,以及转换到操作流上更方便文件的操作fs.createReadStream(path[, options])等等,使用的时候参考api就可以很快上手,详细的文件操作api在这里:
File System: https://nodejs.org/api/fs.html
这里有几个大类:
内部均提供了文件的常用操作,需要注意的是,它们内部提供函数和事件的版本。
var fs = require('fs') ;
// fs.access('./ht.html', fs.constants.R_OK | fs.constants.W_OK, (err) => {
// console.log(err ? 'no access!' : 'can read/write');
// });
//
var rs = fs.createReadStream('./ht.html', 'utf-8');
//这里使用了`data` 事件,用来监听数据读取事件,如果数据量大,这个回调函数会被调用多次,具体上限是多少,我没有测试过。
rs.on('data', function (data) {
console.log('data:', data) ;
});
rs.on('end', function () {
console.log('end');
});
rs.on('error', function (err) {
console.log('error: ' , err);
});
保存上面代码到一个js文件,运行 node node.js
该文件内容就输出到命令行窗口上了。
[palm@arch]: ~/Desktop/js>$ node node.js
data: <html>
<head>js test page</head>
js test page!
<body>
</body>
<script type="text/javascript" src= 'jquery-1.11.1.js'></script>
<script type="text/javascript" src='extend.js'></script>
</html>
end
fs模块就学到这里,后面如果用到了,再来查询文档,如果上面有错误,请路过的朋友指出,谢谢了~