Seriya: React Hook Form Dars 58

delayError — Xatoliklarni ekranda ko'rsatishni kechiktirish (Debouncing)

useForm delayError sozlamasi, xatolar miltillashini (flicker) oldini olish, onChange rejimidagi UX optimizatsiyasi va submit xatti-harakati.

58-dars

delayError — Error ko'rsatishni kechiktirish

delayError — bu useForm({ delayError: ... }) konfiguratsiyasida belgilanadigan sonli (number, millisekundlarda) parametr bo'lib, validatsiya xatosi aniqlangandan so'ng errors obyektiga xato yozilishi va ekranda paydo bo'lishini ko'rsatilgan vaqtga kechiktiradi.

Agar kechikish vaqti tugamasdan oldin foydalanuvchi klaviaturada yozishni davom ettirib qiymatni to'g'rilasa, ichki taymer bekor qilinadi va xato xabari ekranda umuman ko'rinmasdan qoladi.

Bu sozlama ayniqsa mode: "onChange" ishlatilganda foydalanuvchi so'zlarni tez-tez yozayotgan paytda qizil xatoliklarning ekranda miltillab (flickering) paydo bo'lishi va yo'qolishining oldini olish uchun juda qulaydir.


1. delayError qanday ishlaydi?

Holat delayError bo'lmaganda (0 ms) delayError: 500 o'rnatilganda
Foydalanuvchi xato qiymat yozdi Xato darhol errors obyektida paydo bo'ladi va ekranda ko'rinadi. 500 ms kutadi; agar xato o'sha holatda qolsa, 500 ms o'tgach errors ga yoziladi.
500 ms ichida qiymat to'g'rilandi Xato bir soniyaga ko'rinib, so'ng darhol o'chadi (yoqimsiz miltillash). Taymer bekor qilinadi — foydalanuvchi xato xabarini umuman ko'rmaydi.
Forma yuborilganda (Submit) Xatolar darhol ko'rsatiladi. Submit paytida xatolar kechiktirilmasdan zudlik bilan tekshiriladi va ko'rsatiladi.

2. Real misol: mode: "onChange" va delayError: 500 kombinatsiyasi

Quyidagi misolda foydalanuvchi har bir harf kiritganda tekshiruv ishlaydi, biroq xatolik xabari faqat foydalanuvchi to'xtaganidan keyin 500 ms o'tgach paydo bo'ladi:

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

type DelayedErrorFormValues = {
  username: string;
  email: string;
};

export function DelayErrorForm() {
  const {
    register,
    handleSubmit,
    formState: { errors, isSubmitting },
  } = useForm<DelayedErrorFormValues>({
    mode: "onChange",
    delayError: 500, // Xato ko'rsatishni 500 ms kechiktiradi (Debounce)
    defaultValues: {
      username: "",
      email: "",
    },
  });

  const onSubmit: SubmitHandler<DelayedErrorFormValues> = async (data) => {
    await new Promise((resolve) => setTimeout(resolve, 300));
    console.log("Muvaffaqiyatli yuborildi:", data);
  };

  return (
    <form onSubmit={handleSubmit(onSubmit)} noValidate>
      {/* 1. Username maydoni */}
      <div>
        <label htmlFor="deUsername">Username (500 ms kechikish bilan)</label>
        <input
          id="deUsername"
          placeholder="Kamida 4 ta belgi"
          {...register("username", {
            required: "Username kiritish majburiy",
            minLength: {
              value: 4,
              message: "Username kamida 4 ta belgidan iborat bo'lsin",
            },
          })}
        />
        {errors.username && (
          <p style={{ color: "red" }} role="alert">
            {errors.username.message}
          </p>
        )}
      </div>

      {/* 2. Email maydoni */}
      <div style={{ marginTop: "1rem" }}>
        <label htmlFor="deEmail">Email manzili</label>
        <input
          id="deEmail"
          type="email"
          placeholder="[email protected]"
          {...register("email", {
            required: "Email kiritish majburiy",
            pattern: {
              value: /^[^\s@]+@[^\s@]+\.[^\s@]+$/,
              message: "Email formati noto'g'ri",
            },
          })}
        />
        {errors.email && (
          <p style={{ color: "red" }} role="alert">
            {errors.email.message}
          </p>
        )}
      </div>

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

3. Muhim amaliy tavsiyalar

1. Optimal vaqt oralig'i: 300–600 ms

Kechikish vaqtini juda katta (masalan: 1500–3000 ms) qo'ymang. Haddan tashqari katta kechikish foydalanuvchida interfeys qotib qolgan yoki tekshirmayotgandek salbiy taassurot uyg'otadi. Inson idroki uchun eng qulay vaqt oralig'i 300 ms dan 500 ms gacha hisoblanadi.

2. mode: "onChange" va mode: "all" uchun mo'ljallangan

Agar sizda mode: "onBlur" bo'lsa, foydalanuvchi baribir inputdan chiqib ketganidan keyin xato chiqadi, shu sababli delayError ning u yerda unchalik zarurati yo'q. U aynan har bir harf kiritilganda tekshiriluvchi onChange rejimida foydalanuvchiga asabiy ta'sir qilmaslik uchun kiritilgan.