@jest/core

Features

• expect: Add asymmetric matcher expect.closeTo

• jest-mock: Added mockFn.mock.lastCall to retrieve last argument

Fixes

• expect: Add a fix for .toHaveProperty('')

• jest-each, @jest/globals: Allow passing ReadonlyArray type of a table to describe.each and test.each

• @jest/globals: Add missing options argument to jest.doMock typing

• jest-environment-node: Add atob and btoa

• jest-matcher-utils: Correct diff for expected asymmetric matchers

• jest-message-util: Fix .getTopFrame() (and toMatchInlineSnapshot()) with mjs files

Performance

• jest-resolve: Skip error creation on not found stat calls

Fixes

• jest-environment-node: Add AbortSignal

• jest-environment-node: Add Missing node global performance

• jest-runtime: Handle missing mocked property

Performance

• jest-config perf: only register ts-node once when loading TS config files

Fixes

• babel-jest: Add process.version chunk to the cache key

• jest-environment: Add mocked to jest object

• jest-worker: Stop explicitly passing execArgv

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-runtime: Add support for dynamic import() from CommonJS

Fixes

• jest-runner, jest-runtime: require.main should not be undefined with createRequire()

• jest-runtime: Add missing module.path property

• jest-runtime: Add mainModule instance variable to runtime

• jest-runtime: Evaluate Node core modules on dynamic import()

• jest-validate: Show suggestion only when unrecognized cli param is longer than 1 character

• jest-validate: Validate testURL as CLI option

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

Fixes

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

• jest-matcher-utils: Fix diffing object contain readonly symbol key object

• jest-reporters: Fixes notify reporter on Linux (using notify-send)

• jest-snapshot: Correctly handles arrays and property matchers in snapshots

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

Fixes

• jest-jasmine2: Don't run beforeAll / afterAll in skipped describe blocks

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