参考—->

Node.js 内置的 fs 模块就是文件系模块,负责读写文件。 fs 同时提供了异步和同步的方法。

读文件:

异步读取文件:

读取文本文件:

  1. 'use strict';
  2. var fs = require('fs');
  3. fs.readFile('test.txt', 'utf-8', function (err, data) {
  4. if (err) {
  5. console.log(err);
  6. } else {
  7. console.log(data);
  8. }
  9. });

注意:

  • test.txt 文件必须在当前目录下,且文件编码为 utf-8
  • fs 读取路径最好为 绝对路径 ,不然会读取不到文件,例如使用 path 模块获取绝对路径。
  • 异步读取时,传入回调函数接收两个参数,当正常读取时,errnull ,data参数为读取到的字符串;当读取发生错误时, err 参数代表一个错误对象,dataundefined 。这也是 Node.js 标准的回调函数:第一个参数代表错误信息,第二个参数代表结果

读取二进制文件:

当读取二进制文件时,不传入文件编码时,回调函数的 data 参数将返回一个 Buffer 对象。在 Node 中 Buffer 对象就是一个包含零个或任意字节的数组(不同于 Array)

  1. 'use strict';
  2. var fs = require('fs');
  3. fs.readFile('test.png', function (err, data) {
  4. if (err) {
  5. console.log(err);
  6. } else {
  7. console.log(data);
  8. console.log(data.length + ' bytes');
  9. }
  10. });

BufferString

  1. // Buffer -> String
  2. var text = data.toString('utf-8');
  3. console.log(text);

StringBuffer

  1. // String -> Buffer
  2. var buf = Buffer.from(text, 'utf-8');
  3. console.log(buf);

同步读取文件:

同步读取函数多了一个 Sync 的猴嘴,并且不接受回调函数

  1. 'use strict';
  2. var fs = require('fs');
  3. var data = fs.readFileSync('test.txt', 'utf-8');
  4. console.log(data);

同步读取文件时错误捕获:

  1. try {
  2. var data = fs.readFileSync('test.txt', 'utf-8');
  3. console.log(data);
  4. } catch (err) {
  5. // 出错了
  6. }

写文件:

writeFile() 的参数依次为文件名、数据和回调函数。 如果传入的数据是 String,默认按 UTF-8 编码写入文本文件; 如果传入的是 Buffer ,则写入的是二进制文件,回调函数由于只关心成功与否,因此只需要一个 err 参数。

异步写入文件demo:

  1. 'use strict';
  2. var fs = require('fs');
  3. var data = 'Hello, Node.js';
  4. fs.writeFile('test.txt', data, function (err) {
  5. if (err) {
  6. console.log(err);
  7. } else {
  8. console.log('写入完毕');
  9. }
  10. });

同步写入文件demo:

  1. 'use strict';
  2. var fs = require('fs');
  3. var data = 'Hello, Node.js';
  4. fs.writeFileSync('test.txt', data);

同步方法捕获错误方法,还是使用 try catch。
**

获取文件信息- stat:

如果我们要获取文件大小,创建时间等信息,可以使用fs.stat(),它返回一个Stat对象,能告诉我们文件或目录的详细信息:

异步方法:

  1. 'use strict';
  2. var fs = require('fs');
  3. fs.stat('sample.txt', function (err, stat) {
  4. if (err) {
  5. console.log(err);
  6. } else {
  7. // 是否是文件:
  8. console.log('isFile: ' + stat.isFile());
  9. // 是否是目录:
  10. console.log('isDirectory: ' + stat.isDirectory());
  11. if (stat.isFile()) {
  12. // 文件大小:
  13. console.log('size: ' + stat.size);
  14. // 创建时间, Date对象:
  15. console.log('birth time: ' + stat.birthtime);
  16. // 修改时间, Date对象:
  17. console.log('modified time: ' + stat.mtime);
  18. }
  19. }
  20. });

返回结果如下:

  1. isFile: true
  2. isDirectory: false
  3. size: 181
  4. birth time: Fri Dec 11 2015 09:43:41 GMT+0800 (CST)
  5. modified time: Fri Dec 11 2015 12:09:00 GMT+0800 (CST)

stat()也有一个对应的同步函数statSync():

异步还是同步:

  • 由于Node环境执行的JavaScript代码是服务器端代码,所以,绝大部分需要在服务器运行期反复执行业务逻辑的代码,必须使用异步代码**,**否则,同步代码在执行时期,服务器将停止响应,因为JavaScript只有一个执行线程。
  • 服务器启动时如果需要读取配置文件,或者结束时需要写入到状态文件时,可以使用同步代码,因为这些代码只在启动和结束时执行一次,不影响服务器正常运行时的异步执行。