JSTS - JavaScript Testability Score

This little CLI tool allows for assessing the testability of JS and TS files. It is based on the results of a master's thesis. It uses static code analysis to calculate metrics for files and implements a scoring system based on reference values for the metrics derived from the results of the thesis.

The tool outputs a score between 0 and 100 for each analyzed file, where a higher score means the file is more testable. It can additionally output scores and values for the computed code metrics.

Installation

You can install the tool in your project via NPM

``
npm i js-testability-score
`

Usage

Verify the installation by running the following command in your project directory
`
npx jsts --version
`
To get help run
`
npx jsts --help
`
The tool expects a path to a directory in which it should search for files to analyze. The path can be relative to your project directory or absolute.

Example of a relative path
`
npx jsts dir/subdir
`

Example of an absolute path
`
npx jsts C:/dir/project
`

To scan your whole project directory, use
`
npx jsts /
`

By default, the console output only contains scores for the analyzed files. You can additionally output scores for the computed metrics and their actual values by adding --metrics`. Make sure your console's width is sufficient to display the data.

Supported file types

> js, ts, cjs, mjs, es6, jsx, tsx, es