Create React App (react-scripts) automatically includes setupFilesAfterEnv if it finds a setup tests file. Add the following to the file if it exists, or create a file. You do not need to modify a Jest config unless you've ejected from Create React App.

src/setupTests.js or src/setupTests.ts

// Mock `window.location` with Jest spies and Jest expect matcher
import "jest-location-mock";

If you don't want to group the location mock with any other test setup logic, you can just include the package name directly in the array.

jest.config.js

module.exports = {
    // [other Jest config properties...]
    setupFilesAfterEnv: [
        "jest-location-mock"
    ]
};

Jest setup and config files can be in TypeScript, given that you are already using ts-jest.

jest.config.ts

import type {Config} from "jest";

const config: Config = {
    // [other Jest config properties...]
    setupFilesAfterEnv: [
        "./config/jest-setup.ts"
    ]
};

export default config;

config/jest-setup.ts

// Mock `window.location` with Jest spies and Jest expect matcher
import "jest-location-mock";

The starting location is https://localhost/ by default. If process.env.HOST is set before the beforeEach() that creates the mock (e.g. a real environment variable or the value is set by JavaScript roughly right before each test is run), this value is used instead.

However, the most straightforward solution to changing the starting location is to be verbose about the desired location either in your setup file:

config/jest-setup.js

// Mock `window.location` with Jest spies and Jest expect matcher
import "jest-location-mock";

beforeEach(() => {
    window.location = "https://example.com";
});

Or in your tests:

__tests__/starting-location-example.test.js

beforeEach(() => {
    window.location = "https://example.com";
});

This is by no means required, especially if you do not need to test for behavior dependant on the starting location or the origin.

If you do not include the default import in the test environment setup file, you can apply the mock only in certain test suites by importing it at the top of each file that needs the mock.

__tests__/needs-location-mock-example.test.js

// Mock `window.location` with Jest spies and Jest expect matcher
import "jest-location-mock";

// Example test that will pass once the mock is imported
test("should not error when pressed", () => {
	jest.spyOn(console, "error");
	window.location.href = "https://example.com/";
	expect(console.error).not.toHaveBeenCalled();
	expect(window.location.href).toBe("https://example.com/");
});

The easiest and recommended way to include the mock on a per-test basis is splitting up the tests into two files by if it needs the mock or not, and then using the method Selectively Include the Mock in Certain Test Files described above.

If splitting into separate files is not your style and feel comfortable managing the the cleanup, there is nothing stopping you from pulling in the functions that setup the mocks and adding them to your own Jest hook. However, if you find yourself in a place where you need to exclude the mock because adding the mock makes tests fail when they would otherwise pass, please raise an issue if you think this project could be improved.

__tests__/mix-of-mocked-location-and-unmocked-example.test.js

// Pull in the mock setup functions
import {replaceLocation, replaceHistory} from "jest-location-mock/lib/hooks";
// Extend the expect matchers for use with the mocked location, if desired
// - `expect(window.location).toBeAt("/test");`
import "jest-location-mock/lib/extend-expect";

describe("native location", () => {
    test("should use native location", () => {
        jest.spyOn(console, "error");
        window.location.href = "https://example.com/";
        expect(console.error).toHaveBeenCalled();
        expect(window.location.href).toBe("https://localhost/");
    });
});

describe("mocked location", () => {
    // Store the native location stub
    let originalLocation;
    beforeAll(() => {
        originalLocation = Object.getOwnPropertyDescriptor(window, "location");
    });
    // Replace the location property with a clean mock for every each in this describe block
    beforeEach(() => {
        replaceLocation();
        replaceHistory();
    });
    // Reset the location object back to the native stub after all tests complete
    afterAll(() => {
        Object.defineProperty(window, "location", originalLocation);
    });
    test("should use mocked location", () => {
        jest.spyOn(console, "error");
        window.location.href = "https://example.com/";
        expect(console.error).not.toHaveBeenCalled();
        expect(window.location.href).toBe("https://example.com/");
    });
});

If the default behavior of including the Jest expect() matchers and creating a beforeEach() Jest hook that mocks the window.location and listens to methods on window.history doesn't work best for you, you may replace the default import with a custom setup.

config/jest-setup.js

// Remove: `import "jest-location-mock";`

// Do you like the fun little Jest matchers? If so, you may use this import:
import "jest-location-mock/lib/extend-expect";
// Or exclude this to omit them (remember to remove the default import)

// ---

// Did you want to exclude the matchers, but still want the default hook? If so you may use this import:
import "jest-location-mock/lib/setup-hooks";
// Otherwise, you may import the functions that run inside the hook and craft your own logic
import {replaceHistory, replaceLocation} from "jest-location-mock/lib/hooks";

// `beforeEach()` is used by default for a clean slate for each test, but you may find you prefer `beforeAll()`
beforeEach(() => {
    // This is where the most of magic happens, you probably want to keep this
	replaceLocation();
    // New in v3.0.0, proxy and spy on `window.history` to support use cases like browser router from react-router-dom
    // - Remove to isolate the `window.location` mock from `window.history`
	replaceHistory();
});