# list-exports

> Given a package name and a version number, or a path to a package.json, what specifiers does it expose?

Latest version **2.3.0** (published 2026-07-28) · MIT license · 0 weekly downloads

## Install

```sh
npm install list-exports
pnpm add list-exports
yarn add list-exports
bun add list-exports
```

## Health

**Score 70/100 (B)** — status: active.

Positive: has types; esm support; no vulnerabilities; recently updated; high maintenance score; high quality score.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 2.3.0 |
| Published | 2026-07-28 |
| First published | 2020-05-25 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Node | ^18.17.0 \|\| >=20.5.0 |
| Dependencies | 29 |
| Unpacked size | 65.9 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 14 |
| Author | Jordan Harband |
| Maintainers | ljharb |
| Keywords | exports, cjs, esm, module, commonjs, es, export, entrypoint, resolve |

## Links

- npm: https://www.npmjs.com/package/list-exports
- Repository: https://github.com/ljharb/list-exports
- Homepage: https://github.com/ljharb/list-exports#readme
- Issues: https://github.com/ljharb/list-exports/issues
- Funding: https://github.com/sponsors/ljharb
- npm.io page: https://npm.io/package/list-exports

## Dependencies (29)

- [hasown](https://npm.io/package/hasown.md) ^2.0.4
- [semver](https://npm.io/package/semver.md) ^7.8.5
- [resolve](https://npm.io/package/resolve.md) ^2.0.0-next.7
- [for-each](https://npm.io/package/for-each.md) ^0.3.5
- [call-bind](https://npm.io/package/call-bind.md) ^1.0.9
- [array.from](https://npm.io/package/array.from.md) ^1.1.6
- [call-bound](https://npm.io/package/call-bound.md) ^1.0.4
- [sort-paths](https://npm.io/package/sort-paths.md) ^1.1.1
- [object-keys](https://npm.io/package/object-keys.md) ^1.1.1
- [npm-packlist](https://npm.io/package/npm-packlist.md) ^9.0.0
- [get-intrinsic](https://npm.io/package/get-intrinsic.md) ^1.3.0
- [array-includes](https://npm.io/package/array-includes.md) ^3.1.9
- [object-inspect](https://npm.io/package/object-inspect.md) ^1.13.4
- [object.entries](https://npm.io/package/object.entries.md) ^1.1.9
- [@npmcli/arborist](https://npm.io/package/@npmcli/arborist.md) ^8.0.5
- [get-package-type](https://npm.io/package/get-package-type.md) ^0.1.0
- [node-exports-info](https://npm.io/package/node-exports-info.md) ^2.0.0
- [safe-array-concat](https://npm.io/package/safe-array-concat.md) ^1.1.4
- [object.fromentries](https://npm.io/package/object.fromentries.md) ^2.0.8
- [array.prototype.map](https://npm.io/package/array.prototype.map.md) ^1.0.8
- [@npmcli/package-json](https://npm.io/package/@npmcli/package-json.md) ^6.0.0
- [array.prototype.flat](https://npm.io/package/array.prototype.flat.md) ^1.3.3
- [array.prototype.some](https://npm.io/package/array.prototype.some.md) ^1.1.6
- [array.prototype.filter](https://npm.io/package/array.prototype.filter.md) ^1.0.4
- [array.prototype.reduce](https://npm.io/package/array.prototype.reduce.md) ^1.0.8
- [array.prototype.flatmap](https://npm.io/package/array.prototype.flatmap.md) ^1.3.3
- [validate-exports-object](https://npm.io/package/validate-exports-object.md) ^1.0.3
- [string.prototype.endswith](https://npm.io/package/string.prototype.endswith.md) ^1.0.2
- [string.prototype.startswith](https://npm.io/package/string.prototype.startswith.md) ^1.0.1

## Alternatives

- [duck](https://npm.io/package/duck.md) — 4.2M weekly downloads
- [ava](https://npm.io/package/ava.md) — 560.2K weekly downloads
- [storybook-addon-module-mock](https://npm.io/package/storybook-addon-module-mock.md) — 71.7K weekly downloads
- [vest](https://npm.io/package/vest.md) — 50.1K weekly downloads
- [@ethereum-waffle/mock-contract](https://npm.io/package/@ethereum-waffle/mock-contract.md) — 40.0K weekly downloads

## Recent versions

- 2.3.0 (latest) — 2026-07-28
- 2.2.0 — 2026-02-10
- 2.1.0 — 2026-01-19
- 2.0.0 — 2026-01-14
- 1.1.0 — 2023-01-26
- 1.0.4 — 2020-10-22
- 1.0.3 — 2020-09-26
- 1.0.2 — 2020-08-18
- 1.0.1 — 2020-08-02
- 1.0.0 — 2020-05-25

## README

# list-exports <sup>[![Version Badge][npm-version-svg]][package-url]</sup>

[![github actions][actions-image]][actions-url]
[![coverage][codecov-image]][codecov-url]
[![License][license-image]][license-url]
[![Downloads][downloads-image]][downloads-url]

[![npm badge][npm-badge-png]][package-url]

Given a path to a package.json, what specifiers does it expose?

The package export defaults an `async function`. It takes a path to a `package.json` as the only required argument.

It fulfills with an object with the following structure:
  - `name` the package name
  - `version`: the package version
  - `engines`: the package's `engines` requirements
  - `problems`: a Set of strings describing problems or validation issues encountered during exports traversal. <sub>Note that these errors *do not* necessarily interfere with the listed entry points being accessible at runtime.</sub>
  - `exports`: an object with the following structure:
    - `binaries`: a Map of executable program names, to the relative file path that name will execute.
	- `latest`: a string describing the latest “[category][]” in the given node version range. This [category][] will be present in the following list.
	- `...categories`: each [category][] that the node version range overlaps will have an object with this structure:
	  - `import`: a Map of import specifier, to relative file path
	  - `require`: a Map of require specifier, to relative file path
	  - `files`: a Set of relative file paths that are included in `import` and/or `require`
	  - `tree`: a Map. Its keys are filenames (no leading `./`), whose values are a Set of `import` or `require` specifiers that point to it; or, directory names, whose values are a Map of the same recursive structure as `tree` itself.
	- `pre-exports`: this [category][] will always be present, whether it's in the above list or not, with the above structure.

In addition to the required `package.json` path, it also takes a second argument, an options object. This object supports the following properties:
 - `node`: either `true`, which reads the `engines.node` field in `package.json`, or a valid semver range of node versions to target. Defaults to the current node version.
 - `conditions`: either `true`, a string, or an array of strings specifying additional export conditions to recognize, similar to Node.js's `--conditions` flag. When `true`, auto-detects conditions from Node's `--conditions`/`-C` flag (via `process.execArgv` or `NODE_OPTIONS`). For example, `{ conditions: ['browser'] }` will include exports mapped to the `browser` condition.

## Conditions

This package tracks the conditions that Node.js recognizes in the `exports` field. Node.js supports the following conditions:

**Standard conditions (all categories with exports support):**
- `default` - Fallback condition, always evaluated last
- `node` - Matches when running in Node.js
- `require` - Matches for CommonJS `require()` calls
- `import` - Matches for ESM `import` statements/expressions

**Additional conditions (added in later versions):**
- `node-addons` - For native addon modules (added in v14.19/v16.10, `pattern-trailers` category and later)
- `module-sync` - For ESM files that can be synchronously required (added in v22.12, `require-esm` category and later)

**Conditions NOT recognized by Node.js by default** (commonly used but require bundlers/tooling):
- `browser` - For browser environments (handled by bundlers like webpack, Rollup)
- `types` - For TypeScript type definitions (handled by TypeScript)
- `development` / `production` - Environment-specific (handled by bundlers)
- Custom conditions - Any other condition names are ignored by Node.js unless explicitly enabled via `--conditions` flag

By default, `list-exports` matches Node.js behavior and skips conditions not recognized by the target Node.js version. To include additional conditions, use the `conditions` option (equivalent to Node.js's `--conditions` flag).

## Example

<details>
<summary>`const expected`:</summary>

```js
const expected = {
	name: 'list-exports',
	version: '1.1.0',
	engines: { node: '^18.17.0 || >=20.5.0' },
	problems: new Set(),
	exports: {
		binaries: {},
		latest: 'pattern-trailers-no-dir-slash',
		'pattern-trailers-no-dir-slash': {
			import: new Map([
				['.', './index.js'],
			]),
			require: new Map([
				['.', './index.js'],
				['./package.json', './package.json'],
			]),
			files: new Set([
				'./index.js',
				'./package.json',
			]),
			tree: new Map([
				['index.js', new Set(['.'])],
				['package.json', new Set(['./package.json'])],
			]),
		},
		'pre-exports': {
			import: new Map(),
			require: new Map([
				['.', './index.js'],
				['./', './index.js'],
				['./index', './index.js'],
				['./index.js', './index.js'],
				['./package', './package.json'],
				['./package.json', './package.json'],
			]),
			files: new Set([
				'./index.js',
				'./package.json',
			]),
			tree: new Map([
				['index.js', new Set([
					'.',
					'./',
					'./index.js',
					'./index',
				])],
				['package.json', new Set([
					'./package.json',
					'./package',
				])],
			]),
		},
	},
};
```
</details>

```js
const assert = require('assert');
const path = require('path');
const listExports = require('list-exports');

listExports('./package.json', { node: true }).then((data) => {
	assert.deepEqual(data, expected);
}).catch((e) => {
	console.error(e);
	process.exit(1);
});
```

[package-url]: https://npmjs.org/package/list-exports
[npm-version-svg]: https://versionbadg.es/ljharb/list-exports.svg
[deps-svg]: https://david-dm.org/ljharb/list-exports.svg
[deps-url]: https://david-dm.org/ljharb/list-exports
[dev-deps-svg]: https://david-dm.org/ljharb/list-exports/dev-status.svg
[dev-deps-url]: https://david-dm.org/ljharb/list-exports#info=devDependencies
[npm-badge-png]: https://nodei.co/npm/list-exports.png?downloads=true&stars=true
[license-image]: https://img.shields.io/npm/l/list-exports.svg
[license-url]: LICENSE
[downloads-image]: https://img.shields.io/npm/dm/list-exports.svg
[downloads-url]: https://npm-stat.com/charts.html?package=list-exports
[codecov-image]: https://codecov.io/gh/ljharb/list-exports/branch/main/graphs/badge.svg
[codecov-url]: https://app.codecov.io/gh/ljharb/list-exports/
[actions-image]: https://img.shields.io/github/check-runs/ljharb/list-exports/main
[actions-url]: https://github.com/ljharb/list-exports/actions
[category]: https://github.com/inspect-js/node-exports-info#categories

---
_Source: https://npm.io/package/list-exports · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._