For AI agents: the complete documentation index is available at https://rslint.rs/llms.txt, the full documentation bundle is available at https://rslint.rs/llms-full.txt, and this page is available as Markdown at https://rslint.rs/rules/jest/prefer-each.md.
close
Rslint

    prefer-each

    Added in v0.6.0

    Configuration

    PresetConfigured Value
    ✅ jestPlugin.configs.all"error"
    rslint.config.ts
    import { defineConfig, jestPlugin } from '@rslint/core';

export default defineConfig([
  jestPlugin.configs.recommended,
  {
    rules: {
      'jest/prefer-each': 'error',
    },
  },
]);

    Rule Details

    Prefer .each over wrapping describe/test/it in native for loops, for clearer output and easier filtering. A loop that only runs logic inside a test function is ignored; a loop that registers tests, suites, or hooks is reported wherever it sits.

    Examples of incorrect code for this rule:

    for (const number of getNumbers()) {
  it('is greater than five', function () {
    expect(number).toBeGreaterThan(5);
  });
}

for (const [input, expected] of data) {
  beforeEach(() => setupSomething(input));

  test(`results in ${expected}`, () => {
    expect(doSomething()).toBe(expected);
  });
}

    Examples of correct code for this rule:

    it.each(getNumbers())(
  'only returns numbers that are greater than seven',
  number => {
    expect(number).toBeGreaterThan(7);
  },
);

describe.each(data)('when input is %s', ([input, expected]) => {
  beforeEach(() => setupSomething(input));

  test(`results in ${expected}`, () => {
    expect(doSomething()).toBe(expected);
  });
});

// we don't warn on loops _in_ test functions that register nothing because
// those typically involve complex setup that is better done in the test
// function itself
it('returns numbers that are greater than five', () => {
  for (const number of getNumbers()) {
    expect(number).toBeGreaterThan(5);
  }
});

    Original Documentation