# jest/release
Jest v30.5.0
importance: highmigrationfeature
This release introduces significant new features like `whenCalledWith` for mocks and describe-level retries, along with performance improvements and ESM fixes. It also includes a new file watcher implementation and updates to several dependencies.
affected
Users of Jest's mocking, ESM support, and file watching functionality may be affected by changes and should test their suites after upgrading.
action
Test your suite with `--no-watchman` to exercise the new crawler and watchers, and report any issues.
release_signals
+`whenCalledWith` for mock functions to configure return values per argument list
+Describe-level retries with `jest.retryTimes()`
+New file watcher implementation replacing `NodeWatcher` and `FSEventsWatcher`
+Snapshot failures now expose the `.snap` file path in `matcherResult.snapshotPath`
+`--collectTests` now expands `test.each`/`describe.each` cases and reports per-status counts
code_snippet
const fn = jest.fn();
fn.whenCalledWith('apple').mockReturnValue('red');
fn.whenCalledWith('banana').mockReturnValue('yellow');
fn.whenCalledWith(expect.any(Number)).mockReturnValue('numeric');
fn('apple'); // 'red'
fn('banana'); // 'yellow'
fn(42); // 'numeric'
fn('grape'); // undefined# community_signal
How useful is this release to your stack?
—
net score
Sign in with GitHub to cast your vote.
Sign in with GitHub to vote
You’ll return to this release, then choose your vote.