jest "Your test suite must contain at least one test" failing CI after a file rename: why

Find the file Jest thinks is a test suite but is not. After a rename, the usual story is a leftover: the old filename still exists (an empty file, or a file with the test code moved out), or a helper/utility file matches Jest's test-file pattern but contains no tests. Jest treats every file matching testMatch as a suite, and a suite with zero tests fails the run with this message. List the files matching your test pattern, find the one with no test blocks, and either delete it, rename it so it no longer matches, or exclude it in config. Then check why CI sees it and you do not - often the stale file was never committed locally but the rename commit included it, or vice versa.

jest "Your test suite must contain at least one test" failing CI after a file rename: why

Steps

1. List every file matching your testMatch pattern and check which one has no test blocks. A quick search for files with zero describe/it/test calls finds it fast. Expected: you have named the exact file Jest is complaining about.

2. Decide what the file is: a stale leftover from the rename (delete it), a helper that should not be named like a test (rename it so it no longer matches the pattern), or a real suite whose tests were accidentally deleted in the rename (restore them). Expected: the file is classified and handled appropriately - not just deleted blindly.

3. Check git status for the rename: make sure the old filename is actually gone from the repo and the new one is tracked. A rename done outside git (or a case-only rename on a case-insensitive filesystem) leaves ghosts that CI checks out but you never see locally. Expected: git shows a clean rename: old name gone, new name tracked, no untracked leftovers.

4. If helpers must live near tests, exclude them explicitly with testPathIgnorePatterns so future helpers do not trigger this again. Expected: the config excludes helper files and a new helper cannot reintroduce the error.

5. Re-run the full suite in CI. This error fails the whole run, so one green run confirms it. Expected: CI is green and the file list matches between local and CI.

Use this when

• "Your test suite must contain at least one test" after renaming files
• a Jest run that fails on a file with no tests in it
• local and CI disagreeing about which files exist

Not for this skill when

• a suite that is intentionally empty (restructure it or exclude it - but this error is doing its job)
• testPathPattern filtering out all tests (different cause, check your CLI flags)

Variant phrasings

jest empty test suite

The general phrasing. Post-rename adds the stale-file hunt.

jest must contain at least one test

Same error, shorter. Find the zero-test file first.

Why it happens

Jest discovers test suites by filename pattern (testMatch), not by content. Every matching file is loaded as a suite, and a suite that defines zero tests is an error - Jest assumes a file named like a test should test something. Renames break this when the old file lingers: file systems and git do not always agree on what a rename did (especially case-only renames on macOS/Windows versus Linux CI), so CI can check out a stale empty file that does not exist on your machine. The error message does not name the file, which is why the fix starts with listing pattern matches.

Edge cases

• case-only renames (Foo.test.js to foo.test.js): git may not register the change on case-insensitive filesystems - use git mv explicitly
• testMatch patterns that are too broad (matching .spec helpers or fixture files): tighten the pattern once, benefit forever
• CI caching node_modules or the workspace between runs: a stale cache can resurrect the deleted file - clear the cache if the file is gone from git but CI still sees it

Provenance

Resolved from the public thread: https://vectle.com/posts/pst5pUr8KKY1rrtnWV-CF3Fw