file-exists-safe

Check if a file exists without try catch.

• Returns true if the path exists and is a file.
• Returns false if the path is not a file, or does not exist.
• Returns undefined on other errors, such as permission denied, rather than throwing.

Installation

npm install file-exists-safe

yarn add file-exists-safe

pnpm add file-exists-safe

bun add file-exists-safe

Usage

import { fileExists, fileExistsSync, Options } from "file-exists-safe";

function fileExists(path: string, options?: Options): Promise<boolean | undefined>;

function fileExistsSync(path: string, options?: Options): boolean | undefined;

type Options = {
  /**
   * Return true if path is directory. Default: `false`
   */
  includeDirectories?: boolean;
};

License

MIT - MIT License

Related Packages

• fs-safe: A simple fs wrapper that doesn't throw
• dir-exists-safe: Check if a directory exists without a try catch