Skip to content

Invalid test configuration: unknown option

Quick summary

Your test config has an unknown option — the test framework rejects the configuration or ignores the option.

Why this happens

  • The config option name is misspelled or does not exist in the test framework

  • The config is for a different test framework than the one being used

  • The test framework version does not support the config option

Minimal example

✗ Broken code
// vitest.config.ts
export default {
  test: {
    timeout: 5000,
    paralel: true, // typo: paralel instead of parallel
  },
};
✓ Fixed code
// vitest.config.ts
export default {
  test: {
    timeout: 5000,
    parallel: true, // correct option name
  },
};

Correcting the option name to 'parallel' matches the test framework's configuration schema and enables parallel test execution.

How to diagnose

  • Check the test framework documentation for valid configuration options

  • Verify the config file name and format match the test framework's expectations

  • Check the test framework version and compare with the option's availability

How to fix

  • Correct the option name to match the test framework's configuration schema

  • Remove the unknown option or replace it with the correct equivalent

  • Upgrade or downgrade the test framework to a version that supports the option

How to prevent

  • Use the test framework's schema or TypeScript types for configuration validation

  • Keep the test framework version and documentation in sync with the config

Related Resources

Related Glossary

Related Lessons

← Back to language