Optimistic Form Submission — Optimistic update yondashuvi
Server javobini kutmasdan UI ni yangilash, snapshot va rollback mexanizmi, vaqtinchalik ID lar, xatoliklarni qayta tiklash va TanStack Query integratsiyasi.
88-dars
Optimistic Form Submission — Optimistic update yondashuvi
Optimistic Form Submission (optimistik yangilanish yondashuvi) — bu form yuborilganda serverning javobini (200 OK) kutib o'tirmasdan, interfeysdagi ro'yxat, karta yoki sozlamalarni bir zumda yangilab ko'rsatish, agar so'rov kutilmaganda xatolik bilan tugasa (catch), interfeysni avvalgi holatiga qaytarish (Rollback) va foydalanuvchiga xabar berish usulidir.
Zamonaviy tezkor ilovalarda (Telegram, Linear, Notion, GitHub) foydalanuvchi har bir izoh, status yoki reaksiyadan keyin kutish indikatorini (spinner) ko'rmaydi — barcha amallar darhol ekranda aks etadi.
1. Optimistic Update qanday ishlaydi?
graph TD
A["Foydalanuvchi Submit bosadi"] --> B["1. Snapshot: Eski holat nusxasi olinadi"]
B --> C["2. Vaqtinchalik (tempId) element ro'yxatga qo'shiladi va forma tozalanadi"]
C --> D["3. Serverga so'rov jo'natiladi (axios.post)"]
D -->|Muvaffaqiyatli (200 OK)| E["tempId haqiqiy server ID si bilan almashtiriladi (pending: false)"]
D -->|Xatolik (Network / Server Error)| F["4. Rollback: Eski snapshot holati tiklanadi va xato ko'rsatiladi"]
- Snapshot (Nusxa olish): So'rov ketishidan oldin joriy ma'lumotlar holati o'zgaruvchida saqlanadi.
- Optimistic UI & Reset: Server javobini kutmasdan vaqtinchalik ID (
temp-${Date.now()}) bilan yangi element ro'yxatga kiritiladi, formaning inputlari esa yangi ma'lumot kiritish uchun zudlik bilan tozalanadi (reset()). - Asinxron API chaqiruvi: Serverga haqiqiy HTTP so'rovi jo'natiladi.
- Muvaffaqiyat: Serverdan haqiqiy ob'ekt qaytgach, vaqtinchalik element haqiqiy ma'lumotga almashtiriladi (
pending: false). - Rollback (Ortga qaytarish): Agar tarmoq uzilsa yoki server xato bersa, UI eski snapshot holatiga qaytariladi va
setError("root.optimisticError")orqali ogohlantirish beriladi.
2. Qachon qo'llash mos va qachon mumkin emas?
| Mos holatlar (Tavsiya etiladi) | Xavfli holatlar (Qat'iyan tavsiya etilmaydi) |
|---|---|
| Izohlar va xabarlar: Post ostiga tezkor izoh qo'shish. | To'lovlar va bank o'tkazmalari: Tranzaksiyalar aniq server tasdig'ini kutishi shart. |
| Status o'zgartirish: Vazifani "Bajarildi" qilish yoki Like bosish. | Xavfsizlik va parollar: Parol o'zgartirish yoki 2FA yoqish. |
| Tezkor eslatmalar / Todo: Shaxsiy vazifalar ro'yxatini yaratish. | Huquq va rollar (RBAC): Foydalanuvchiga Admin ruxsati berish. |
3. Real misol: Optimistic izoh qo'shish va Rollback mexanizmi
Quyidagi misolda yangi izoh yozilishi bilan darhol ekranda "Saqlanmoqda..." ko'rinishida paydo bo'ladi. Agar so'rov muvaffaqiyatsiz bo'lsa, izoh ro'yxatdan olib tashlanadi (Rollback) va forma qizil xato xabarini chiqaradi:
import React, { useState } from "react";
import axios from "axios";
import { useForm, type SubmitHandler } from "react-hook-form";
// 1. Izoh elementi strukturasi
type CommentItem = {
id: string;
author: string;
body: string;
pending?: boolean; // Vaqtinchalik optimistik holat bayrog'i
};
// 2. Forma qiymatlari tipi
type CommentFormValues = {
author: string;
body: string;
};
export function OptimisticCommentForm() {
// Mavjud izohlar ro'yxati
const [comments, setComments] = useState<CommentItem[]>([
{
id: "1",
author: "Ali Valiyev",
body: "TanStack Router va React Hook Form birikmasi loyihada juda qulay ishlayapti.",
},
]);
const {
register,
handleSubmit,
reset,
setError,
clearErrors,
formState: { errors },
} = useForm<CommentFormValues>({
defaultValues: {
author: "",
body: "",
},
});
const onSubmit: SubmitHandler<CommentFormValues> = async (values) => {
clearErrors("root.optimisticError");
// 1. SNAPSHOT: Xatolik yuz berganda qaytarish uchun joriy holat nusxasi
const previousComments = [...comments];
const tempId = `temp-${Date.now()}`;
// Vaqtinchalik optimistik izoh ob'ekti
const optimisticComment: CommentItem = {
id: tempId,
author: values.author.trim(),
body: values.body.trim(),
pending: true,
};
// 2. OPTIMISTIC UPDATE: Serverni kutmasdan UI'ni darhol yangilaymiz va formani tozalaymiz
setComments((prev) => [optimisticComment, ...prev]);
reset({ author: values.author, body: "" });
try {
// 3. Serverga haqiqiy asinxron POST so'rovi
const { data: savedComment } = await axios.post<CommentItem>(
"/api/comments",
{
author: optimisticComment.author,
body: optimisticComment.body,
}
);
// Muvaffaqiyatli yakun: temp elementni serverdan qaytgan haqiqiy ob'ektga almashtiramiz
setComments((prev) =>
prev.map((item) =>
item.id === tempId ? { ...savedComment, pending: false } : item
)
);
} catch (error) {
// 4. ROLLBACK: Server xato berganda ro'yxatni avvalgi holatiga qaytaramiz
setComments(previousComments);
const errorMessage = axios.isAxiosError<{ message?: string }>(error)
? error.response?.data?.message || "Izohni saqlab bo'lmadi. Holat avvalgi ko'rinishga qaytarildi."
: "Tarmoq bilan aloqa uzildi. Kiritilgan izoh bekor qilindi.";
setError("root.optimisticError", {
type: "server",
message: errorMessage,
});
}
};
return (
<div style={{ maxWidth: "520px", display: "flex", flexDirection: "column", gap: "16px" }}>
<h3 style={{ margin: 0 }}>Izoh qoldirish (Optimistic)</h3>
<form onSubmit={handleSubmit(onSubmit)} noValidate style={{ display: "flex", flexDirection: "column", gap: "12px" }}>
{/* Rollback xatosi xabarnomasi */}
{errors.root?.optimisticError && (
<div
role="alert"
style={{
padding: "10px 14px",
background: "#fef2f2",
border: "1px solid #f87171",
borderRadius: "6px",
color: "#b91c1c",
fontSize: "13px",
}}
>
{errors.root.optimisticError.message}
</div>
)}
{/* Ism maydoni */}
<div>
<label htmlFor="author" style={{ display: "block", fontSize: "13px", fontWeight: 600, marginBottom: "4px" }}>
Ismingiz *
</label>
<input
id="author"
{...register("author", { required: "Ism kiritilishi shart" })}
placeholder="Masalan: Muhammadjon"
style={{ width: "100%", padding: "7px 10px", boxSizing: "border-box" }}
aria-invalid={Boolean(errors.author)}
/>
{errors.author && (
<p role="alert" style={{ color: "#e11d48", fontSize: "12px", marginTop: "2px" }}>
{errors.author.message}
</p>
)}
</div>
{/* Izoh matni */}
<div>
<label htmlFor="body" style={{ display: "block", fontSize: "13px", fontWeight: 600, marginBottom: "4px" }}>
Izoh matni *
</label>
<textarea
id="body"
{...register("body", { required: "Izoh matnini kiriting" })}
rows={2}
placeholder="Fikringizni bildiring..."
style={{ width: "100%", padding: "7px 10px", boxSizing: "border-box" }}
aria-invalid={Boolean(errors.body)}
/>
{errors.body && (
<p role="alert" style={{ color: "#e11d48", fontSize: "12px", marginTop: "2px" }}>
{errors.body.message}
</p>
)}
</div>
<button
type="submit"
style={{
alignSelf: "flex-start",
padding: "8px 18px",
background: "#2563eb",
color: "#fff",
border: "none",
borderRadius: "6px",
cursor: "pointer",
fontWeight: 600,
}}
>
Izoh qoldirish
</button>
</form>
{/* Izohlar ro'yxati */}
<div style={{ display: "flex", flexDirection: "column", gap: "10px", borderTop: "1px solid #e2e8f0", paddingTop: "14px" }}>
<h4 style={{ margin: 0, fontSize: "14px" }}>Mavjud fikrlar ({comments.length}):</h4>
{comments.map((comment) => (
<div
key={comment.id}
style={{
padding: "10px 12px",
background: comment.pending ? "#f8fafc" : "#ffffff",
border: comment.pending ? "1px dashed #cbd5e1" : "1px solid #e2e8f0",
borderRadius: "6px",
opacity: comment.pending ? 0.75 : 1,
}}
>
<div style={{ display: "flex", justifyContent: "space-between", alignItems: "center", marginBottom: "4px" }}>
<strong style={{ fontSize: "13px" }}>{comment.author}</strong>
{comment.pending && (
<span style={{ fontSize: "11px", color: "#64748b", fontStyle: "italic" }}>
⏳ Saqlanmoqda...
</span>
)}
</div>
<p style={{ margin: 0, fontSize: "13px", color: "#334155" }}>{comment.body}</p>
</div>
))}
</div>
</div>
);
}
4. TanStack Query bilan optimistik boshqaruv
Agar loyihada ma'lumotlar almashinuvi TanStack Query (@tanstack/react-query) orqali amalga oshirilsa, useMutation hooki optimistic update va rollback jarayonini kesh darajasida avtomatlashtiradi:
const queryClient = useQueryClient();
const { mutate } = useMutation({
mutationFn: (newComment: CommentFormValues) => axios.post("/api/comments", newComment),
onMutate: async (newComment) => {
// 1. Keshdagi faol so'rovlarni to'xtatib turamiz
await queryClient.cancelQueries({ queryKey: ["comments"] });
// 2. Snapshot olamiz
const previousComments = queryClient.getQueryData(["comments"]);
// 3. Keshni optimistik yangilaymiz
queryClient.setQueryData(["comments"], (old: CommentItem[] = []) => [
{ id: Date.now().toString(), ...newComment, pending: true },
...old,
]);
return { previousComments };
},
onError: (err, newComment, context) => {
// 4. Xatolikda keshni avvalgi snapshotga qaytaramiz (Rollback)
queryClient.setQueryData(["comments"], context?.previousComments);
},
onSettled: () => {
// 5. Serverdagi haqiqiy ma'lumotlar bilan keshni qayta sinxronlaymiz
queryClient.invalidateQueries({ queryKey: ["comments"] });
},
});
5. Xulosa va tavsiyalar
- Tezkorlik (Instant Feel): Optimistic update foydalanuvchiga interfeysni judayam tez va zamonaviy his qildiradi.
- Rollback shart: Har doim
try/catchyokionErrorda avvalgi snapshotni tiklash mexanizmini to'g'ri qo'llang, aks holda foydalanuvchi saqlanmagan xato ma'lumotni saqlangan deb o'ylashi mumkin. - Kritik amallardan qoching: Moliyaviy va xavfsizlikka oid tranzaksiyalarda optimistik emas, an'anaviy
isSubmittingkutish rejimini tanlang.