Mock Next.js Router for Testing

May 9, 2023

How do you test route changes in Jest Next.js? Well, out of the box, it sucks 😔

That's because Jest tests are not running in a real browser. Instead, they run in an environment called jsdom. jsdom's job is to simulate a browser as much as possible, but if writing a browser is hard, simulating it can be even harder. In particular, jsdom does not simulate navigation. So how do we test these cases?

Luckily Next.js comes with its own routing. We can mock that! You can use next-router-mock and do something like this:

import { render } from "@testing-library/react";
import userEvent from "@testing-library/user-event";
import mockRouter from "next-router-mock";
import { MemoryRouterProvider } from "next-router-mock/MemoryRouterProvider";

it("tests also route changes", () => {
  const user = userEvent.setup();
  render(<MyComponent />, { wrapper: MemoryRouterProvider });
  user.click(screen.getByText("Navigate away"));

You can see more examples in next-router-mock README.