ts-prune

![Build](https://img.shields.io/github/workflow/status/nadeesha/ts-prune/Run%20CI%20Pipeline) ![npm](https://img.shields.io/npm/dm/ts-prune) ![GitHub issues](https://img.shields.io/github/issues-raw/nadeesha/ts-prune)

MIT 45 个版本

主页

仓库

提交 Issue

安装

npm install ts-prune

yarn add ts-prune

pnpm add ts-prune

bun add ts-prune

README

Build npm GitHub issues

ts-prune

Find potentially unused exports in your Typescript project with zero configuration.

Getting Started

ts-prune exposes a cli that reads your tsconfig file and prints out all the unused exports in your source files.

Installing

Install ts-prune with yarn or npm

# npm
npm install ts-prune --save-dev
# yarn
yarn add -D ts-prune

Usage

You can install it in your project and alias it to a npm script in package.json.

{
  "scripts": {
    "find-deadcode": "ts-prune"
  }
}

If you want to run against different Typescript configuration than tsconfig.json:

ts-prune -p tsconfig.dev.json

Examples

Configuration

ts-prune supports CLI and file configuration via cosmiconfig (all file formats are supported).

Configuration options

-p, --project - tsconfig.json path(tsconfig.json by default)
-i, --ignore - errors ignore RegExp pattern
-e, --error - return error code if unused exports are found
-s, --skip - skip these files when determining whether code is used. (For example, .test.ts? will stop ts-prune from considering an export in test file usages)

CLI configuration options:

ts-prune -p my-tsconfig.json -i my-component-ignore-patterns?

Configuration file example ts-prunerc:

{
  "ignore": "my-component-ignore-patterns?"
}

FAQ

How do I get the count of unused exports?

ts-prune | wc -l

How do I ignore a specific path?

ts-prune | grep -v src/ignore-this-path

How do I ignore a specific identifier?

You can either,

1. Prefix the export with `// ts-prune-ignore-next`

// ts-prune-ignore-next
export const thisNeedsIgnoring = foo;

2. Use `grep -v` to ignore a more widely used export name

ts-prune | grep -v ignoreThisThroughoutMyCodebase

Acknowledgements

The excellent ts-morph library. And this gist by @dsherret.

Contributors

_{Nadeesha Cabral}	_{Snyk bot}	_{Dan Vanderkam}	_{Vitaly Iegorov}	_{Amir Arad}	_{David Graham}
_{Davis Ford}	_{Ivo Raisr}	_{Josh Goldberg}	_{Kristján Oddsson}	_{Simon Jang}	_{The Gitter Badger}
_{Tim Saunders}	_{Torkel Rogstad}	_{William Candillon}	_phiresky