Front-end testing with Mocha, Vite and Puppeteer

Published: 2021-03-21 by Lars  test

Automating our tests for front-end code is a bit more tricky than for back-end code, because of the need to interact with a browser. Our code should run in a browser, and our tests should interact with the code through the browser.

In this article we present a new Node.js tool: mocha-vite-puppeteer, which simplifies a setup with these 3 tools: Mocha for testing, Vite for bundling and Puppeteer for controlling a headless Chromium browser.

By combining these 3 tools we can leverage their respective strengths in an easy-to-use package:

Before we can run tests, we will have written some code (Counter.js) and some tests (Counter.test.js). Using React for the example, it could like this:


import React, { useState } from "react";

function Counter() {
  const [count, setCount] = useState(0);
  return (
    <button onClick={() => setCount((count) => count + 1)}>
      count is: {count}

export default Counter;


import { expect } from "chai";
import React from "react";
import { render, screen } from "@testing-library/react";

import Counter from "./Counter";

describe("Counter", () => {
  it("should count", () => {
    render(<Counter />);
    const countButton = screen.getByText("count is: 0");;
    screen.getByText("count is: 1");

Then, to run Mocha in the browser, Mocha requires an HTML page which sets up Mocha and imports all our tests. This file should be located in our Vite root directory next to index.html and vite.config.js.


<!DOCTYPE html>
<html lang="en">
    <script type="module">
      import "mocha";
      mocha.setup({ ui: "bdd" });
    <script type="module">
      const modules = import.meta.globEager("/src/**/*.test.{js,jsx}");

Here we are utilizing a few features of the Vite bundler:

Now we can simply install and run mocha-vite-puppeteer in the root directory:

npx mocha-vite-puppeteer

mocha-vite-puppeteer will go through these steps, as illustrated by the diagram below:

  1. Start Vite web server with path to Mocha automatically resolved.
  2. Start Puppeteer, which in turns launches Chromium.
  3. Configure Puppeteer to forward all console.log() calls to standard output of the Node.js process.
  4. Ask Puppeteer to load test.html.
  5. Ask Puppeteer to configure Mocha with a reporter.
  6. Ask Puppeteer to run Mocha.
  7. Mocha will call our tests.
  8. Our tests will call our code.
  9. Mocha will report test results via console.log().
  10. When Mocha is done, Puppeteer and Vite is closed.

When running our tests, the process looks like this:

We can now enjoy fast and robust testing of our front-end code.

Discuss on Twitter