no-dead-code

Single command to reports unused exports in JS/TS files.

Supports both ES and CommonJS modules out of the box.

The target audience is developers working on refactoring large codebases. Not for script integration since the output is often inaccurate.

Usage

In a project's root, run:

``sh
$ npx no-dead-code
`

Example output

`
src/client/util/common.js: Unused exports: colors, CONFIG_NAME
src/client/pages/FeedbackTarget/tabs/Results/QuestionResults/utils.js: Unused exports: countAverage, countStandardDeviation, countMedian
`

Options

$3

Specify which extensions are included. Usually not needed.

Default: mjs cjs js ts tsx jsx

$3

Specify which paths are ignored.

By default, node_modules, .git, dist, build, migrations are always ignored. Values passed to -i are added to these.

You want to ignore files such as webpack, babel and eslint configs. Do not ignore js/tsconfig.

$3

Turn off the default ignores node_modules, .git, dist, build, migrations.

$3

Do not resolve node standard lib dependencies. They are hardcoded, see src/index.ts for the list which may be incomprehensive.

Dependencies starting with node: are always resolved.

$3

Do not resolve devDependencies in package.json.

Caveats

no-dead-code is far from complete, and should never be relied on blindly. The goal is to cover most typical coding standards, but it will inevitably output false positives and miss unused some exports.

$3

Import and export declarations work pretty well. Dynamic imports are considered to import just everything.

$3

Tracking all require-calls and module.exports assignments is a lot of effort, so only typical use cases are covered.

The following are seen by no-dead-code:
`js
module.exports = foo // sees "default" exported.

module.exports = { // "foo" and "bar" are seen exported
foo,
bar,
}

const foo = require('./foo') // everything imported from './foo'

const {
foo,
bar,
} = require('./foo') // "foo" and "bar" imported from './foo'

require('./foo')() // everything imported from './foo'

someFunction(require('./foo')) // everything imported from './foo'
`

$3

For absolute paths, the closest parent package.json and js/tsconfig are searched to resolve external dependencies and compilerOptions.baseUrl.

The config files are evaluated. Do not run this in a codebase that you do not trust.

$3

js/tsconfig paths are resolved correctly (I think).

In addition, a _moduleAliases` field in package.json is used to resolve path aliases.

Webpack path aliases = wontfix

Todo

- Formatted & colored output
- Deeper usage search