fs文件系统模块,这是一个非常重要的模块,对文件的操作都基于它。该模块的所有方法都有同步和异步两种方式,下面便介绍一下该模块的使用。
1、检测当前进程对文件的权限
使用fs.access(path[, mode], callback)方法检查权限,mode参数是一个整数,有以下常量值:
fs.constants.F_OK path对调用进程是可见的,既存在
fs.constants.R_OK path是可读的
fs.constants.W_OK path是可写的
fs.constants.X_OK path是可执行的
使用如下所示:
fs.access('./note.txt',fs.constants.F_OK,(err)=>{ console.log(err?'文件不存在':'文件已经存在'); });
同步版本,如果发生异常,则直接抛出异常,否则什么也不做。同步版本可以利用try..catch来做,适用所有方法,如下所示:
try{ fs.accessSync('./note.txt',fs.constants.F_OK); }catch(ex){ console.log('文件不存在'); }
2、获取文件状态
使用fs.stat(path, callback),fs.statSync(path)方法来获取指定path的状性,callback有(err, stats)两个参数,stats是fs.stats对象,具有以下属性:
{ dev: 638212, mode: 33206, nlink: 1, uid: 0, gid: 0, rdev: 0, blksize: undefined, ino: 105553116266564850, size: 1094, blocks: undefined, atime: 2016-11-22T08:45:43.505Z, mtime: 2016-11-22T09:33:13.535Z, ctime: 2016-11-22T09:33:13.535Z, birthtime: 2016-11-22T08:45:43.505Z }
还有以下方法:
stats.isFile() stats.isDirectory() stats.isBlockDevice() stats.isCharacterDevice() stats.isSymbolicLink() (only valid with fs.lstat()) stats.isFIFO() stats.isSocket()
使用如下所示:
fs.stat('./app.js',(err,stats)=>{ if(err) throw err; console.log(stats); }); var stats = fs.statSync('../test.txt');//同步版本
3、文件追加
使用fs.appendFile(file, data[, options], callback)方法向file写入数据,如果file不存在,则创建file,data参数为字符串或buffer,options可选参数是对象或字符串,具有以下属性:
encoding | default = 'utf8' 编码
mode default = 0o666 打开模式
flag default = 'a'
使用如下所示:
fs.appendFile('./test.txt','hello world!\r\n',(err)=>{ if(err) throw err; console.log('写入成功'); }); //appendFile同步版本,返回值为undefined fs.appendFileSync('./test.txt','hello nodejs!\r\n');
4、文件读取和写入
文件读取使用fs.readFile(file[, options], callback)方法,参数含义如下:
file 文件名或文件描述符
options 对象或字符串,如果是对象,则包含encoding和flag,前者默认为null,后者为'r'
callback 参数为(err,data)
如果指定的文件不存在,则直接抛出错误。使用如下所示:
fs.readFile('./test4.txt',{encoding:'utf8',flag:'r'},(err,data)=>{ if(err) throw err; console.log(data); }); var data = fs.readFileSync('../test4.txt',{encoding:'utf8',flag:'r'});
文件写入数据,使用fs.writeFile(file, data[, options], callback)方法,参数含义如下:
file 文件名或文件描述符
data 字符串或buffer
options 对象或字符串,如果是对象,则包含encoding、mode以及flag,依次默认为utf8,0o666,'w'
callback 参数err
如果指定的文件不存在,则创建该文件,相反则替换原来的文件。使用如下所示:
var data = "hello node!"; fs.writeFile('./test1.txt',data,{flag:'w'},(err)=>{ if(err) throw err; console.log('written ok.'); }); fs.writeFileSync('./test1.txt',data,{flag:'w'});
我们也可以利用fs的open,read,write,stat等方法来实现文件的读取和写入。
fs.open(path, flags[, mode], callback)方法打开一个文件获取句柄,flags参数有以下这些:
'r' - 以只读方式打开文件,若文件不存在则报错。
'r+' - 以读写方式打开文件,若文件不存在则报错。
'rs+' 在同步模式下,以读写方式打开文件
'w' - 以写方式打开文件,若文件不存在则创建
'wx' - 以写方式打开文件,若文件不存在则抛出异常.
'w+' - 以读写方式打开文件,若文件不存在则创建,相反则清空文件.
'wx+' - 以读写方式打开文件,若文件不存在则抛出异常.
'a' - 以追加方式打开文件,若文件不存则创建文件
'ax' - 以追加方式打开文件,若文件不存则抛出异常.
'a+' - 以追加和读方式打开文件,若文件不存则创建文件
'ax+' - 以追加和读方式打开文件,若文件不存则失败
callback回调函数有(err,fd)两个参数。
fs.read(fd, buffer, offset, length, position, callback)方法,从一个文件中读取数据存入buffer中,参数含义如下:
buffer Buffer对象,用来存储读取的数据
offset buffer开始写的位置
length 需要读取的长度
position 指定从文件的哪个位置开始读取,若设置为null,则从文件当前位置开始读取
callback 有三个参数(err, bytesRead, buffer) bytesRead为实际读取字节数
fs.write(fd, buffer, offset, length[, position], callback)方法,将buffer数据写如指定文件中,参数含义如下:
offset和length指定buffer的部分
position 指定文件的开始写入的文件,若不为数字则从文件当前位置开始写入
下面是一个使用open,write,read,stat方法实现的文件内容复制的函数,如下所示: