@jest/transform

Features

• expect: Enhancing the toHaveProperty matcher to support array selection

• jest-core: Add support for testResultsProcessor written in ESM

• jest-diff, pretty-format: Add compareKeys option for custom sorting of object keys

• jest-mock: Add ts-jest mock util functions

Fixes

• expect: Allow again expect.Matchers generic with single value

• jest-circus, jest-jasmine2: Avoid false concurrent test failures due to unhandled promise rejections

• jest-config: Add missing slash dependency to package.json

• jest-core: Incorrect detection of open ZLIB handles

• jest-diff: Break dependency cycle

• jest-environment-jsdom: Add @types/jsdom dependency

• jest-environment-jsdom: Do not reset the global.document too early on teardown

• jest-transform: Improve error and warning messages

• jest-worker: Pass execArgv correctly to worker_threads worker

Fixes

• expect: Make expect extension properties configurable

• expect: Fix .any() checks on primitive wrapper classes

Features

• jest-config: Add testEnvironmentOptions.html to apply to jsdom input

• jest-resolver: Support default export (.) in exports field if main is missing

Fixes

• expect: Tweak and improve types

• jest-runtime: Ensure absolute paths can be resolved within test modules

• jest-runtime: Fix instanceof for ModernFakeTimers and LegacyFakeTimers methods

Features

• jest-config: Warn when multiple Jest configs are located

Fixes

