如何在 Node.js 中判斷一個文件是否存在?
記錄一些 Node.js 應(yīng)用中的小知識點,如果你 Google/Baidu “Node.js 如何判斷文件是否存在” 發(fā)現(xiàn)給出的很多答案還是使用的 fs.exists,這里不推薦使用 fs.exists 你可以選擇 fs.stat 或 fs.access。
為什么不推薦 fs.exists
我們在設(shè)計一個回調(diào)函數(shù)時,通常會遵循一個原則 “ 錯誤優(yōu)先的回調(diào)函數(shù)”,也就是返回值的第一個參數(shù)為錯誤信息,用以驗證是否出錯,其它的參數(shù)則用于返回數(shù)據(jù)。
如下所示為 fs.exists 的使用示例,直接返回了一個布爾值,違背了 “錯誤優(yōu)先的回調(diào)函數(shù)” 這一設(shè)計原則,這是一方面原因。
- fs.exists('/etc/passwd', (exists) => {
- console.log(exists ? '存在' : '不存在');
- });
另外一個是 不推薦在 fs.open()、 fs.readFile() 或 fs.writeFile() 之前使用 fs.exists() 判斷文件是否存在,因為這樣會引起 競態(tài)條件,如果是在多進(jìn)程下,程序的執(zhí)行不完全是線性的,當(dāng)程序的一個進(jìn)程在執(zhí)行 fs.exists 和 fs.writeFile() 時,其它進(jìn)程是有可能在這之間更改文件的狀態(tài),這樣就會造成一些非預(yù)期的結(jié)果。
不推薦:
- (async () => {
- const exists = await util.promisify(fs.exists)('text.txt');
- console.log(exists);
- await sleep(10000);
- if (exists) {
- try {
- const res = await util.promisify(fs.readFile)('text.txt', { encoding: 'utf-8' });
- console.log(res);
- } catch (err) {
- console.error(err.code, err.message);
- throw err;
- }
- }
- })();
推薦:
- (async () => {
- try {
- const data = await util.promisify(fs.readFile)('text.txt', { encoding: 'utf-8' });
- console.log(data);
- } catch (err) {
- if (err.code === 'ENOENT') {
- console.error('File does not exists');
- } else {
- throw err;
- }
- }
- })();
目前 fs.exists 已被廢棄,另外需要清楚, 只有在文件不直接使用時才去檢查文件是否存在,下面推薦幾個檢查文件是否存在的方法。
使用 fs.stat
fs.stat返回一個 fs.Stats 對象,該對象提供了關(guān)于文件的很多信息,例如文件大小、創(chuàng)建時間等。其中有兩個方法 stats.isDirectory()、stats.isFile() 用來判斷是否是一個目錄、是否是一個文件。
- const stats = await util.promisify(fs.stat)('text1.txt');
- console.log(stats.isDirectory()); // false
- console.log(stats.isFile()); // true
若只是檢查文件是否存在,推薦使用下面的 fs.access。
使用 fs.access
fs.access 接收一個 mode 參數(shù)可以判斷一個文件是否存在、是否可讀、是否可寫,返回值為一個 err 參數(shù)。
- const file = 'text.txt';
- // 檢查文件是否存在于當(dāng)前目錄中。
- fs.access(file, fs.constants.F_OK, (err) => {
- console.log(`${file} ${err ? '不存在' : '存在'}`);
- });
- // 檢查文件是否可讀。
- fs.access(file, fs.constants.R_OK, (err) => {
- console.log(`${file} ${err ? '不可讀' : '可讀'}`);
- });
- // 檢查文件是否可寫。
- fs.access(file, fs.constants.W_OK, (err) => {
- console.log(`${file} ${err ? '不可寫' : '可寫'}`);
- });
- // 檢查文件是否存在于當(dāng)前目錄中、以及是否可寫。
- fs.access(file, fs.constants.F_OK | fs.constants.W_OK, (err) => {
- if (err) {
- console.error(
- `${file} ${err.code === 'ENOENT' ? '不存在' : '只可讀'}`);
- } else {
- console.log(`${file} 存在,且可寫`);
- }
- });
同樣的也不推薦在 fs.open()、 fs.readFile() 或 fs.writeFile() 之前使用 fs.exists() 判斷文件是否存在,會引起競態(tài)條件。
Reference
http://nodejs.cn/api/fs.html