jest-watcher

What is jest-watcher?

The jest-watcher package is a part of the Jest ecosystem and is used to implement custom watch plugins for Jest. It provides an API to create plugins that can hook into Jest's watch mode, allowing developers to add custom watch behaviors to their test suites.

What are jest-watcher's main functionalities?

Custom Watch Plugins

This feature allows developers to create custom watch plugins that can react to file changes, determine if a test suite should run, and more. The code sample shows a basic structure of a custom watch plugin.

class MyCustomPlugin {
  apply(jestHooks) {
    jestHooks.onFileChange(({ projects }) => {
      console.log('Files changed:', projects[0].changedFiles);
    });
    jestHooks.shouldRunTestSuite(() => true);
  }
}

module.exports = MyCustomPlugin;

Interactive Watch Plugins

This feature allows the creation of interactive watch plugins that can provide custom interactive CLI interfaces during Jest's watch mode. The code sample demonstrates how to implement an interactive behavior that filters tests based on a pattern.

class MyInteractivePlugin {
  run(globalConfig, updateConfigAndRun) {
    // Implement interactive behavior here
    updateConfigAndRun({
      testNamePattern: 'pattern to filter tests'
    });
    return Promise.resolve();
  }
}

module.exports = MyInteractivePlugin;

Other packages similar to jest-watcher

mocha-watch

Mocha-watch is a watch mode for Mocha testing framework. It provides similar functionality to jest-watcher by re-running tests when file changes are detected. However, it is tailored for Mocha and does not offer the same plugin API for extending watch behavior.

karma

Karma is a test runner that works with multiple testing frameworks like Jasmine, Mocha, and QUnit. It can watch files and re-run tests on changes, similar to jest-watcher. Karma is more of a full-fledged test runner with a focus on running tests in different browsers, whereas jest-watcher is specifically for creating watch plugins in Jest.

ava

AVA is a test runner with built-in watch mode functionality. It automatically re-runs tests when it detects changes. AVA's watch mode is not plugin-based like jest-watcher, but it offers a simple and fast out-of-the-box solution for watching tests without the need for additional configuration.

README

The README file is missing

Changelog

29.6.2

Fixes

• [jest-circus] Fix snapshot matchers in concurrent tests when nr of tests exceeds maxConcurrency (#14335)
• [@jest/core] When running global setup and teardown, do not try to change the message property of the thrown error object when the message property is unwritable (#14113)
• [jest-snapshot] Move @types/prettier from dependencies to devDependencies (#14328)
• [jest-snapshot] Throw an explicit error if Prettier v3 is used (#14367)
• [jest-reporters] Add "skipped" and "todo" symbols to Github Actions Reporter (#14309)

Chore & Maintenance

• [@jest/core] Use pluralize from jest-util rather than own internal (#14322)