dependency-tree

Returns an unordered array of local paths to dependencies of a CommonJS node JavaScript file (everything it or any of its dependencies requires).

• See also: dependency-tree-esm for ES Modules.

Reduced feature (faster) alternative to the dependency-tree package. This is used by Eleventy to find dependencies of a JavaScript file to watch for changes to re-run Eleventy’s build.

Big Huge Caveat

⚠ A big caveat to this plugin is that it will require the file in order to build a dependency tree. So if your module has side effects and you don’t want it to execute—do not use this!

Installation

npm install --save-dev @11ty/dependency-tree

Features

• Ignores node_modules
• Or, use nodeModuleNames to control whether or not node_modules package names are included (added in v2.0.1)
• Ignores Node’s built-ins (e.g. path)
• Handles circular dependencies (Node does this too)

Usage

1// my-file.js
2
3// if my-local-dependency.js has dependencies, it will include those too
4const test = require("./my-local-dependency.js");
5
6// ignored, is a built-in
7const path = require("path");

1const DependencyTree = require("@11ty/dependency-tree");
2
3DependencyTree("./my-file.js");
4// returns ["./my-local-dependency.js"]

allowNotFound

1const DependencyTree = require("@11ty/dependency-tree");
2
3DependencyTree("./this-does-not-exist.js"); // throws an error
4
5DependencyTree("./this-does-not-exist.js", { allowNotFound: true });
6// returns []

nodeModuleNames

(Added in v2.0.1) Controls whether or not node package names are included in the list of dependencies.

• nodeModuleNames: "include": included alongside the local JS files.
• nodeModuleNames: "exclude" (default): node module package names are excluded.
• nodeModuleNames: "only": only node module package names are returned.

1// my-file.js:
2
3require("./my-local-dependency.js");
4require("@11ty/eleventy");

1const DependencyTree = require("@11ty/dependency-tree");
2
3DependencyTree("./my-file.js");
4// returns ["./my-local-dependency.js"]
5
6DependencyTree("./my-file.js", { nodeModuleNames: "exclude" });
7// returns ["./my-local-dependency.js"]
8
9DependencyTree("./my-file.js", { nodeModuleNames: "include" });
10// returns ["./my-local-dependency.js", "@11ty/eleventy"]
11
12DependencyTree("./my-file.js", { nodeModuleNames: "only" });
13// returns ["@11ty/eleventy"]

(Deprecated) nodeModuleNamesOnly

(Added in v2.0.0) Changed to use nodeModuleNames option instead. Backwards compatibility is maintained automatically.

• nodeModuleNamesOnly: false is mapped to nodeModuleNames: "exclude"
• nodeModuleNamesOnly: true is mapped to nodeModuleNames: "only"

If both nodeModuleNamesOnly and nodeModuleNames are included in options, nodeModuleNames takes precedence.