Makes it easy to select tests for local test runs

Usage no npm install needed!

<script type="module">
  import testsSelector from 'https://cdn.skypack.dev/tests-selector';


Tests Selector ·

CLI tool to select UI tests for execution.

tests-selector will parse your tests folder and provide a lost of features with tests inside. You can select any number of tests inside a feature.

npm downloads


$ npm install tests-selector --save-dev

Basic usage

Tests selector returns an array of selected tests paths. If you use framework like wdio or protractor that might not work for you. Tests selector also writes a file with the same array of selected tests, so you may read this file in your framework's config using getTestsFromFile method. Just run tests selector first. You may find examples in the repo.


const TestsSelector = require('tests-selector').;

if (require.main === module) {
  void async function () {
    const specsSelector = new TestsSelector({
      specsPath: `${process.cwd()}/test/specs`,
      specIdentifiers: ['spec', 'e2e'],
    await specsSelector.selectTests();


"scripts": {
    "test": "node specsSelector.js && wdio run wdio.conf.js"


specs: specsSelector.getTestsFromFile(),


  1. Supports any number of tests, just make subfolders.
  2. Remembers your choices. Just press enter a couple of times to run your previous tests.
  3. Filters your tests by preset identifier.
  4. Sets cursor to middle position for faster navigation.
  5. Press Esc ot Ctrl+C to go 1 directory back

Available options

Option Default Description
tempDataPath <root>/.testsSelector Directory to store temp files
specsPath <root>/specs Path to your tests folder
specIdentifiers ['spec'] Array of substrings to your test files. Tests selector will filter out all files in specsPath directory which don't have spec in their names
maxFilesInDir 10 By default if a directory has more than 10 files Tests selector will suggest you to go inside of subdirectory so you won't have to go through 100 tests in console. Note that this wI'll work only if directory has only subdirectories without test files
selectedTestsFileName selectedTests.generated File name where Tests selector writes tests paths you chose
testChoiceNumberFileName testChoiceNumber.indexHelper File name where Tests selector writes your tests choices
featureChoiceNumberFileName featureChoiceNumber.indexHelper File where Tests selector writes your feature choices

TestsSelector instance also provide


  • 1.0.0 - Initial release
  • 1.0.4 - Fix for absent dist
  • 1.0.9 - Added typings
  • 1.1.0 - Added getting selected tests from file method
  • 1.1.4 - optimized build
  • 1.1.5 - got rid of "default" when importing with JS
  • 1.1.6 - support for 0 nesting level tests
  • 1.1.7 - contributing guide
  • 2.0.0 - Go back feature


  • Create a personal fork of the project on Github.
  • Clone the fork on your local machine. Your remote repo on Github is called origin.
  • Add the original repository as a remote called upstream.
git remote add upstream https://github.com/Gennadiii/tests-selector
git remote -v
origin  https://github.com/username/tests-selector.git (fetch)
origin  https://github.com/username/tests-selector.git (push)
upstream        https://github.com/Gennadiii/tests-selector (fetch)
upstream        https://github.com/Gennadiii/tests-selector (push)
  • If you created your fork a while ago be sure to pull upstream changes into your local repository. git merge upstream/develop
  • Implement fix or feature.
  • Follow the code style of the project, including indentation.
  • Run tests from __spec__ folder (npm test).
  • Write or adopt tests as needed.
  • Make sure you didn't miss any tests (npm run test-coverage).
  • Add or change the documentation as needed.
  • Squash your commits.
  • Push your branch to your fork on Github, the remote origin.
  • From your fork open a pull request. Target the project's master.