Can't have nested tests / tests in subfolders?
I'm trying to co-locate my tests, and my functions are in various folders. Is it possible to do so? I was running into errors, but it worked when putting them in the root convex/ directory. However, I cannot have the co-location niceness anymore
From claude code:
Yes, exactly! That was the main issue. The convex-test library has a limitation where
it expects test files to be in the root of the convex/ directory, not in
subdirectories.
When we had the tests at:
- convex/auth/users.test.ts
- convex/auth/access.test.ts
And they were importing from ../_generated/api, convex-test couldn't properly resolve
the module paths and gave us the "Could not find the _generated directory" error.
By moving them to:
- convex/users.test.ts
- convex/access.test.ts
And changing the imports to ./_generated/api (matching the documentation examples),
everything worked.
This is a quirk of how convex-test uses Vite's import.meta.glob under the hood to
dynamically load the Convex modules. It seems to expect a specific directory structure
where test files are siblings to the _generated directory.
So the key takeaways are:
1. Keep test files in the root of the convex/ directory
2. Use relative imports from the test file's perspective (./_generated/api, not
../_generated/api)
3. Test utilities can live outside the convex directory (we put them in test-utils/)
This limitation isn't clearly documented, which made it tricky to debug. But now that
we know, it's easy to work around - just keep all test files at the convex root level!
From claude code:
so the issue was we can't have tests in subfolders?
Yes, exactly! That was the main issue. The convex-test library has a limitation whereit expects test files to be in the root of the convex/ directory, not in
subdirectories.
When we had the tests at:
- convex/auth/users.test.ts
- convex/auth/access.test.ts
And they were importing from ../_generated/api, convex-test couldn't properly resolve
the module paths and gave us the "Could not find the _generated directory" error.
By moving them to:
- convex/users.test.ts
- convex/access.test.ts
And changing the imports to ./_generated/api (matching the documentation examples),
everything worked.
This is a quirk of how convex-test uses Vite's import.meta.glob under the hood to
dynamically load the Convex modules. It seems to expect a specific directory structure
where test files are siblings to the _generated directory.
So the key takeaways are:
1. Keep test files in the root of the convex/ directory
2. Use relative imports from the test file's perspective (./_generated/api, not
../_generated/api)
3. Test utilities can live outside the convex directory (we put them in test-utils/)
This limitation isn't clearly documented, which made it tricky to debug. But now that
we know, it's easy to work around - just keep all test files at the convex root level!
Join the Convex Discord! Explore Convex, the backend platform that keeps your app in sync.
15,138Members
Resources
Similar Threads
Was this page helpful?
