FormIntermediateSSR-safehooks/forms/useFormValidation.ts

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 · useFormValidation
Editor
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.ts for implementation details