Function walkSync

  • walkSync(root, options?): IterableIterator<WalkEntry>

  • Recursively walks through a directory and yields information about each file and directory encountered.

    The root path determines whether the file paths is relative or absolute. The root directory is included in the yielded entries.

    Requires --allow-read permission.

    Parameters

    • root: string | URL

      The root directory to start the walk from, as a string or URL.

    • Optionaloptions: WalkOptions

      The options for the walk.

    Returns IterableIterator<WalkEntry>

    A synchronous iterable iterator that yields the walk entry objects.

    See

    https://docs.deno.com/runtime/manual/basics/permissions#file-system-access for more information on Deno's permissions system.

    Example: Basic usage

    File structure:

    folder
    ├── script.ts
    └── foo.ts

    import { walkSync } from "@std/fs/walk";

    Array.from(walkSync("."));
    // [
    //   {
    //     path: ".",
    //     name: ".",
    //     isFile: false,
    //     isDirectory: true,
    //     isSymlink: false
    //   },
    //   {
    //     path: "script.ts",
    //     name: "script.ts",
    //     isFile: true,
    //     isDirectory: false,
    //     isSymlink: false
    //   },
    //   {
    //     path: "foo.ts",
    //     name: "foo.ts",
    //     isFile: true,
    //     isDirectory: false,
    //     isSymlink: false
    //   },
    // ]

    Example: Maximum file depth

    Setting the maxDepth option to 1 will only include the root directory and its immediate children.

    File structure:

    folder
    ├── script.ts
    └── foo
        └── bar.ts

    import { walkSync } from "@std/fs/walk";

    Array.from(walkSync(".", { maxDepth: 1 }));
    // [
    //   {
    //     path: ".",
    //     name: ".",
    //     isFile: false,
    //     isDirectory: true,
    //     isSymlink: false
    //   },
    //   {
    //     path: "script.ts",
    //     name: "script.ts",
    //     isFile: true,
    //     isDirectory: false,
    //     isSymlink: false
    //   },
    //   {
    //     path: "foo",
    //     name: "foo",
    //     isFile: false,
    //     isDirectory: true,
    //     isSymlink: false
    //   },
    // ]

    Example: Exclude files

    Setting the includeFiles option to false will exclude files.

    File structure:

    folder
    ├── script.ts
    └── foo

    import { walkSync } from "@std/fs/walk";

    Array.from(walkSync(".", { includeFiles: false }));
    // [
    //   {
    //     path: ".",
    //     name: ".",
    //     isFile: false,
    //     isDirectory: true,
    //     isSymlink: false
    //   },
    //   {
    //     path: "foo",
    //     name: "foo",
    //     isFile: false,
    //     isDirectory: true,
    //     isSymlink: false,
    //   },
    // ]

    Example: Exclude directories

    Setting the includeDirs option to false will exclude directories.

    File structure:

    folder
    ├── script.ts
    └── foo

    import { walkSync } from "@std/fs/walk";

    Array.from(walkSync(".", { includeDirs: false }));
    // [
    //   {
    //     path: "script.ts",
    //     name: "script.ts",
    //     isFile: true,
    //     isDirectory: false,
    //     isSymlink: false
    //   },
    // ]

    Example: Exclude symbolic links

    Setting the includeSymlinks option to false will exclude symbolic links.

    File structure:

    folder
    ├── script.ts
    ├── foo
    └── link -> script.ts (symbolic link)

    import { walkSync } from "@std/fs/walk";

    Array.from(walkSync(".", { includeSymlinks: false }));
    // [
    //   {
    //     path: ".",
    //     name: ".",
    //     isFile: false,
    //     isDirectory: true,
    //     isSymlink: false
    //   },
    //   {
    //     path: "script.ts",
    //     name: "script.ts",
    //     isFile: true,
    //     isDirectory: false,
    //     isSymlink: false
    //   },
    // ]

    Example: Canonicalize symbolic links

    Setting the canonicalize option to false will canonicalize the path of the followed symbolic link. Meaning, the path property of the walk entry will be the path of the symbolic link itself.

    File structure:

    folder
    ├── script.ts
    └── link -> script.ts (symbolic link)

    import { walkSync } from "@std/fs/walk";

    Array.from(walkSync(".", { followSymlinks: true, canonicalize: true }));
    // [
    //   {
    //     path: ".",
    //     name: ".",
    //     isFile: false,
    //     isDirectory: true,
    //     isSymlink: false
    //   },
    //   {
    //     path: "script.ts",
    //     name: "script.ts",
    //     isFile: true,
    //     isDirectory: false,
    //     isSymlink: false
    //   },
    //   {
    //     path: "link",
    //     name: "link",
    //     isFile: true,
    //     isDirectory: false,
    //     isSymlink: true
    //   },
    // ]

    Example: Filter by file extensions

    Setting the exts option to [".ts"] or ["ts"] will only include entries with the .ts file extension.

    File structure:

    folder
    ├── script.ts
    └── foo.js

    import { walkSync } from "@std/fs/walk";

    Array.from(walkSync(".", { exts: [".ts"] }));
    // [
    //   {
    //     path: "script.ts",
    //     name: "script.ts",
    //     isFile: true,
    //     isDirectory: false,
    //     isSymlink: false
    //   },
    // ]

    Example: Filter by regular expressions

    Setting the match option to [/.s/] will only include entries with the letter s in their name.

    File structure:

    folder
    ├── script.ts
    └── README.md

    import { walkSync } from "@std/fs/walk";

    Array.from(walkSync(".", { match: [/s/] }));
    // [
    //   {
    //     path: "script.ts",
    //     name: "script.ts",
    //     isFile: true,
    //     isDirectory: false,
    //     isSymlink: false
    //   },
    // ]

    Example: Exclude by regular expressions

    Setting the skip option to [/.s/] will exclude entries with the letter s in their name.

    File structure:

    folder
    ├── script.ts
    └── README.md

    import { walkSync } from "@std/fs/walk";

    Array.from(walkSync(".", { skip: [/s/] }));
    // [
    //   {
    //     path: "README.md",
    //     name: "README.md",
    //     isFile: true,
    //     isDirectory: false,
    //     isSymlink: false
    //   },
    // ]

Settings

Member Visibility