Migrating from Jest

Most Jest suites translate to ende test without rewriting test logic: the standard library's @ende/testing/bdd module provides the same describe/it structure, and @ende/expect ships the matchers you already use. What changes is a handful of imports and how the runner is configured.

The same test, in Ende

A typical Jest test needs only new imports:

import { beforeEach, describe, it } from "jsr:@ende/testing/bdd";
import { expect, fn } from "jsr:@ende/expect";

describe("shopping cart", () => {
  let cart: string[];

  beforeEach(() => {
    cart = [];
  });

  it("starts empty", () => {
    expect(cart).toHaveLength(0);
  });

  it("notifies a listener", () => {
    const onAdd = fn();
    cart.push("apple");
    onAdd(cart.length);
    expect(onAdd).toHaveBeenCalledWith(1);
  });
});

$ ende test cart.test.ts
ok | 1 passed (2 steps) | 0 failed (13ms)

Unlike Jest, nothing is injected as a global: describe, it, expect, and the hooks are explicit imports, so each file states what it uses.

What maps to what

Translate the configuration

Jest configuration mostly disappears: TypeScript, JSX, and ES modules work without transforms, so ts-jest, babel-jest, and transform entries have no equivalent to migrate. File selection moves into ende.json:

{
  "test": {
    "include": ["src/**/*.test.ts"],
    "exclude": ["src/fixtures/"]
  }
}

Module mocks

There is no equivalent of jest.mock("./module"), because module records are immutable in Ende. Tests that rely on it migrate to one of:

• dependency injection: pass the collaborator in, and hand the test a spy or stub,
• stubbing the object the module exposes, with stub from @ende/testing/mock.

This is usually the only part of a migration that requires touching the code under test.