• expect: Pass matcher context to asymmetric matchers (#11926 & #11930)

• expect: Improve TypeScript types

• expect: Improve typings of toThrow() and toThrowError() matchers

• jest-cli: Improve --help printout by removing defunct --browser option

• jest-haste-map: Use distinct cache paths for different values of computeDependencies

• @jest/reporters: Do not buffer console.logs when using verbose reporter

Chore & Maintenance

• deprecated

  @jest/types: Mark deprecated configuration options as @deprecated

Fixes

• jest-config: Parse testEnvironmentOptions if received from CLI

• jest-reporters: Call destroy on v8-to-istanbul converters to free memory

Features

• jest-transform: Improve the unexpected token error message.

Fixes

• jest-runtime: Fix regression when using jest.isolateModules and mocks

• jest-runtime: Include test name when importing modules after test has completed

• jest-runtime: Error when ESM import is used after test is torn down

Features

• jest-resolver, jest-runtime: Pass conditions to custom resolvers to enable them to implement support for package.json exports field

• jest-runtime: Allow custom envs to specify exportConditions which is passed together with Jest's own conditions to custom resolvers

Fixes

• @jest/reporters: Use async transform if available to transform files with no coverage

• jest-util: Return correct value from process.send stub

Features

• jest-haste-map: Use watchman suffix-set option for faster file indexing.

• jest-cli: Adds a new config options snapshotFormat which offers a way to override any of the formatting settings which come with pretty-format.

• jest-reporters: Expose the getSummary util (#11695).

• jest-resolver: Support node: prefix when importing Node core modules

Fixes

• jest-each: Relaxed the validation to allow multibyte characters in headings

• jest-environment-jsdom: Add support for userAgent option

• jest-environment-node: Add Event and EventTarget to node global environment.

• jest-mock: Fix spyOn to use Object.prototype.hasOwnProperty

• jest-resolver: Add dependency on jest-haste-map

• jest-types: Compat with @types/node v16

Features

• @jest/fake-timers: Flush callbacks scheduled with requestAnimationFrame every 16ms when using legacy timers.

• pretty-format: Use globalThis (with polyfill if required) to bring support for esbuild's browser bundling mode (#11569

Fixes

• jest-core: Support special characters like @, + and () on Windows with --findRelatedTests

• @jest/fake-timers: Do not add setImmediate and clearImmediate if they do not exist in the global environment

• @jest/reporters: Allow node-notifier@10 as peer dependency

• @jest/reporters: Update v8-to-istanbul

Features

• jest-circus: Add some APIs to make it easier to build your own test runner

• jest-reporters: Expose the getResultHeader util

• jest-resolver: Export resolve* utils for different Jest modules

• @jest/test-result: Export Test, TestEvents and TestFileEvent

Fixes

• jest-circus: Add missing slash dependency

• jest-circus, @jest/test-sequencer: Remove dependency on jest-runner

• jest-config: Resolve config.runner to absolute path

• jest-config: Make sure to support functions as config

• jest-core: Do not warn about DNSCHANNEL handles when using the --detectOpenHandles option

• jest-runner: Remove dependency on jest-config

• jest-worker: Loosen engine requirement to >= 10.13.0

Blog post

Features

• babel-jest: Add async transformation

• jest-changed-files: Use '--' to separate paths from revisions

• breaking

  jest-circus: Fail tests when multiple done() calls are made

• breaking

  jest-circus, jest-jasmine2: Fail the test instead of just warning when describe returns a value

• breaking

  jest-config: Default to Node testing environment instead of browser (JSDOM)

• breaking

  jest-config: Use jest-circus as default test runner

• jest-config: Add support for preset written in ESM

• jest-config, jest-runtime: Support ESM for files other than .js and .mjs

• breaking

  jest-config, jest-runtime: Use "modern" implementation as default for fake timers (#10874 & #11197)

• [jest-config Allow passing forceNodeFilesystemAPI through to jest-haste-map

• breaking

  [jest-config, jest-haste-map, jest-resolve, jest-runner, jest-runtime, jest-test-sequencer, jest-transform, jest-types] Add custom HasteMap class implementation config option

• jest-core: Make TestWatcher extend emittery

• jest-core: Run failed tests interactively the same way we do with snapshots

• jest-core: More TestSequencer methods can be async

• jest-core: Add support for testSequencer written in ESM

• jest-core: Add support for globalSetup and globalTeardown written in ESM

• jest-core: Add support for watchPlugins written in ESM

• jest-core: Add support for runner written in ESM

• jest-core: Add support for reporters written in ESM

• jest-each: Add support for interpolation with object properties

• jest-environment-node: Add AbortController to globals

• @jest/fake-timers: Update to @sinonjs/fake-timers to v7

• jest-haste-map: Handle injected scm clocks

• jest-haste-map: Add enableSymlinks configuration option to follow symlinks for test files

• breaking

  jest-repl, jest-runner: Run transforms over environment

• jest-repl: Add support for testEnvironment written in ESM

• breaking

  jest-runner: Set exit code to 1 if test logs after teardown

• breaking

  jest-runner: Run transforms over runnner

• breaking

  jest-runner: Run transforms over testRunnner

• jest-runner: Possibility to use ESM for test environment (11033)

• jest-runner: Add support for testRunner written in ESM

• jest-runtime: Detect reexports from CJS as named exports in ESM

• jest-runtime: Support for async code transformations (#11191 & #11220)

• jest-reporters: Add static filepath property to all reporters

• breaking

  jest-snapshot: Make prettier optional for inline snapshots - fall back to string replacement (#7792 & #11192)

• breaking

  jest-snapshot: Run transforms over snapshotResolver

• jest-transform: Pass config options defined in Jest's config to transformer's process and getCacheKey functions

• jest-transform: Add support for transformers written in ESM

• breaking

  jest-transform: Do not export ScriptTransformer class, instead export the async function createScriptTransformer

• jest-transform: Async code transformations

• jest-transform: Support transpiled transformers

• breaking

  jest-transform: requireAndTranspileModule always return a Promise, and the third parameter type is changed to RequireAndTranspileModuleOptions which accept applyInteropRequireDefault option

• breaking

  jest-transform: createTranspilingRequire return function which return a Promise now

• jest-util: Add requireOrImportModule for importing CJS or ESM

• jest-util: Add applyInteropRequireDefault option on requireOrImportModule

• jest-watcher: Added support for clearing the line when <C-u> is pressed in a watch mode pattern prompt

• jest-worker: Add support for custom task queues and adds a PriorityQueue implementation.

• jest-worker: Add in-order scheduling policy to jest worker (10902)

• pretty-format: Better print for sparse arrays (11326)

• pretty-print: Add option printBasicPrototype which determines whether or not the prototype should be printed for raw objects or arrays

Fixes

• babel-plugin-jest-hoist: Add __dirname and __filename to whitelisted globals

• breaking

  expect: Revise expect.not.objectContaining() to be the inverse of expect.objectContaining(), as documented.

• breaking

  expect: Make toContain more strict with the received type (#10119 & #10929)

• breaking

  expect: matcherResult on JestAssertionError are now strings rather than functions

• jest-circus: Fixed the issue of beforeAll & afterAll hooks getting executed even if it is inside a skipped describe block #10451

• jest-circus: Fix testLocation on Windows when using test.each

• jest-cli: Use testFailureExitCode when bailing from a failed test

• jest-cli: Print custom error if error thrown from global hooks is not an error already

• jest-cli: Allow running multiple "projects" from programmatic API

• jest-cli: Fix missing collectCoverage after init

• jest-cli, jest-config, jest-types: Move all default values into jest-config

• breaking

  jest-config: Change default file extension order by moving json behind ts and tsx (10572)

• jest-console: console.dir now respects the second argument correctly

• jest-core: Don't report PerformanceObserver as open handle

• jest-core: Use WeakRef to hold timers when detecting open handles

• jest-core: Correctly detect open handles that were created in test functions using done callbacks

• jest-core: Do not collect RANDOMBYTESREQUEST as open handles

• jest-core: Wait briefly for open handles to close before flagging them when using --detectOpenHandles

• breaking

  jest-diff: Use only named exports

• breaking

  jest-each: Ignore excess words in headings

• jest-each: Support array index with template strings

• jest-each: Interpolate %% correctly

• jest-each: Fix wrong interpolation when the value of array contains multiple %

• breaking

  jest-environment: Drop support for runScript for test environments

• jest-environment-jsdom: Use inner realm’s ArrayBuffer constructor

• breaking

  jest-environment-jsdom: Remove Node globals setImmediate and clearImmediate #11222

• breaking

  jest-get-type: Convert to ES Module

• breaking

  jest-globals: Disallow return values other than a Promise from hooks and tests

• breaking

  jest-globals: Disallow mixing a done callback and returning a Promise from hooks and tests

• jest-haste-map: Vendor NodeWatcher from sane

• jest-jasmine2: Fixed the issue of beforeAll & afterAll hooks getting executed even if it is inside a skipped describe block when it has child tests marked as either only or todo #10451

• jest-jasmine2: Fixed the issues of child tests marked with only or todo getting executed even if it is inside a skipped parent describe block #10451

• jest-jasmine2: Wrap all test functions so they open handles that were created in test functions using done callbacks can be detected

• jest-reporter: Handle empty files when reporting code coverage with V8

• jest-resolve: Replace read-pkg-up with escalade package

• jest-resolve: Disable jest-pnp-resolver for Yarn 2

• breaking

  jest-runtime: Do not inject global variable into module wrapper

• breaking

  jest-runtime: Remove long-deprecated jest.addMatchers, jest.resetModuleRegistry, and jest.runTimersToTime

• jest-runtime: Fix stack overflow and promise deadlock when importing mutual dependant ES module

• jest-runtime: Prevent global module registry from leaking into isolateModules registry

• jest-runtime: Refactor to prevent race condition when linking and evaluating ES Modules

• jest-runtime: Throw correct error when attempting to load ESM via require

• jest-runtime: Do not cache modules that throw during evaluation

• jest-transform: Show enhanced SyntaxError message for all SyntaxErrors

• breaking

  jest-transform: Refactor API to pass an options bag around rather than multiple boolean options

• breaking

  jest-transform: Refactor API of transformers to pass an options bag rather than separate config and other options

• jest-types: Fix Config.ts projects types

• jest-util: Replace micromatch with picomatch to fix issues with negated globs

• jest-validate: Use en-US locale to avoid case conversion problems while validating CLI options on machines with some certain locales(e.g. Turkish) set as default locale.

• breaking

  jest-worker: Use named exports

• jest-worker: Do not swallow errors during serialization

• jest-worker: Handle ERR_IPC_CHANNEL_CLOSED errors properly

• breaking

  pretty-format: Convert to ES Modules

• pretty-format: Only call hasAttribute if it's a function

• pretty-format: Handle jsdom attributes properly

• pretty-format: Import pretty-format using named imports

Chore & Maintenance

• breaking

  *: Only support Node LTS releases and Node 15

• breaking

  *: Add exports field to all package.jsons

• breaking

  *: Remove deprecated mapCoverage

• breaking

  babel-jest: Migrate to ESM

• breaking

  jest, jest-core: Replace TestScheduler export with createTestScheduler

• breaking

  jest-config: Remove enabledTestsMap config, use filter instead

• breaking

  jest-console: Move root into config and take GlobalConfig as mandatory parameter for getConsoleOutput

• breaking

  jest-haste-map: Migrate to ESM

• breaking

  jest-haste-map: Remove support for deprecated option ignorePattern as function

• breaking

  jest-jasmine2: Migrate to ESM

• breaking

  jest-jasmine2: Remove unused options argument from Env constructor

• breaking

  jest-repl, jest-runtime: Move the jest-runtime CLI into jest-repl (#10016 & #10925)

• breaking

  jest-resolve: Migrate to ESM

• breaking

  jest-resolve-dependencies: Migrate to ESM

• breaking

  jest-mock: Migrate to ESM

• breaking

  jest-reporters: Make node-notifier a peer dependency

• breaking

  jest-resolve, jest-runtime: Use Maps instead of objects for all cached resources

• breaking

  jest-runner: Migrate to ESM

• breaking

  jest-runtime: Remove deprecated and unused getSourceMapInfo from Runtime

• breaking

  jest-transformer: Remove unused isCoreModule option

• breaking

  jest-validate: Remove recursiveBlacklist option in favor of previously introduced recursiveDenylist

Performance

• jest-resolve: Cache reading and parsing of package.jsons

• jest-runtime, jest-transform: Share cacheFS between runtime and transformer

• jest-runtime: Load chalk only once per worker

• jest-worker: Fix memory leak of previous task arguments while no new task is scheduled

Features

• jest-core: Add findRelatedTests and nonFlagArgs in allowed config options for updateConfigAndRun in watch plugins

Fixes

• babel-plugin-jest-hoist: Preserve order of hoisted mock nodes within containing block

• babel-plugin-jest-hoist: Hoist pure constants to support experimental JSX transform in hoisted mocks

• babel-preset-jest: Update babel-preset-current-node-syntax to support top level await

• expect: Revert "Fix objectContaining to work recursively into sub-objects (#10508)"

• jest-circus, jest-jasmine2: Don't assume stack is always a string

• jest-config: Fix bug introduced in watch mode by PR #10678

• jest-config: Throw correct error for missing preset modules

• jest-resolve-dependencies: Resolve mocks as dependencies

• jest-runtime: Handle file URLs in dynamic imports

• jest-runtime, babel-jest: Pass more ESM options to @jest/transform

• jest-runtime: Properly inject extraGlobals into the runtime

• jest-transform: Link to ESM docs on syntax errors

Features

• jest-runtime: Support named exports from CommonJS as named ES Module imports

• jest-validate: Add support for recursiveDenylist option as an alternative to recursiveBlacklist

Fixes

• expect: Fix objectContaining to work recursively into sub-objects

• jest-cli, jest-core, jest-config, jest-types: Fix --onlyFailures flag to work in non-watch mode

• jest-config: Fix for the jest.config.ts compiler to not interfere with tsconfig.json files

• jest-message-util: Update to work properly with Node 15

• jest-mock: Allow to mock methods in getters (TypeScript 3.9 export)

Features

• jest-cli, jest-config: Add support for the jest.config.ts configuration file

Fixes

• jest-config: Simplify transform RegExp

• jest-fake-timers: Lazily instantiate mock timers

• jest-runtime: require.main is no longer undefined when using jest.resetModules

• @jest/types: Add missing values for timers

Features

• jest-circus, jest-config, jest-runtime: Add new injectGlobals config and CLI option to disable injecting global variables into the runtime

• jest-each: Fixes .each type to always be callable

• jest-runner: Add support for moduleLoaders with default exports

• @jest/create-cache-key-function: Added a new package for creating cache keys

Fixes

• jest-circus, jest-jasmine2: Find correct location for test.each tests

• jest-console: Add Console constructor to console object

• jest-globals: Fix lifecycle hook function types

• jest-runtime: Remove usage of vm.compileFunction due to a performance issue

Features

• jest-circus, jest-jasmine2: Include failureDetails property in test results

• jest-each, jest-jasmine, jest-circus: Add support for .concurrent.each

Fixes

• jest-config: Add .pnp.js to transformIgnorePatterns defaults

• jest-leak-detector: Wait properly for GC runs due to changes in Node 14.7

• breaking

  jest-worker: Downgrade minimum node version to 10.13

Features

• [jest-core, jest-circus, jest-reporter, jest-runner] Added support for reporting individual test cases using jest-circus

• [jest-config, jest-reporter, jest-runner, jest-test-sequencer] Add slowTestThreshold configuration option

• jest-haste-map: Watchman crawler now includes dotfiles

• jest-worker: Added support for workers to send custom messages to parent in jest-worker

• jest-worker: Support passing resourceLimits

• pretty-format: Added support for serializing custom elements (web components)

Fixes

• expect: Match symbols and bigints in any()

• jest-changed-files: Use git diff instead of git log for --changedSince

• jest-console: Add missing console.timeLog for compatibility with Node

• jest-haste-map: Check find binary supports the -iname parameter

• jest-snapshot: Strip added indentation for inline error snapshots

Features

• jest-mock: Export Mock, MockInstance, SpyInstance types

• jest-config: Support config files exporting (async) functions

• jest-cli, jest-core: Add --selectProjects CLI argument to filter test suites by project name

• jest-cli, jest-init: Add coverageProvider to jest --init prompts

Fixes

• jest-console: getConsoleOutput to receive global stack trace config and use it to format stack trace

• jest-jasmine2: Stop adding : after an error that has no message

• jest-diff: Control no diff message color with commonColor in diff options

• jest-snapshot: Fix TypeScript compilation

Performance

• jest-core, jest-transform, jest-haste-map: Improve Jest startup time and test runtime, particularly when running with coverage, by caching micromatch and avoiding recreating RegExp instances

Features

• breaking

  jest-environment-jsdom: Upgrade jsdom to v16

• @jest/fake-timers: Add possibility to use a modern implementation of fake timers, backed by @sinonjs/fake-timers

• jest-runtime: Add createMockFromModule as an alias for genMockFromModule

Fixes

• babel-jest: Handle null being passed to createTransformer

• [jest-circus, jest-console, jest-jasmine2, jest-reporters, jest-util, pretty-format] Fix time durating formatting and consolidate time formatting code

• breaking

  jest-circus: Fail tests if a test takes a done callback and have return values

• breaking

  jest-circus: Throw a proper error if a test / hook is defined asynchronously

• jest-circus: Throw more descriptive error if hook is defined inside test

• breaking

  jest-circus: Align execution order of tests to match jasmine's top to bottom order

• breaking

  jest-config, jest-resolve: Remove support for browser field

• jest-haste-map: Stop reporting files as changed when they are only accessed

• jest-resolve: Show relative path from root dir for module not found errors

• jest-runtime: Fix absolute path moduleNameMapper + jest.mock bug

Chore & Maintenance

• breaking

  *: TypeScript definitions requires a minimum of TypeScript v3.8

• breaking

  *: Drop support for Node 8

• breaking

  expect, jest-mock, pretty-format: Remove build-es5 from package

• breaking

  @jest/fake-timers, @jest/environment: Rename LolexFakeTimers to ModernFakeTimers

• breaking

  jest-haste-map: Removed providesModuleNodeModules

• breaking

  jest-runtime: Remove long-deprecated require.requireActual and require.requireMock methods

Features

• @jest/globals: New package so Jest's globals can be explicitly imported

• jest-core: Show coverage of sources related to tests in changed files

• jest-runtime: Populate require.cache

Fixes

• *: Use graceful-fs directly in every package instead of relying on fs being monkey patched

• expect: Prints the Symbol name into the error message with a custom asymmetric matcher

• jest-circus, jest-jasmine2: Support older version of jest-runtime (#9903 & #9842)

• @jest/environment: Make sure not to reference Jest types

• jest-message-util: Code frame printing should respect --noStackTrace flag

• jest-runtime: Support importing CJS from ESM using import statements

• jest-runtime: Support importing parallel dynamic imports

• jest-transform: Improve source map handling when instrumenting transformed code

Performance

• jest-resolve: Update resolve to a version using native realpath, which is faster than the default JS implementation

• jest-resolve: Pass custom cached realpath function to resolve

• jest-runtime: Add teardown method to clear any caches when tests complete

• jest-runtime: Do not pass files required internally through transformation when loading them

• jest-runtime: Use Maps instead of object literals as cache holders

• expect: Support async functions in toThrow

• jest-console: Add code frame to console.error and console.warn

• jest-runtime, jest-jasmine2, jest-circus: Experimental, limited ECMAScript Modules support (#9772 & #9842)

Fixes

• expect: Restore support for passing functions to toHaveLength matcher

• jest-changed-files: --only-changed should include staged files

• jest-circus: Throw on nested test definitions

• jest-each: each will throw an error when called with too many arguments

• jest-runner: Don't print warning to stdout when using --json

Features

• babel-jest: Support passing supportsDynamicImport and supportsStaticESM

• babel-preset-jest: Enable all syntax plugins not enabled by default that works on current version of Node

• jest-circus: Enable writing async test event handlers

• jest-runtime, @jest/transformer: Support passing supportsDynamicImport and supportsStaticESM

Features

• jest-config: Support ESM config files with .js extension (#9573).

• jest-runtime: Override module.createRequire to return a Jest-compatible require function

• breaking

  jest-haste-map: Remove mapper option

• *: Support array of paths for moduleNameMapper aliases

• jest-reporters: Adds ability to pass options to the istanbul-reporter through coverageReporters

• jest-runtime: Require stack when a module cannot be resolved

• jest-transform: writeCacheFile no longer calls fsync

Fixes

• expect: Handle readonly properties correctly

• jest-cli: Set coverageProvider correctly when provided in config

• jest-cli: Allow specifying .cjs and .mjs config files by --config CLI option

• jest-cli: Update yargs to fix CLI flag overriding

• jest-config: Treat setupFilesAfterEnv like setupFiles when normalizing configs against presets

• jest-config: Support .mjs config files on Windows as well

• jest-config: Verify rootDir and all roots are directories

• jest-config: Ensure pattern of replacePosixSep is a string

• jest-haste-map: Fix crash on unix based systems without find

• jest-jasmine2: Fix --testNamePattern matching with concurrent tests

• jest-matcher-utils: Fix diff highlight of symbol-keyed object.

• @jest/reporters: Notifications should be fire&forget rather than having a timeout

• jest-resolve: Fix module identity preservation with symlinks and browser field resolution

• jest-resolve: Do not confuse directories with files

• jest-resolve: moduleNameMapper should take precedence over Node core modules

• jest-runtime: Reset isolateModules if it fails

• jest-runtime: Yarn PnP errors displayed to the user

• jest-snapshot: Downgrade semver to v6 to support node 8

• jest-snapshot: Properly indent new snapshots in the presences of existing ones

• jest-transform: Correct sourcemap behavior for transformed and instrumented code

• jest-transform: Allow instrumentation of transformed files with weird file extensions

• @jest/types: Make ConfigGlobals an interface to allow for declaration merging.

• pretty-format: Export OldPlugin type

Performance

• jest-haste-map: Reduce number of lstat calls in node crawler

Features

• babel-plugin-jest-hoist: Show codeframe on static hoisting issues

• babel-plugin-jest-hoist: Add BigInt to ALLOWED_IDENTIFIERS

• babel-preset-jest: Add @babel/plugin-syntax-bigint

• expect: Add BigInt support to toBeGreaterThan, toBeGreaterThanOrEqual, toBeLessThan and toBeLessThanOrEqual

• expect, jest-matcher-utils: Display change counts in annotation lines

• expect, jest-snapshot: Support custom inline snapshot matchers

• jest-config: Throw the full error message and stack when a Jest preset is missing a dependency

• breaking

  jest-config: Set default display name color based on runner

• jest-config: Merge preset globals with project globals

• jest-config: Support .cjs config files

• breaking

  jest-config: Support .mjs config files

• jest-core: Support reporters as default exports

• jest-core: Support --findRelatedTests paths case insensitivity on Windows

• jest-diff: Add options for colors and symbols

• breaking

  jest-diff: Export as ECMAScript module

• jest-diff: Add includeChangeCounts and rename Indicator options

• jest-diff: Add changeColor and patchColor options

• jest-diff: Add trailingSpaceFormatter option and replace cyan with commonColor

• jest-diff: Add firstOrLastEmptyLineReplacement option and export 3 diffLines functions

• jest-environment: Add optional getVmContext next to runScript (#9252 & #9428)

• jest-environment-jsdom: Add fakeTimersLolex

• jest-environment-node: Add fakeTimersLolex

• jest-environment-node: Add queueMicrotask

• jest-environment-node: Implement getVmContext (#9252 & #9428)

• @jest/fake-timers: Add Lolex as implementation of fake timers

• jest-get-type: Add BigInt support.

• jest-matcher-utils: Add BigInt support to ensureNumbers ensureActualIsNumber, ensureExpectedIsNumber

• jest-matcher-utils: Ignore highlighting matched asymmetricMatcher in diffs

• jest-reporters: Export utils for path formatting

• jest-reporters: Provides global coverage thresholds as watermarks for istanbul

• jest-runner: Warn if a worker had to be force exited

• breaking

  jest-runtime: Do not export ScriptTransformer - it can be imported from @jest/transform instead

• jest-runtime: Use JestEnvironment.getVmContext and vm.compileFunction if available to avoid the module wrapper (#9252 & #9428)

• jest-snapshot: Display change counts in annotation lines

• breaking

  jest-snapshot: Improve report when the matcher has properties

• jest-snapshot: Improve colors when snapshots are updatable

• jest-snapshot: Ignore indentation for most serialized objects

• jest-transform: Create createTranspilingRequire function for easy transpiling modules

• breaking

  jest-transform: Return transformed code as a string, do not wrap in vm.Script

• @jest/test-result: Create method to create empty TestResult

• breaking

  jest-worker: Return a promise from end(), resolving with the information whether workers exited gracefully

• jest-reporters: Transform file paths into hyperlinks

Fixes

• expect: Display expectedDiff more carefully in toBeCloseTo

• expect: Avoid incorrect difference for subset when toMatchObject fails

• expect: Consider all RegExp flags for equality

• breaking

  expect: Consider primitives different from wrappers instantiated with new

• expect: Prevent maintaining RegExp state between multiple tests

• expect: Fix subsetEquality false circular reference detection

• jest-config: Use half of the available cores when watchAll mode is enabled

• jest-config: Fix Jest multi project runner still cannot handle exactly one project

• jest-console: Add missing console.group calls to NullConsole

• jest-core: Don't include unref'd timers in --detectOpenHandles results

• jest-core: Limit number of workers when creating haste maps in projects

• jest-diff: Do not inverse format if line consists of one change

• jest-diff: Rename some new options and change their default values

• jest-environment-node: Fix TextEncoder.encode not referencing same global Uint8Array constructor

• jest-fake-timers: getTimerCount will not include cancelled immediates

• jest-fake-timers: Support util.promisify on setTimeout

• jest-jasmine2, jest-circus: Improve error message format for Node's assert.fail

• breaking

  jest-leak-detector: Use weak-napi instead of weak package

• jest-mock: Fix for mockReturnValue overriding mockImplementationOnce

• jest-reporters: Make node-notifier an optional dependency

• jest-reporters: Make all arguments to methods on BaseReporter optional

• : Set MODULE_NOT_FOUND as error code when module is not resolved from paths

• jest-resolve-dependencies: Handle dynamic dependencies correctly even when using module maps

• jest-snapshot: Remove only the added newlines in multiline snapshots

• jest-snapshot: Distinguish empty string from external snapshot not written

• breaking

  jest-snapshot: Distinguish empty string from internal snapshot not written

• breaking

  jest-snapshot: Remove report method and throw matcher errors

• jest-snapshot: Omit irrelevant received properties when property matchers fail

• jest-transform: Properly cache transformed files across tests

• jest-transform: Don't fail the test suite when a generated source map is invalid

• breaking

  jest-types: Use less null | undefined in config types

• jest-util: Allow querying process.domain

• pretty-format: Correctly detect memoized elements

• pretty-format: Fix pretty-format to respect displayName on forwardRef

Chore & Maintenance

• breaking

  *: Drop support for Node 6

• breaking

  *: Upgrade to Micromatch v4

• breaking

  babel-plugin-jest-hoist: Use ESM exports

• breaking

  jest: Use ESM exports

• breaking

  jest-cli: Use ESM exports

• breaking

  jest-cli: Remove re-exports from @jest/core

• breaking

  jest-environment-jsdom: Upgrade JSDOM from v11 to v15

• breaking

  jest-reporters: Upgrade Istanbul dependencies, which are used for code coverage

• breaking

  jest-util: Remove deprecated exports

• breaking

  jest-validate: Use ESM exports

Features

• expect: Highlight substring differences when matcher fails, part 1

• expect: Highlight substring differences when matcher fails, part 2

• expect: Improve report when mock-spy matcher fails, part 1

• expect: Improve report when mock-spy matcher fails, part 2

• expect: Improve report when mock-spy matcher fails, part 3

• expect: Improve report when mock-spy matcher fails, part 4

• expect: Throw matcher error when received cannot be jasmine spy

• expect: Improve report when negative CalledWith assertion fails

• expect: Improve report when positive CalledWith assertion fails

• expect: Display equal values for ReturnedWith similar to CalledWith

• expect, jest-snapshot: Change color from green for some args in matcher hints

• jest-snapshot: Highlight substring differences when matcher fails, part 3

• jest-core: Improve report when snapshots are obsolete

• jest-cli: Improve chai support (with detailed output, to match jest exceptions)

• *: Manage the global timeout with --testTimeout command line argument.

• pretty-format: Render custom displayName of memoized components

• jest-validate: Allow maxWorkers as part of the jest.config.js

• jest-runtime: Allow passing configuration objects to transformers

• @jest/core, @jest/test-sequencer: Support async sort in custom testSequencer

• jest-runtime, @jest/fake-timers: Add jest.advanceTimersToNextTimer

• @jest-transform: Extract transforming require logic within jest-core into @jest-transform

• jest-matcher-utils: Add color options to matcherHint

• jest-circus/jest-jasmine2: Give clearer output for Node assert errors

• jest-runner: Export all types in the type signature of jest-runner

Fixes

• jest-cli: Detect side-effect only imports when running --onlyChanged or --changedSince

• jest-cli: Allow --maxWorkers to work with % input again

• babel-plugin-jest-hoist: Expand list of whitelisted globals in global mocks

• jest-core: Make watch plugin initialization errors look nice

• jest-snapshot: Prevent inline snapshots from drifting when inline snapshots are updated

• jest-haste-map: Don't throw on missing mapper in Node crawler

• jest-core: Fix incorrect passWithNoTests warning

• jest-snapshots: Fix test retries that contain snapshots

• jest-mock: Fix incorrect assignments when restoring mocks in instances where they originally didn't exist

• expect: Fix stack overflow when matching objects with circular references

• jest-haste-map: Workaround a node >=12.5.0 bug that causes the process not to exit after tests have completed and cancerous memory growth

Performance

• jest-watcher: Minor optimization for JestHook

• @jest/reporters: Prevent runaway CPU useage with --notify on macOS

Features

• jest-circus: Bind to Circus events via an optional event handler on any custom env

• expect: Improve report when matcher fails, part 15

• jest-cli: Update --forceExit and "did not exit for one second" message colors

• expect: Improve report when matcher fails, part 16

• jest-runner: Pass docblock pragmas to TestEnvironment constructor

• expect: Improve report when matcher fails, part 17

• expect: Improve report when matcher fails, part 18

• expect: Improve report when matcher fails, part 19

Fixes

• jest-each: Fix bug with placeholder values

• jest-snapshot: Inline snapshots: do not indent empty lines

• @jest/runtime, @jest/transform: Allow custom transforms for JSON dependencies

• jest-core: Make detectOpenHandles imply runInBand

• jest-haste-map: Fix the mapper option which was incorrectly ignored

• jest-jasmine2: Fix describe return value warning being shown if the describe function throws

• jest-environment-jsdom: Re-declare global prototype of JSDOMEnvironment

• jest-snapshot: Handle arrays when merging snapshots

• expect: Extract names of async and generator functions

• jest-runtime: Fix virtual mocks not being unmockable after previously being mocked

• jest-transform: Replace special characters in transform cache filenames to support Windows

• jest-config: Allow exactly one project

Performance

• jest-runtime: Fix module registry memory leak

• jest-resolve: Optimize resolve module path

• jest-resolve: Cache current directory

• jest-get-type: Simplify checking for primitive

Features

• @jest/core, @jest/test-sequencer: Move testSequencer to individual package @jest/test-sequencer

• @jest/core, jest-cli, jest-config: Add option testSequencer allow user use custom sequencer.

Fixes

• expect: Add negative equality tests for iterables

• jest-haste-map: Resolve fs watcher EMFILE error

Chore & Maintenance

• removed

  expect: Remove repetition of matcherName and options in matchers

Features

• : Improve report when matcher fails, part 13

• @jest/core: Filter API pre-filter setup hook

• jest-snapshot: Improve report when matcher fails, part 14

• @jest/reporter: Display todo and skip test descriptions when verbose is true

• jest-runner: Support default exports for test environments

• pretty-format: Support React.Suspense

• jest-snapshot: Indent inline snapshots

• jest-config: Support colors in displayName configuration

Fixes

• jest-circus: Fix test retries with beforeAll/beforeEach failures

• expect: Fix circular references in iterable equality

• jest-changed-files: Change method of obtaining git root

• jest-each: Fix test function type

• jest-fake-timers: getTimerCount not taking immediates and ticks into account

• jest-runtime: Allow json file as manual mock

• pretty-format: Print BigInt as a readable number instead of {}

• jest-core: Fix ability to transform dependencies required from globalSetup script

• @jest/reporters: Fix Cannot read property converageData of null

• jest-worker: JEST_WORKER_ID starts at 1

• jest-config: Use default cwd even if config contains a cwd property

• : Remove internal peer dependencies

• : Remove internal peer dependencies

• : Remove internal peer dependencies

• jest-resolve: Fix requireActual with moduleNameMapper

• jest-haste-map: Fix haste map duplicate detection in watch mode

Performance

• jest-haste-map: Optimize haste map data structure for serialization/deserialization

• jest-haste-map: Avoid persisting haste map or processing files when not changed

• jest-core: Improve performance of SearchSource.findMatchingTests by 15%

• jest-resolve: Optimize internal cache lookup performance

• jest-core: Dramatically improve watch mode performance

• jest-transform: Cache regular expression instead of creating anew for every file in ScriptTransformer

• jest-core: Fix memory leak of source map info and minor performance improvements

• jest-console: Fix memory leak by releasing console output reference when printed to stdout

• jest-runtime: Use Map instead of Object for module registry

Features

• jest-haste-map: Expose throwOnModuleCollision via config.haste

Features

• jest-resolve: Now supports PnP environment without plugins

Fixes

• expect: Compare DOM nodes even if there are multiple Node classes

• jest-worker: worker.getStdout() can return null

• jest-worker: Re-attach stdout and stderr from new processes/threads created after retries

• jest-reporters/jest-runner: Serialize changedFiles passed to workers

We skipped 24.2.0 because a draft was accidentally published. Please use 24.3.0 or a newer version instead.

Features

• : Improve report when matcher fails, part 10

• : Improve report when matcher fails, part 11

• : Improve report when matcher fails, part 12

• : Improve report when matcher fails, part 7

• : Improve report when matcher fails, part 8

• : Improve report when matcher fails, part 9

• jest-circus/jest-jasmine2: Warn if describe returns a value

• jest-config: Print error information on preset normalization error

• jest-get-type: Add isPrimitive function

• jest-haste-map: Add skipPackageJson option

• jest-util: Add isPromise

• pretty-format: Support React.memo

Fixes

• expect: Fix toStrictEqual not considering arrays with objects having undefined values correctly

• expect: Fix custom async matcher stack trace

• expect: Fix non-object received value in toHaveProperty (#7986, #8067)

• expect: Fix non-symmetric equal for Number

• removed

  expect: Remove duck typing and obsolete browser support code when comparing DOM nodes and use DOM-Level-3 API instead

• jest-changed-files: Fix getChangedFilesFromRoots to not return parts of the commit messages as if they were files, when the commit messages contained multiple paragraphs

• jest-changed-files: Fix pattern for HG changed files

• jest-changed-files: Improve default file selection for Mercurial repos

• jest-circus: Fix bug with test.only

• : Throw explicit error when errors happen after test is considered complete

• security

  jest-cli: Fix prototype pollution vulnerability in dependency

• jest-cli: Refactor -o and --coverage combined

• jest-environment-node: Add missing globals: TextEncoder and TextDecoder

• jest-haste-map: Enforce uniqueness in names (mocks and haste ids)

• : Throw explicit error when errors happen after test is considered complete

• jest-mock: Adds a type check to prototype to allow mocks of objects with a primitive prototype property.

• jest-transform: Normalize config and remove unnecessary checks, convert TestUtils.js to TypeScript

• Make sure to not fail if unable to assign toStringTag to the process object, which is read only in Node 12

• jest-validate: Fix validating async functions

• jest-worker: Fix jest-worker when using pre-allocated jobs

• static: Remove console log '-' on the front page

Performance

• jest-haste-map: Optimize haste map tracking of deleted files with Watchman.