يفتح المستخدم نموذج تعديل عميل ويغيّر رقم هاتف داخل مصفوفة. بعد الضغط على إلغاء، يتغير الرقم في البطاقة الأصلية لأن المسودة شاركت نفس المصفوفة. نسخ الطبقة العليا بالانتشار يترك مرجع العناصر المتداخلة مشتركًا؛ لذا لا يحمي الإلغاء إذا عدّل النموذج المصفوفة أو عناصرها مباشرة.
حدد عقدًا لكائن المسودة
كوّن مسودة من حقول بيانات معروفة. يمكن أن تحتوي هذه الحقول على كائنات عادية ومصفوفات وتواريخ قابلة للنسخ المهيكل. لا تعدّ الدالة آلية لاستعادة كل خصائص نموذج أو لاستنساخ عنصر DOM. إذا احتوى المدخل على دالة، قد يفشل النسخ باستخدام DataCloneError؛ افصل بيانات التعديل عن مراجع الأحداث والمكوّنات قبل النسخ.
const original = { contacts: [{ phone: "100" }] };
const draft = structuredClone(original);
draft.contacts[0].phone = "200";
console.assert(original.contacts[0].phone === "100");
اختبار الإلغاء والحفظ والفشل
افتح سجلًا فيه جهتا اتصال ثم عدّل أولهما وأضف ثالثة. ألغ التعديل وتحقق أن عدد الجهات والرقم الأصلي ثابتان. أعد التجربة مع الحفظ ثم تحقق من تحديث العرض عند نجاح الطلب فقط. إذا فشل الحفظ، أبق الحقول في النموذج وأظهر رسالة قابلة لإعادة المحاولة؛ لا تجعل نجاح النسخ المحلي يعادل نجاح الخادم.
لا تنسخ قنوات النقل بلا حاجة
تجنب خيارات transfer في إنشاء مسودة عادية. نقل مخزن مثل ArrayBuffer قد يفصل الأصل، وهو عكس غرض المسودة. لو كان مدخل التعديل كبيرًا، جرّب نقل الحقول المطلوبة إلى كائن بسيط بدل نسخ حالة الشاشة كلها. قارن وقت فتح النموذج قبل وبعد على سجل كبير فعلي في الاختبار دون استخدام بيانات عميل حقيقية.
المصدر
مواصفة HTML: خوارزمية النسخ المهيكل.
للاطلاع على خدمات فايندو المرتبطة بهذا المثال: تطوير أنظمة إدارة العملاء. الغلاف رسم تقني أصلي لبيانات تعليمية.




