# @11ty/dependency-tree

> Finds all JavaScript CommmonJS require() dependencies from a filename.

Latest version **4.0.2** (published 2026-01-17) · MIT license · 0 weekly downloads

## Install

```sh
npm install @11ty/dependency-tree
pnpm add @11ty/dependency-tree
yarn add @11ty/dependency-tree
bun add @11ty/dependency-tree
```

## Health

**Score 50/100 (C)** — status: stable.

Positive: no vulnerabilities; has provenance.

Warnings: low downloads; no types; no esm support.

## Facts

| | |
|---|---|
| Version | 4.0.2 |
| Published | 2026-01-17 |
| First published | 2019-09-20 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 1 |
| Unpacked size | 9.7 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 9 |
| Author | Zach Leatherman |
| Maintainers | zachleat, fortawesome-admin |

## Links

- npm: https://www.npmjs.com/package/@11ty/dependency-tree
- Repository: https://github.com/11ty/eleventy-dependency-tree
- Homepage: https://github.com/11ty/eleventy-dependency-tree#readme
- Issues: https://github.com/11ty/eleventy-dependency-tree/issues
- npm.io page: https://npm.io/package/@11ty/dependency-tree

## Dependencies (1)

- [@11ty/eleventy-utils](https://npm.io/package/@11ty/eleventy-utils.md) ^2.0.1

## Recent versions

- 4.0.2 (latest) — 2026-01-17
- 4.0.1 — 2025-12-02
- 4.0.0 — 2025-03-03
- 3.0.1 — 2024-07-02
- 3.0.0 — 2023-08-25
- 2.0.1 — 2022-04-12
- 2.0.0 — 2021-04-11
- 1.0.0 — 2019-09-20

## README

# `@11ty/dependency-tree`

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

* See also: [`@11ty/dependency-tree-esm`](https://github.com/11ty/eleventy-utils/tree/main/parse-deps-esm) for the ESM version.
* See also: [`@11ty/dependency-tree-typescript`](https://github.com/11ty/eleventy-utils/tree/main/parse-deps-typescript) for the TypeScript version.

Reduced feature (faster) alternative to the [`dependency-tree` package](https://www.npmjs.com/package/dependency-tree). 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

```js
// my-file.js

// if my-local-dependency.js has dependencies, it will include those too
const test = require("./my-local-dependency.js");

// ignored, is a built-in
const path = require("path");
```

```js
const DependencyTree = require("@11ty/dependency-tree");

DependencyTree("./my-file.js");
// returns ["./my-local-dependency.js"]
```

### `allowNotFound`

```js
const DependencyTree = require("@11ty/dependency-tree");

DependencyTree("./this-does-not-exist.js"); // throws an error

DependencyTree("./this-does-not-exist.js", { allowNotFound: true });
// 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.

```js
// my-file.js:

require("./my-local-dependency.js");
require("@11ty/eleventy");
```

```js
const DependencyTree = require("@11ty/dependency-tree");

DependencyTree("./my-file.js");
// returns ["./my-local-dependency.js"]

DependencyTree("./my-file.js", { nodeModuleNames: "exclude" });
// returns ["./my-local-dependency.js"]

DependencyTree("./my-file.js", { nodeModuleNames: "include" });
// returns ["./my-local-dependency.js", "@11ty/eleventy"]

DependencyTree("./my-file.js", { nodeModuleNames: "only" });
// 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.

### `getPackagesByType` method

_Added in v4.0.2._

```js
const DependencyTree = require("@11ty/dependency-tree");
const {getPackagesByType} = DependencyTree;

// With `require(esm)` support, some targets may be modules!
// Return separate lists for commonjs and esm lists
getPackagesByType("./my-file.js");
// returns { commonjs: ["./my-file.js"], esm: [] }
```

---
_Source: https://npm.io/package/@11ty/dependency-tree · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._