Skip to main content

Function: validateConfig()

validateConfig(value, source?): ZodFormsConfig<Record<string, unknown>>

Defined in: packages/core/src/config.ts:486

Validates an unknown value as a ZodFormsConfig at runtime.

Parses value using the internal Zod config schema and throws a descriptive error if validation fails. Use this when loading config from untrusted sources such as JSON files or dynamic import() calls.

Parameters​

value​

unknown

The value to validate.

source?​

string = 'config'

Human-readable label for error messages (defaults to 'config').

Returns​

ZodFormsConfig<Record<string, unknown>>

The validated configuration cast to ZodFormsConfig.

Throws​

If value does not conform to the config schema.

Use When​

  • Loading config from JSON files or dynamic import() where the type is unknown — validates and narrows to ZodFormsConfig

Avoid When​

  • Using TypeScript with defineConfig() — type errors catch most issues at dev time; validateConfig is only needed when the config source is not type-checkable

Never​

  • NEVER use as a type guard — it throws on invalid input, doesn't narrow; FIX: wrap in try/catch and branch on success, or check keys manually before calling
  • NEVER assume extra keys cause failures — the schema uses z.object().loose(), so unrecognized keys are silently dropped not rejected; FIX: if you need strict key validation, inspect the returned config for unexpected fields manually