Skip to content
NewBun 1.4.5 is out. Release notes
AphrodyBun

Linter · Rules

bun:test/prefer-to-have-length

Require toHaveLength() instead of comparing the length property

When expect(users.length).toBe(2) fails, the message shows two bare numbers. expect(users).toHaveLength(2) labels them as the expected and the received length. If the value has no length property, it says so instead of comparing undefined with 2.

The rule reports .length inside expect() when the matcher is toBe(), toEqual(), or toStrictEqual().

--fix rewrites the assertion.

Configure

Off by default. To turn it on:

bunfig.toml
[lint.rules]
"bun:test/prefer-to-have-length" = "error" # or "warn"

Examples

Reported:

import { expect, test } from "bun:test";

test("finds the active users", () => {
  const users = findUsers({ active: true });
  expect(users.length).toBe(2);
  expect(users[0].roles.length).not.toEqual(0);
});

Not reported:

import { expect, test } from "bun:test";

test("finds the active users", () => {
  const users = findUsers({ active: true });
  expect(users).toHaveLength(2);
  expect(users[0].roles).not.toHaveLength(0);
  expect(users.length).toBeGreaterThan(1);
});