文件操作频率最高的就是读跟写。nodejs的文件的读取API在《node基础-文件系统-读取文件》里已经简单介绍过,本文就简单介绍下nodejs的文件写API。
nodejs的文件操作均提供了同步、异步两种方式,写操作也是同样的,常用的两个接口为fs.writeFile(异步)、fs.writeFileSync(同步),下面就来看看他们的使用以及区别。
fs.writeFile(filename, data, [options], callback)
先来看下API说明
/** * 往文件里异步写数据,写入的内容可以是字符串,也可以是二进制数据。 * 如果文件不存在,则创建;如果文件已存在,那么内容会被覆盖 * @param {String} filename 文件名 * @param {String|Buffer} data 要往文件里写的内容,可以是字符串,也可以是二进制数据。当为二进制数据时候,options.encoding 会被忽略 * @param {Object} [options] * @param {String} options.encoding 编码,默认是utf8 * @param {Number} options.mode=438 模式 * @param {String} options.flag=w 写文件的模式 * @param {Function} callback 回调方法 */ fs.writeFile(filename, data, [options], callback)
接下来我们来看看实际例子,首先,需要引入fs,下面为节省篇幅就不再贴这行代码了
var fs = require('fs');
例子一:往不存在的文件里写内容
往一个不存在的文件里写内容,则会先创建该文件,再往里面写内容
var noneExistFileName = ['async_create.', new Date()-0, '.txt'].join(''); fs.writeFile(noneExistFileName, '文件不存在,则创建', function(err){ if(err) throw err; console.log(noneExistFileName+'不存在,被创建了!'); });
例子二:往存在的文件里写内容
如果该文件已存在,则原有文件内容会北覆盖
fs.writeFile('async_exists.txt', '文件已存在,则覆盖内容 -- '+(new Date()-0), function(err){ if(err) throw err; console.log('exists.txt已存在,内容被覆盖!'); });
例子三:往已经存在的文件里追加内容
options.flag 设置为 'a' 时,则会将写模式变为追加内容
fs.writeFile('async_add.txt', '\n文件已存在,并追加内容 -- '+(new Date()-0), { flag: 'a' }, function(err){ if(err) throw err; console.log('exists.txt已存在,内容被覆盖!'); });
fs.writeFileSync(filename, data, [options])
写文件的同步版本,同样先来看下API说明,你会发现跟fs.writeFile 没啥区别,就是少了个回调
/** * 文件同步写接口,是fs.writeFile的同步版本,参数也差不多 * @param {String} filename 文件名 * @param {String|Buffer} data 要往文件里写的内容,可以是字符串,也可以是二进制数据。当为二进制数据时候,options.encoding 会被忽略 * @param {Object} [options] * @param {String} options.encoding 编码,默认是utf8 * @param {Number} options.mode=438 模式 * @param {String} options.flag=w 写文件的模式 */ fs.writeFileSync(filename, data, [options])
下面我们看下具体例子
例子一:往不存在的文件里写内容,则创建该文件
// case 1:往不存在的文件里写内容,则创建该文件 var noneExistFileName = ['sync_create.', new Date()-0, '.txt'].join(''); fs.writeFile(noneExistFileName, '文件不存在,则创建');
例子二:往存在的文件里写内容,原有内容被覆盖
fs.writeFile('sync_exists.txt', '文件已存在,则覆盖内容 -- '+(new Date()-0));
例子三:往已经存在的文件里追加内容
fs.writeFile('sync_add.txt', '\n文件已存在,并追加内容 -- '+(new Date()-0), { flag: 'a' });
完整示例
demo下载请点击,将代码随便解压缩到任意目录下,然后在该目录下运行命令 node writefile.js 即可
/** * 文件写入demo,by 程序猿小卡 */ var fs = require('fs'); /** * 往文件里异步写数据,写入的内容可以是字符串,也可以是二进制数据。 * 如果文件不存在,则创建;如果文件已存在,那么内容会被覆盖 * @param {String} filename 文件名 * @param {String|Buffer} data 要往文件里写的内容,可以是字符串,也可以是二进制数据。当为二进制数据时候,options.encoding 会被忽略 * @param {Object} [options] * @param {String} options.encoding 编码,默认是utf8 * @param {Number} options.mode=438 模式 * @param {String} options.flag=w 写文件的模式 * @param {Function} callback 回调方法 */ // fs.writeFile(filename, data, [options], callback) // case 1:往不存在的文件里写内容,则创建该文件 var noneExistFileName = ['async_create.', new Date()-0, '.txt'].join(''); fs.writeFile(noneExistFileName, '文件不存在,则创建', function(err){ if(err) throw err; console.log(noneExistFileName+'不存在,被创建了!'); }); // case 2:往存在的文件里写内容,原有内容被覆盖 fs.writeFile('async_exists.txt', '文件已存在,则覆盖内容 -- '+(new Date()-0), function(err){ if(err) throw err; console.log('exists.txt已存在,内容被覆盖!'); }); // case 3:往已经存在的文件里追加内容 fs.writeFile('async_add.txt', '\n文件已存在,并追加内容 -- '+(new Date()-0), { flag: 'a' }, function(err){ if(err) throw err; console.log('exists.txt已存在,内容被覆盖!'); }); /** * 文件同步写接口,是fs.writeFile的同步版本,参数也差不多 * @param {String} filename 文件名 * @param {String|Buffer} data 要往文件里写的内容,可以是字符串,也可以是二进制数据。当为二进制数据时候,options.encoding 会被忽略 * @param {Object} [options] * @param {String} options.encoding 编码,默认是utf8 * @param {Number} options.mode=438 模式 * @param {String} options.flag=w 写文件的模式 */ // fs.writeFileSync(filename, data, [options]) // case 1:往不存在的文件里写内容,则创建该文件 var noneExistFileName = ['sync_create.', new Date()-0, '.txt'].join(''); fs.writeFile(noneExistFileName, '文件不存在,则创建'); // case 2:往存在的文件里写内容,原有内容被覆盖 fs.writeFile('sync_exists.txt', '文件已存在,则覆盖内容 -- '+(new Date()-0)); // case 3:往已经存在的文件里追加内容 fs.writeFile('sync_add.txt', '\n文件已存在,并追加内容 -- '+(new Date()-0), { flag: 'a' });