packages/jest/src/migrations/update-21-3-0/replace-removed-matcher-aliases.md
Replaces removed Jest matcher aliases in test files with their corresponding matchers to align with Jest v30 changes. Read more at the Jest v30 migration notes.
describe('test', () => {
it('should pass', async () => {
expect(mockFn).toBeCalled();
expect(mockFn).toBeCalledTimes(1);
expect(mockFn).toBeCalledWith(arg);
expect(mockFn).lastCalledWith(arg);
expect(mockFn).nthCalledWith(1, arg);
expect(mockFn).toReturn();
expect(mockFn).toReturnTimes(1);
expect(mockFn).toReturnWith(value);
expect(mockFn).lastReturnedWith(value);
expect(mockFn).nthReturnedWith(1, value);
expect(() => someFn()).toThrowError();
expect(() => someFn()).not.toThrowError();
await expect(someAsyncFn()).rejects.toThrowError();
await expect(someAsyncFn()).resolves.not.toThrowError();
});
});
describe('test', () => {
it('should pass', async () => {
expect(mockFn).toHaveBeenCalled();
expect(mockFn).toHaveBeenCalledTimes(1);
expect(mockFn).toHaveBeenCalledWith(arg);
expect(mockFn).toHaveBeenLastCalledWith(arg);
expect(mockFn).toHaveBeenNthCalledWith(1, arg);
expect(mockFn).toHaveReturned();
expect(mockFn).toHaveReturnedTimes(1);
expect(mockFn).toHaveReturnedWith(value);
expect(mockFn).toHaveLastReturnedWith(value);
expect(mockFn).toHaveNthReturnedWith(1, value);
expect(() => someFn()).toThrow();
expect(() => someFn()).not.toThrow();
await expect(someAsyncFn()).rejects.toThrow();
await expect(someAsyncFn()).resolves.not.toThrow();
});
});