方法說明
以非同步方式把 data 寫入檔案。若檔案已存在,原內容會被整個替換掉(除非 flag 設為 'a' 表示追加)。
語法
fs.writeFile(filename, data, [options], [callback(err)])
此方式屬於 fs 模組,使用前必須先引入:var fs = require("fs")
參數說明
filename (String):檔案名稱。
data (String | Buffer):要寫入的內容,可以是字串或 Buffer 資料。
options (Object):option 物件,包含:
· encoding (String):編碼格式,預設 'utf8';當 data 是 Buffer 時此值會被忽略。
· mode (Number):檔案讀寫權限,預設值 438(即 0666)。
· flag (String):開啟模式,預設值 'w'。
callback {Function}:回調函式,接收 err 異常參數。
範例
fs.writeFile('message.txt', 'Hello Node', function (err) {
if (err) throw err;
console.log('It\'s saved!');
});
原始碼
從實作可以看到 options 支援三種傳法:省略、傳字串(當作 encoding),或傳物件。另外會依 flag 是否為 append 模式決定寫入位置。
fs.writeFile = function(path, data, options, callback) {
var callback = maybeCallback(arguments[arguments.length - 1]);
if (util.isFunction(options) || !options) {
options = { encoding: 'utf8', mode: 438 /*=0666*/, flag: 'w' };
} else if (util.isString(options)) {
options = { encoding: options, mode: 438, flag: 'w' };
} else if (!util.isObject(options)) {
throw new TypeError('Bad arguments');
}
assertEncoding(options.encoding);
var flag = options.flag || 'w';
fs.open(path, options.flag || 'w', options.mode, function(openErr, fd) {
if (openErr) {
if (callback) callback(openErr);
} else {
var buffer = util.isBuffer(data) ? data : new Buffer('' + data,
options.encoding || 'utf8');
var position = /a/.test(flag) ? null : 0;
writeAll(fd, buffer, 0, buffer.length, position, callback);
}
});
};