Series: React Hook Form Lesson 45

setError() — Maydonga va root darajasiga qo'lda xato o'rnatish

setError() sintaksisi, server va manual xatolar, shouldFocus opsiyasi, backend 422 javoblarini integratsiya qilish va root xatolar.

45-dars

setError() — Custom error o'rnatish

setError(name, error, options?) — bu useForm() (yoki useFormContext()) qaytaradigan funksiya bo'lib, muayyan maydonga (field), ichki obyektlarga yoki butun forma darajasidagi root xatolariga qo'lda (custom / server / manual) validatsiya xatosi o'rnatish imkonini beradi.

U ayniqsa:

  • Backend API'dan 422 (Unprocessable Entity) xatolari qaytganda server xabarini aynan o'sha input ostida ko'rsatishda,
  • Ikki yoki undan ortiq maydon o'rtasidagi murakkab o'zaro bog'liqlikni (cross-field validation) tekshirishda,
  • Muayyan shartli hodisalar va biznes mantiq xatolarini foydalanuvchiga yetkazishda juda qulaydir.

1. setError() sintaksisi va konfiguratsiya opsiyalari

setError(name, { type, message }, options?)
Parametr / Opsiya Turi Tavsifi va vazifasi
name Path<T> | "root" | "root.custom" Xato qo'yiladigan maydon nomi yoki umumiy forma xatosi kaliti.
error.type string Xato turi (masalan: "server", "manual", "validate", "crossField").
error.message string Foydalanuvchiga ko'rsatiladigan tushunarli xato matni.
options.shouldFocus boolean true berilsa, xato o'rnatilgach kursorni o'sha xatoli inputga avtomatik olib boradi.

2. Real misol: Backend 422 xatosini maydonga bog'lash va shouldFocus

Quyidagi misolda serverga so'rov yuborilganda, agar email allaqachon ro'yxatdan o'tgan bo'lsa, backend javobiga ko'ra setError orqali xato aynan email maydoniga biriktiriladi va kursor o'sha maydonga yo'naltiriladi:

import { useForm, type SubmitHandler } from "react-hook-form";

type RegisterEmployeeForm = {
  email: string;
  departmentCode: string;
};

export function SetErrorExampleForm() {
  const {
    register,
    handleSubmit,
    setError,
    formState: { errors, isSubmitting },
  } = useForm<RegisterEmployeeForm>({
    defaultValues: {
      email: "",
      departmentCode: "ENG",
    },
  });

  const onSubmit: SubmitHandler<RegisterEmployeeForm> = async (data) => {
    // API so'rovini simulyatsiya qilish
    await new Promise((resolve) => setTimeout(resolve, 600));

    // 1. Backend'dan kelgan maydon darajasidagi xatolikni bog'lash
    if (data.email.trim().toLowerCase() === "[email protected]") {
      setError(
        "email",
        {
          type: "server",
          message: "Ushbu email bilan xodim allaqachon ro'yxatdan o'tgan.",
        },
        { shouldFocus: true } // Inputga avtomatik fokus beriladi
      );
      return;
    }

    // 2. Qo'lda (manual) maxsus biznes qoida xatosini qo'yish
    if (data.departmentCode === "INVALID") {
      setError("departmentCode", {
        type: "manual",
        message: "Bo'lim kodi noto'g'ri kiritilgan.",
      });
      return;
    }

    console.log("Xodim muvaffaqiyatli qo'shildi:", data);
  };

  return (
    <form onSubmit={handleSubmit(onSubmit)} noValidate>
      <div>
        <label htmlFor="empEmail">Ishchi emaili</label>
        <input
          id="empEmail"
          type="email"
          placeholder="[email protected]"
          {...register("email", { required: "Email kiritish majburiy" })}
        />
        {errors.email && (
          <p style={{ color: "red" }} role="alert">
            {errors.email.message}{" "}
            <small style={{ color: "#666" }}>({errors.email.type})</small>
          </p>
        )}
      </div>

      <div style={{ marginTop: "1rem" }}>
        <label htmlFor="deptCode">Bo'lim kodi</label>
        <input
          id="deptCode"
          placeholder="Masalan: ENG"
          {...register("departmentCode", { required: "Bo'lim kodi majburiy" })}
        />
        {errors.departmentCode && (
          <p style={{ color: "red" }} role="alert">
            {errors.departmentCode.message}
          </p>
        )}
      </div>

      <button type="submit" disabled={isSubmitting} style={{ marginTop: "1.25rem" }}>
        {isSubmitting ? "Yuborilmoqda..." : "Saqlash"}
      </button>
    </form>
  );
}

3. Muhim amaliy eslatmalar

1. setError xatolarining tozalanishi

setError() orqali qo'yilgan xatolar doimiy emas:

  • Foydalanuvchi o'sha inputga yana yozib o'zgartirganda (agar mode: "onChange" bo'lsa),
  • Inputdan chiqib ketganda (blur bo'lganda),
  • clearErrors("email") yoki reset() chaqirilganda, avtomatik tarzda qayta hisoblanadi va tozalanishi mumkin.

2. Butun formaga tegishli umumiy xatolar uchun "root"

Agar backenddan qaytgan xato aniq bir inputga (email yoki ismga) tegishli bo'lmasa (masalan: "Baza bilan aloqa uzildi" yoki "Kredit karta limitidan oshildi"), uni forma darajasida saqlash lozim:

setError("root.serverError", {
  type: "server",
  message: "Tizimda nosozlik. Iltimos, keyinroq urinib ko'ring.",
});

// UI'da ko'rsatish:
{errors.root?.serverError && <p>{errors.root.serverError.message}</p>}