Skipped Tests Finder is a command-line tool that scans your project or test suites and identifies any skipped tests or test suites. It provides a convenient way to keep track of skipped tests and ensure that they are addressed before releasing your application.

Supported Languages & Frameworks:
- JavaScript/TypeScript: Jest, Mocha, Jasmine, Cypress, Playwright, Puppeteer
- Python: unittest, pytest, nose
- Ruby: RSpec, MiniTest
- Java: JUnit 4/5, TestNG
- C#: NUnit, MSTest, xUnit
- C++: Google Test, Catch2
- Go: Standard testing package
- PHP: PHPUnit
- Rust: Built-in test framework
- Swift: XCTest
- Kotlin: JUnit, Spek
- Scala: ScalaTest
- Dart: Built-in test framework
- Groovy: Spock
- Perl: Test::More
- Elixir: ExUnit
- Clojure: Built-in test framework
- Robot Framework: Robot Framework

And many more through generic comment patterns (SKIP, TODO, FIXME).

Note: this tool appears to struggle with scanning very large codebases in their entirety. If you encounter the error message The directory does not exist. Please enter a valid directory path. after running the script to scan your entire codebase, please rerun the tool, this time targeting either your test directory or the src folder specifically. Additionally, it's advisable to run the tool separately on different directories to segregate results for distinct types of test suites within your project. For instance, you might run this script to identify Jest tests located in ./src and Cypress tests in ./cypress/e2e separately.

Features

- Multi-language Support: Scans test files in 15+ programming languages
- Comprehensive Framework Coverage: Supports 50+ testing frameworks and patterns
- Recursive Scanning: Recursively scans directories and subdirectories
- Flexible File Types: Supports .js, .ts, .py, .rb, .java, .cs, .go, .cpp, .rs, .swift, .kt, .php, .dart, .pl, .ex, .clj, .robot and many more
- Rich Pattern Detection: Identifies various skip syntaxes like it.skip(), @unittest.skip(), @Ignore, #[ignore], t.Skip(), etc.
- Detailed Output: Shows test names, file paths, and line numbers
- Multiple Output Formats:
- Console: Rich, colorized terminal output with hierarchical display
- Text: Plain text file for simple reporting (skipped_tests.txt)
- JSON: Structured data format for integration with other tools (skipped_tests.json)
- Markdown: Formatted report with tables and code blocks (skipped_tests.md)
- Comment Pattern Detection: Finds TODO, FIXME, and SKIP comments in code

Installation

$3

- skipped-tests-finder requires NodeJS 10 (or higher) to be installed

$3

``sh
npm install -g skipped-tests-finder
`

This will install the tool globally on your system, making it available from any directory.

1. Clone this repository:

`sh
git clone https://github.com/Sharma-IT/skipped-tests-finder.git
`

2. Change into this respository's directory:

`sh
cd skipped-tests-finder
`

$3

3. To install skipped-tests-finder globally on Linux-based Operating Systems (including macOS), run:

`bash
./scripts/install.sh
`

This will make the tool accessible from anywhere by running skipped-tests-finder.

$3

3. To install skipped-tests-finder globally on Windows, run PowerShell as Administrator and execute:

`powershell
.\scripts\install.ps1
`

This will make the tool accessible from anywhere by running skipped-tests-finder. You may need to restart your terminal for the changes to take effect.

Uninstallation

$3

If you installed via npm:

`sh
npm uninstall -g skipped-tests-finder
`

$3

#### For Linux/macOS

`bash
./scripts/uninstall.sh
`

#### For Windows

Run PowerShell as Administrator and execute:

`powershell
.\scripts\uninstall.ps1
`

Usage

1. Install skipped-tests-finder using the instructions above.
2. From any directory in your terminal, run:
`sh
skipped-tests-finder
`
3. Upon execution, the script will request the path to your tests directory. You have the option to input the path after initiating the script or beforehand using the -d argument. For example, skipped-tests-finder -d=projects/project_name/cypress/e2e.
4. Following that, the script will inquire whether you wish to save the results to a text file. Respond with either "y" or "n" as appropriate, "y" will save the results to a text file (skipped_tests.txt) and "n" will print the results in your console. If you choose "y", you'll be prompted to enter the file path where you want the text file to be created. Leaving this blank will create the output in the same directory as the tests.
5. Alternatively, you can bypass this prompt by utilising the following arguments when executing the script:
- -cli: Display the results directly in your console
- -f=text: Generate a plain text file named skipped_tests.txt in the same directory as your tests
- -f=json: Generate a JSON file named skipped_tests.json with structured test data
- -f=markdown: Generate a Markdown report named skipped_tests.md with formatted results
- -o=: Override the output directory for the output file (optional)
- -d=: Specify the directory to scan for skipped tests (e.g., skipped-tests-finder -d=projects/project_name/cypress/e2e)
- -txt: Legacy format flag (same as -f=text) for backward compatibility

6. The script will proceed to scan your test directory and its subdirectories to identify skipped tests. Subsequently, it will print the results in the console or write them into the skipped_tests.txt file, depending on your choice.

$3

`
Usage: skipped-tests-finder [options] -d=[]

