如何检查文件是否存在?
在模块的文档中fs
有对方法的描述fs.exists(path, callback)
。但是,据我了解,它只检查目录是否存在。我需要检查文件!
如何才能做到这一点?
为什么不尝试打开文件?fs.open('YourFile', 'a', function (err, fd) { ... })
无论如何,经过一分钟的搜索,试试这个:
var path = require('path');
path.exists('foo.txt', function(exists) {
if (exists) {
// do something
}
});
// or
if (path.existsSync('foo.txt')) {
// do something
}
对于 Node.js v0.12.x 及更高版本
两者path.exists
和fs.exists
已被弃用
使用 fs.stat:
fs.stat('foo.txt', function(err, stat) {
if(err == null) {
console.log('File exists');
} else if(err.code === 'ENOENT') {
// file does not exist
fs.writeFile('log.txt', 'Some log\n');
} else {
console.log('Some other error: ', err.code);
}
});
编辑:v10.0.0
因为我们可以使用
节点fs.promises.access(...)
检查文件是否存在的示例异步代码:
function checkFileExists(file) {
return fs.promises.access(file, fs.constants.F_OK)
.then(() => true)
.catch(() => false)
}
stat 的替代方法可能是使用新的fs.access(...)
:
用于检查的缩小的短承诺功能:
s => new Promise(r=>fs.access(s, fs.constants.F_OK, e => r(!e)))
示例用法:
let checkFileExists = s => new Promise(r=>fs.access(s, fs.constants.F_OK, e => r(!e)))
checkFileExists("Some File Location")
.then(bool => console.log(´file exists: ${bool}´))
扩展承诺方式:
// returns a promise which resolves true if file exists:
function checkFileExists(filepath){
return new Promise((resolve, reject) => {
fs.access(filepath, fs.constants.F_OK, error => {
resolve(!error);
});
});
}
或者如果你想同步做:
function checkFileExistsSync(filepath){
let flag = true;
try{
fs.accessSync(filepath, fs.constants.F_OK);
}catch(e){
flag = false;
}
return flag;
}
同步执行此操作的更简单方法。
if (fs.existsSync('/etc/file')) {
console.log('Found file');
}
API 文档说明了如何existsSync
工作:
通过检查文件系统来测试给定路径是否存在。
现代异步/等待方式(节点 12.8.x)
const fileExists = async path => !!(await fs.promises.stat(path).catch(e => false));
const main = async () => {
console.log(await fileExists('/path/myfile.txt'));
}
main();
我们需要使用fs.stat() or fs.access()
,因为fs.exists(path, callback)
now 已被弃用
另一个好方法是fs-extra
fs.exists(path, callback)
现在fs.existsSync(path)
已弃用,请参阅https://nodejs.org/api/fs.html#fs_fs_exists_path_callback和https://nodejs.org/api/fs.html#fs_fs_existssync_path。
要同步测试文件的存在,可以使用 ie。fs.statSync(path)
. fs.Stats
如果文件存在,将返回一个对象,请参阅https://nodejs.org/api/fs.html#fs_class_fs_stats,否则将引发错误,该错误将被 try / catch 语句捕获。
var fs = require('fs'),
path = '/path/to/my/file',
stats;
try {
stats = fs.statSync(path);
console.log("File exists.");
}
catch (e) {
console.log("File does not exist.");
}
V6 之前的旧版本: 这是文档
const fs = require('fs');
fs.exists('/etc/passwd', (exists) => {
console.log(exists ? 'it\'s there' : 'no passwd!');
});
// or Sync
if (fs.existsSync('/etc/passwd')) {
console.log('it\'s there');
}
更新
V6 的新版本:文档fs.stat
fs.stat('/etc/passwd', function(err, stat) {
if(err == null) {
//Exist
} else if(err.code == 'ENOENT') {
// NO exist
}
});
有很多关于fs.existsSync()
被弃用的不准确评论;它不是。
https://nodejs.org/api/fs.html#fs_fs_existssync_path
请注意,不推荐使用 fs.exists(),但不推荐使用 fs.existsSync()。
2021 年 8 月
看完所有帖子后:
let filePath = "./directory1/file1.txt";
if (fs.existsSync(filePath)) {
console.log("The file exists");
} else {
console.log("The file does not exist");
}
@Fox:很好的答案!这是一个带有更多选项的扩展。这是我最近一直使用的首选解决方案:
var fs = require('fs');
fs.lstat( targetPath, function (err, inodeStatus) {
if (err) {
// file does not exist-
if (err.code === 'ENOENT' ) {
console.log('No file or directory at',targetPath);
return;
}
// miscellaneous error (e.g. permissions)
console.error(err);
return;
}
// Check if this is a file or directory
var isDirectory = inodeStatus.isDirectory();
// Get file size
//
// NOTE: this won't work recursively for directories-- see:
// http://stackoverflow.com/a/7550430/486547
//
var sizeInBytes = inodeStatus.size;
console.log(
(isDirectory ? 'Folder' : 'File'),
'at',targetPath,
'is',sizeInBytes,'bytes.'
);
}
PS 如果您还没有使用它,请查看 fs-extra——它非常棒。 https://github.com/jprichardson/node-fs-extra)
fs.exists
自 1.0.0 起已弃用。您可以使用它fs.stat
来代替。
var fs = require('fs');
fs.stat(path, (err, stats) => {
if ( !stats.isFile(filename) ) { // do this
}
else { // do this
}});
这是文档 fs.stats的链接
async/await
util.promisify
从节点 8 开始使用的版本:
const fs = require('fs');
const { promisify } = require('util');
const stat = promisify(fs.stat);
describe('async stat', () => {
it('should not throw if file does exist', async () => {
try {
const stats = await stat(path.join('path', 'to', 'existingfile.txt'));
assert.notEqual(stats, null);
} catch (err) {
// shouldn't happen
}
});
});
describe('async stat', () => {
it('should throw if file does not exist', async () => {
try {
const stats = await stat(path.join('path', 'to', 'not', 'existingfile.txt'));
} catch (err) {
assert.notEqual(err, null);
}
});
});
fs.statSync(path, function(err, stat){
if(err == null) {
console.log('File exists');
//code when all ok
}else if (err.code == "ENOENT") {
//file doesn't exist
console.log('not file');
}
else {
console.log('Some other error: ', err.code);
}
});
经过一番实验,我发现下面的例子fs.stat
是一种异步检查文件是否存在的好方法。它还会检查您的“文件”是否是“真正的文件”(而不是目录)。
此方法使用 Promises,假设您正在使用异步代码库:
const fileExists = path => {
return new Promise((resolve, reject) => {
try {
fs.stat(path, (error, file) => {
if (!error && file.isFile()) {
return resolve(true);
}
if (error && error.code === 'ENOENT') {
return resolve(false);
}
});
} catch (err) {
reject(err);
}
});
};
如果文件不存在,promise 仍然会解析,尽管false
. 如果该文件确实存在,并且它是一个目录,则解析true
. 尝试读取文件的任何错误都reject
将承诺错误本身。
好吧,我是这样做的,如https://nodejs.org/api/fs.html#fs_fs_access_path_mode_callback所示
fs.access('./settings', fs.constants.F_OK | fs.constants.R_OK | fs.constants.W_OK, function(err){
console.log(err ? 'no access or dir doesnt exist' : 'R/W ok');
if(err && err.code === 'ENOENT'){
fs.mkdir('settings');
}
});
这有什么问题吗?
在过去,在坐下之前,我总是检查椅子是否在那里,然后我就坐,否则我有一个替代计划,比如坐在教练上。现在 node.js 网站建议去(无需检查),答案如下所示:
fs.readFile( '/foo.txt', function( err, data )
{
if(err)
{
if( err.code === 'ENOENT' )
{
console.log( 'File Doesn\'t Exist' );
return;
}
if( err.code === 'EACCES' )
{
console.log( 'No Permission' );
return;
}
console.log( 'Unknown Error' );
return;
}
console.log( data );
} );
代码取自2014 年 3 月的http://fredkschott.com/post/2014/03/understanding-error-first-callbacks-in-node-js/,稍作修改以适应计算机。它也会检查权限 - 删除测试权限chmod a-r foo.txt
function fileExists(path, cb){
return fs.access(path, fs.constants.F_OK,(er, result)=> cb(!err && result)) //F_OK checks if file is visible, is default does no need to be specified.
}
文档说您应该用作已弃用的access()
替代品exists()
function fileExists(path, cb){
return new Promise((accept,deny) =>
fs.access(path, fs.constants.F_OK,(er, result)=> cb(!err && result))
);
}
var fs = require('fs-extra')
await fs.pathExists(filepath)
如您所见,要简单得多。与 promisify 相比的优势在于,您可以使用这个包进行完整的输入(完整的智能感知/打字稿)!大多数情况下,您已经包含了这个库,因为 (+-10.000) 其他库依赖于它。
您可以fs.stat
用来检查目标是文件还是目录,并且可以fs.access
用来检查您是否可以写入/读取/执行文件。(记得用来path.resolve
获取目标的完整路径)
文档:
完整示例(TypeScript)
import * as fs from 'fs';
import * as path from 'path';
const targetPath = path.resolve(process.argv[2]);
function statExists(checkPath): Promise<fs.Stats> {
return new Promise((resolve) => {
fs.stat(checkPath, (err, result) => {
if (err) {
return resolve(undefined);
}
return resolve(result);
});
});
}
function checkAccess(checkPath: string, mode: number = fs.constants.F_OK): Promise<boolean> {
return new Promise((resolve) => {
fs.access(checkPath, mode, (err) => {
resolve(!err);
});
});
}
(async function () {
const result = await statExists(targetPath);
const accessResult = await checkAccess(targetPath, fs.constants.F_OK);
const readResult = await checkAccess(targetPath, fs.constants.R_OK);
const writeResult = await checkAccess(targetPath, fs.constants.W_OK);
const executeResult = await checkAccess(targetPath, fs.constants.X_OK);
const allAccessResult = await checkAccess(targetPath, fs.constants.F_OK | fs.constants.R_OK | fs.constants.W_OK | fs.constants.X_OK);
if (result) {
console.group('stat');
console.log('isFile: ', result.isFile());
console.log('isDir: ', result.isDirectory());
console.groupEnd();
}
else {
console.log('file/dir does not exist');
}
console.group('access');
console.log('access:', accessResult);
console.log('read access:', readResult);
console.log('write access:', writeResult);
console.log('execute access:', executeResult);
console.log('all (combined) access:', allAccessResult);
console.groupEnd();
process.exit(0);
}());
对于异步版本!并带有承诺版本!这里是干净简单的方法!
try {
await fsPromise.stat(filePath);
/**
* File exists!
*/
// do something
} catch (err) {
if (err.code = 'ENOENT') {
/**
* File not found
*/
} else {
// Another error!
}
}
我的代码中更实用的片段可以更好地说明:
try {
const filePath = path.join(FILES_DIR, fileName);
await fsPromise.stat(filePath);
/**
* File exists!
*/
const readStream = fs.createReadStream(
filePath,
{
autoClose: true,
start: 0
}
);
return {
success: true,
readStream
};
} catch (err) {
/**
* Mapped file doesn't exists
*/
if (err.code = 'ENOENT') {
return {
err: {
msg: 'Mapped file doesn\'t exists',
code: EErrorCode.MappedFileNotFound
}
};
} else {
return {
err: {
msg: 'Mapped file failed to load! File system error',
code: EErrorCode.MappedFileFileSystemError
}
};
}
}
上面的例子只是为了演示!我本可以使用读取流的错误事件!捕捉任何错误!跳过这两个电话!
在 node14 中使用 typescript 和 fs/promises
import * as fsp from 'fs/promises';
try{
const = await fsp.readFile(fullFileName)
...
} catch(e) { ...}
使用fsp.readFile
比fsp.stat
或更好fsp.access
有两个原因:
fsp.stat
并且fsp.readFile
会给出不同的答案。要么是由于他们提出的问题存在细微差别,要么是因为文件状态在通话之间发生了变化。因此,编码人员必须编写两个条件分支而不是一个,用户可能会看到更多行为。异步等待风格的简洁解决方案:
import { stat } from 'fs/promises';
const exists = await stat('foo.txt')
.then(() => true)
.catch(() => false);