Function exists

  • exists(path, options?): Promise<boolean>

  • Asynchronously test whether or not the given path exists by checking with the file system.

    Note: Do not use this function if performing a check before another operation on that file. Doing so creates a race condition. Instead, perform the actual file operation directly. This function is not recommended for this use case. See the recommended method below.

    Parameters

    • path: string | URL

      The path to the file or directory, as a string or URL.

    • Optionaloptions: ExistsOptions

      Additional options for the check.

    Returns Promise<boolean>

    A promise that resolves with true if the path exists, false otherwise.

    See

    Requires --allow-read permissions, and in some cases, --allow-sys permissions if options.isReadable is true.

    Example: Recommended method

    // Notice no use of exists
    try {
      await Deno.remove("./foo", { recursive: true });
    } catch (error) {
      if (!(error instanceof Deno.errors.NotFound)) {
        throw error;
      }
      // Do nothing...
    }

    Notice that exists() is not used in the above example. Doing so avoids a possible race condition. See the above note for details.

    Example: Basic usage

    import { exists } from "@std/fs/exists";

    await exists("./exists"); // true
    await exists("./does_not_exist"); // false

    Example: Check if a path is readable

    Requires --allow-sys permissions in some cases.

    import { exists } from "@std/fs/exists";

    await exists("./readable", { isReadable: true }); // true
    await exists("./not_readable", { isReadable: true }); // false

    Example: Check if a path is a directory

    import { exists } from "@std/fs/exists";

    await exists("./directory", { isDirectory: true }); // true
    await exists("./file", { isDirectory: true }); // false

    Example: Check if a path is a file

    import { exists } from "@std/fs/exists";

    await exists("./file", { isFile: true }); // true
    await exists("./directory", { isFile: true }); // false

    Example: Check if a path is a readable directory

    Requires --allow-sys permissions in some cases.

    import { exists } from "@std/fs/exists";

    await exists("./readable_directory", { isReadable: true, isDirectory: true }); // true
    await exists("./not_readable_directory", { isReadable: true, isDirectory: true }); // false

    Example: Check if a path is a readable file

    Requires --allow-sys permissions in some cases.

    import { exists } from "@std/fs/exists";

    await exists("./readable_file", { isReadable: true, isFile: true }); // true
    await exists("./not_readable_file", { isReadable: true, isFile: true }); // false

Settings

Member Visibility