Options:

-d= Path to the directory to search for skipped tests
-f= Output format: text, json, markdown (default: text)
--format= Same as -f (alternative syntax)
-cli Output the results to the terminal (default behavior)
-o= Path to the directory for file output
-txt Legacy flag (same as -f=text) for backward compatibility
-h, --help Display this help message
`

$3

Basic console output:
`bash
skipped-tests-finder -d=./tests -cli
`

Generate text file:
`bash
skipped-tests-finder -d=./tests -f=text
`

Generate JSON report:
`bash
skipped-tests-finder -d=./tests -f=json
`

Generate Markdown report:
`bash
skipped-tests-finder -d=./tests -f=markdown
`

Custom output directory:
`bash
skipped-tests-finder -d=./tests -f=markdown -o=./reports
`

Legacy format (backward compatibility):
`bash
skipped-tests-finder -d=./tests -txt
`

$3

Console Output:
`
══════════════════════════════════════════════════════════════════════
SKIPPED TESTS FINDER - SCAN RESULTS
══════════════════════════════════════════════════════════════════════

⚠️ FOUND SKIPPED TESTS
Total: 3 skipped tests

📊 BREAKDOWN BY LANGUAGE:
• JavaScript: 2 tests
• Python: 1 test

📋 DETAILED RESULTS:

JavaScript (2 tests)
────────────────────
├── should skip this test
│ 📁 test.spec.js:10
└── another skipped test
📁 test.spec.js:25

Python (1 test)
────────────────────
└── test with reason
📁 test_sample.py:15
`

JSON Output (skipped_tests.json):
`json
{
"totalSkippedTests": 3,
"filesWithSkippedTests": 2,
"generatedAt": "2025-06-30T10:30:00.000Z",
"summary": {
"test.spec.js": {
"filePath": "/path/to/test.spec.js",
"skippedTestsCount": 2,
"tests": [
{
"testName": "should skip this test",
"lineNumber": 10,
"line": "it.skip('should skip this test', () => {})",
"reason": null
}
]
}
}
}
`

Markdown Output (skipped_tests.md):
`markdown


Skipped Tests Report

Generated: 30/06/2025, 10:30:00 am

Summary

- Total Skipped Tests: 3
- Files with Skipped Tests: 2

Summary by File

| File | Skipped Tests | Language |
|------|---------------|----------|
| test.spec.js | 2 | JavaScript |
| test_sample.py | 1 | Python |

Detailed Results

$3

File: /path/to/test.spec.js

Skipped Tests: 2

#### 1. should skip this test

- Line: 10
- Code:

`javascript
it.skip('should skip this test', () => {})
`

Project Structure

The project has been organized into a modular structure for better maintainability:

`
skipped-tests-finder/
├── src/
│ ├── cli.js # Main CLI entry point
│ ├── core/
│ │ ├── scanner.js # Core scanning logic
│ │ ├── patterns.js # Test framework patterns
│ │ └── utils.js # Utility functions
│ └── output/
│ ├── console.js # Console output formatting
│ └── file.js # File output handling
├── scripts/
│ ├── install.sh # Linux/macOS installation
│ ├── install.ps1 # Windows installation
│ ├── uninstall.sh # Linux/macOS uninstallation
│ └── uninstall.ps1 # Windows uninstallation
├── tests/
│ ├── fixtures/ # Test files for testing
│ └── *.test.js # Unit tests
├── docs/
│ ├── api.md # API documentation
│ └── examples/ # Usage examples
├── bin/
│ └── skipped-tests-finder # CLI executable
└── package.json
`

Development

$3

`bash


Clone the repository

git clone https://github.com/Sharma-IT/skipped-tests-finder.git
cd skipped-tests-finder

Run directly

node src/cli.js -d=./tests

Or use npm script

npm start -- -d=./tests
`

$3

`bash


Run tests


npm test
``

Contributing

Pull requests are welcomed. For major changes, please open an issue first to discuss what you would like to change.

Contact

Shubham Sharma - My LinkedIn - shubhamsharma.emails@gmail.com.

License

This project is licensed under the GPL 3.0 License - see the LICENSE file for details.