TanStack

FieldValidator

Interface: FieldValidator<TFormData, TFieldName, TFieldValue>

Defined in: validation.public.ts:508

Extends

Type Parameters

TFormData

TFormData

TFieldName

TFieldName

TFieldValue

TFieldValue

Properties

bailIfInvalid?

ts
optional bailIfInvalid?: boolean;

Defined in: validation.public.ts:21

If true, this validator and all subsequent validators will be skipped if any previous validator has failed. If false, validators run regardless of earlier validation results.

Default

ts
false

Inherited from

Validator.bailIfInvalid


run

ts
run: 
  | FieldValidatorFn<TFormData, TFieldName, TFieldValue>
| StandardSchemaV1<TFieldValue, any>;

Defined in: validation.public.ts:14

Inherited from

Validator.run


runOnMount?

ts
optional runOnMount?: boolean;

Defined in: validation.public.ts:45

Whether this validator should be called once when the form is constructed.

Default

ts
false

Inherited from

Validator.runOnMount


runOnSubmit?

ts
optional runOnSubmit?: 
  | boolean
| ValidationPredicateFn<TFormData, TFieldValue, "field">;

Defined in: validation.public.ts:38

TODO docs

Whether this validator should be called during a submission attempt.

Default

ts
true

Inherited from

Validator.runOnSubmit


triggerDebounceMs?

ts
optional triggerDebounceMs?: 
  | number
| ValidationDebounceFn<TFormData, TFieldValue, "field">;

Defined in: validation.public.ts:52

The debounce time in milliseconds for validation triggers (change, blur). Does not affect submit events, which always execute immediately.

Default

ts
0

Inherited from

Validator.triggerDebounceMs


triggers

ts
triggers: ValidationTriggerOption<TFormData, TFieldValue, ConfigurableValidationTrigger, "field">[];

Defined in: validation.public.ts:54

Inherited from

Validator.triggers


watchFields?

ts
optional watchFields?: DeepKeys<TFormData>[];

Defined in: validation.public.ts:520