useFormValidation
Run sync/async validators.
Import
TypeScript
import { useFormValidation } from '@/hooks';API
Signature
useFormValidation(validate?) → { errors, runValidation, ... }
When to use
Use useFormValidation instead of re-implementing the same pattern in multiple components.
SSR / Next.js
SSR-safe state machines.
Live playground
Edit the example and see it run against the real @/hooks package in this app.
Live playgroundEdit · run with real
@/hooks · useFormValidationEditor
function ValidateDemo() { const [values, setValues] = useState({ email: '' }); const { errors, runValidation, isValidating } = useFormValidation<{ email: string }>( (v) => (v.email ? {} : { email: 'Required' }), ); return ( <button onClick={() => void runValidation(values)} disabled={isValidating}> {errors.email ?? 'OK'} </button> ); }
Preview
Implementation source
Full library source for useFormValidation — copy into your project when you are not installing a package yet.
hooks/forms/useFormValidation.ts
import { useCallback, useState } from 'react';
import type { FormErrors, Validator } from '../types';
/**
* Runs a sync or async validator and exposes resulting errors.
*/
export function useFormValidation<T extends Record<string, unknown>>(
validate?: Validator<T>,
) {
const [errors, setErrors] = useState<FormErrors<T>>({});
const [isValidating, setIsValidating] = useState(false);
const runValidation = useCallback(
async (values: T): Promise<FormErrors<T>> => {
if (!validate) {
setErrors({});
return {};
}
setIsValidating(true);
try {
const result = await validate(values);
const next = result ?? {};
setErrors(next);
return next;
} finally {
setIsValidating(false);
}
},
[validate],
);
const isValid = Object.keys(errors).length === 0;
return { errors, setErrors, isValidating, isValid, runValidation };
}
Copy-paste example
useFormValidation.example.tsx
'use client';
import { useState } from 'react';
import { useFormValidation } from '@/hooks';
export function ValidateDemo() {
const [values, setValues] = useState({ email: '' });
const { errors, runValidation, isValidating } = useFormValidation<{ email: string }>(
(v) => (v.email ? {} : { email: 'Required' }),
);
return (
<button onClick={() => void runValidation(values)} disabled={isValidating}>
{errors.email ?? 'OK'}
</button>
);
}Production checklist
- Called only from Client Components or other custom hooks
- Type parameters filled in (e.g.
useFetch<User[]>) - Tip: Field name attributes must match keys in initialValues for handleChange.
- Source of truth: open
hooks/forms/useFormValidation.tsfor implementation details