NodeJs简明教程(4)

2019年7月20日 · 138 字 · 1 分钟

本文是NodeJs简明教程的第四篇，将介绍NodeJs文件系统模块相关的基本操作。

fs 模块提供了一个 API，用于以模仿标准 POSIX 函数的方式与文件系统进行交互。

读取文件

文件系统的大部分函数都存在 异步调用 和 同步调用 两种形式。

异步

异步模式下，回调函数的第一个参数总为 Error 对象，且函数一般无返回值。

如果为null，则本次调用未出错
如果不为null，证明本次调用出错

新建 index.js 文件：

const fs = require('fs');

fs.readFile('./index.js', { encoding: 'utf8' }, (err, data) => {
    if (err) {
        console.error('读取文件失败', err);
        return;
    }
    console.log(data);
})

readFile的第二个参数如果不指定编码，回调函数取到的data对象是Buffer，需要手动转字符串。读取文本文件可以指定编码，但是读取二进制文件(比如读取图片文件)就不能指定编码了，有一些字符时不可见字符，编码之后会出问题。

在当前目录执行 node index.js

输出如下：

const fs = require('fs');

fs.readFile('./index.js', (err, data) => {
    if (err) {
        console.error('读取文件失败', err);
        return;
    }
    console.log(data);
})

同步模式

同步模式下，返回值为调用函数的结果，如果调用失败，将抛出Error对象：

const fs = require('fs');

try {
    const data = fs.readFileSync('./index.js', { encoding: 'utf8' });
    console.log(data);
} catch (e) {
    console.log('读取失败', e)
}

输出数据和同步模式一致。

可以看到同步模式和异步模式下处理错误的方式是不同的。

各位读者在生产中尽量不要使用同步函数，否则会阻塞事件循环。当然，有一种情况例外，需要同步读取配置文件然后才启动服务器的这种情况是可以的。

写入文件

新建index.js，代码如下：

const fs = require('fs');

const data = 'Hello World';

fs.writeFile('./a.txt', data, (error) => {
    if (error) {
        console.error('保存失败', error);
        return;
    }
    console.log('保存成功');
})

执行node index.js
输出保存成功，同时当前目录会多出内容为Hello World的文本文件。

常用API

fs.copyFile(src,dest[,flags],callback) 复制文件
fs.stat(path[,options],callback) 读取文件状态
fs.unlink(path,callback) 删除文件
fs.rename(oldPath,newPath,callback) 重命名文件
fs.mkdir(path[,options],callback) 新建目录
fs.rmdir(path,callback) 删除目录

结语

文件系统的学习暂时到此为止，用到的时候大家可以详细查看文件，文件系统的函数调用方式和本文的示例都是类似的，各位读者可以举一反三。

NodeJs简明教程(5) NodeJs简明教程(3)