2020-08-25 23:57:08 +00:00
|
|
|
# Disallow use of deprecated functions (`no-deprecated-functions`)
|
|
|
|
|
2022-11-10 10:43:16 +00:00
|
|
|
💼 This rule is enabled in the ✅ `recommended`
|
|
|
|
[config](https://github.com/jest-community/eslint-plugin-jest/blob/main/README.md#shareable-configurations).
|
|
|
|
|
|
|
|
🔧 This rule is automatically fixable by the
|
|
|
|
[`--fix` CLI option](https://eslint.org/docs/latest/user-guide/command-line-interface#--fix).
|
|
|
|
|
|
|
|
<!-- end auto-generated rule header -->
|
|
|
|
|
2020-08-25 23:57:08 +00:00
|
|
|
Over the years Jest has accrued some debt in the form of functions that have
|
|
|
|
either been renamed for clarity, or replaced with more powerful APIs.
|
|
|
|
|
|
|
|
While typically these deprecated functions are kept in the codebase for a number
|
|
|
|
of majors, eventually they are removed completely.
|
|
|
|
|
2022-11-10 10:43:16 +00:00
|
|
|
This rule requires knowing which version of Jest you're using - see
|
|
|
|
[this section of the readme](../../README.md#jest-version-setting) for details
|
|
|
|
on how that is obtained automatically and how you can explicitly provide a
|
|
|
|
version if needed.
|
|
|
|
|
2020-08-25 23:57:08 +00:00
|
|
|
## Rule details
|
|
|
|
|
|
|
|
This rule warns about calls to deprecated functions, and provides details on
|
|
|
|
what to replace them with, based on the version of Jest that is installed.
|
|
|
|
|
|
|
|
This rule can also autofix a number of these deprecations for you.
|
|
|
|
|
|
|
|
### `jest.resetModuleRegistry`
|
|
|
|
|
2022-11-10 10:43:16 +00:00
|
|
|
This function was renamed to `resetModules` in Jest 15 and removed in Jest 27.
|
2020-08-25 23:57:08 +00:00
|
|
|
|
|
|
|
### `jest.addMatchers`
|
|
|
|
|
2022-11-10 10:43:16 +00:00
|
|
|
This function was replaced with `expect.extend` in Jest 17 and removed in
|
|
|
|
Jest 27.
|
2020-08-25 23:57:08 +00:00
|
|
|
|
|
|
|
### `require.requireActual` & `require.requireMock`
|
|
|
|
|
|
|
|
These functions were replaced in Jest 21 and removed in Jest 26.
|
|
|
|
|
|
|
|
Originally, the `requireActual` & `requireMock` the `requireActual`&
|
|
|
|
`requireMock` functions were placed onto the `require` function.
|
|
|
|
|
|
|
|
These functions were later moved onto the `jest` object in order to be easier
|
|
|
|
for type checkers to handle, and their use via `require` deprecated. Finally,
|
2022-11-10 10:43:16 +00:00
|
|
|
the release of Jest 26 saw them removed from the `require` function altogether.
|
2020-08-25 23:57:08 +00:00
|
|
|
|
|
|
|
### `jest.runTimersToTime`
|
|
|
|
|
2022-11-10 10:43:16 +00:00
|
|
|
This function was renamed to `advanceTimersByTime` in Jest 22 and removed in
|
|
|
|
Jest 27.
|
2020-08-25 23:57:08 +00:00
|
|
|
|
|
|
|
### `jest.genMockFromModule`
|
|
|
|
|
|
|
|
This function was renamed to `createMockFromModule` in Jest 26, and is scheduled
|
2022-11-10 10:43:16 +00:00
|
|
|
for removal in Jest 30.
|