النسخ العميق في JavaScript باستخدام OrganizationClone

يتضمّن النظام الأساسي الآن دالة structuredClone()‎، وهي دالة مضمّنة للنسخ العميق.

لفترة طويلة، كان عليك اللجوء إلى الحلول البديلة والمكتبات لإنشاء نسخة كاملة من قيمة JavaScript. تتضمّن المنصة الآن structuredClone()، وهي دالة مدمجة للنسخ العميق.

Browser Support

  • Chrome: 98.
  • Edge: 98.
  • Firefox: 94.
  • Safari: 15.4.

Source

النُسخ السطحية

إنّ نسخ قيمة في JavaScript يكون دائمًا تقريبًا سطحيًا، وليس عميقًا. هذا يعني أن التغييرات في القيم المتداخلة بعمق ستكون مرئية في النسخة وكذلك في الأصل.

إحدى الطرق لإنشاء نسخة سطحية في JavaScript باستخدام عامل انتشار الكائن ...:

const myOriginal = {
  someProp: "with a string value",
  anotherProp: {
    withAnotherProp: 1,
    andAnotherProp: true
  }
};

const myShallowCopy = {...myOriginal};

لن تؤثر إضافة سمة أو تغييرها مباشرةً في النسخة السطحية إلا في النسخة، وليس في النسخة الأصلية:

myShallowCopy.aNewProp = "a new value";
console.log(myOriginal.aNewProp)
// ^ logs `undefined`

ومع ذلك، فإن إضافة أو تغيير خاصية متداخلة بعمق يؤثر في كل من النسخة والأصل:

myShallowCopy.anotherProp.aNewProp = "a new value";
console.log(myOriginal.anotherProp.aNewProp) 
// ^ logs `a new value`

يتكرّر التعبير {...myOriginal} على سمات (قابلة للتعداد) لـ myOriginal باستخدام عامل الانتشار. ويستخدم اسم السمة وقيمتها، ويخصّصها واحدة تلو الأخرى لكائن فارغ تم إنشاؤه حديثًا. على هذا النحو، يكون الكائن الناتج متطابقًا في الشكل، ولكن مع نسخته الخاصة من قائمة الخصائص والقيم. يتم نسخ القيم أيضًا، ولكن يتم التعامل مع ما يُسمى بالقيم الأولية بشكل مختلف بواسطة قيمة JavaScript عن القيم غير الأولية. للاقتباس من MDN:

في JavaScript، القيمة الأساسية (أو نوع البيانات الأساسي) هي بيانات ليست كائنًا ولا تتضمّن أي طرق. هناك سبعة أنواع بيانات أساسية: السلسلة، والرقم، والعدد الصحيح الكبير، والقيمة المنطقية، والقيمة غير المحدّدة، والرمز، والقيمة الفارغة.

MDN — Primitive

يتم التعامل مع القيم غير الأساسية على أنّها مراجع، ما يعني أنّ عملية نسخ القيمة هي في الواقع مجرد نسخ مرجع إلى العنصر الأساسي نفسه، ما يؤدي إلى سلوك النسخ السطحي.

النُسخ العميقة

وعكس النسخة السطحية هو النسخة العميقة. تنسخ خوارزمية النسخ العميق أيضًا خصائص الكائن واحدًا تلو الآخر، ولكنها تستدعي نفسها بشكل متكرر عندما تجد مرجعًا لكائن آخر، مما يؤدي إلى إنشاء نسخة من هذا الكائن أيضًا. قد يكون هذا مهمًا جدًا للتأكد من أن جزأين من التعليمات البرمجية لا يشاركان كائنًا عن طريق الخطأ ويتلاعبان بحالة بعضهما البعض دون علم.

في السابق، لم تكن هناك طريقة سهلة أو جيدة لإنشاء نسخة كاملة من قيمة في JavaScript. اعتمد العديد من الأشخاص على مكتبات تابعة لجهات خارجية مثل دالة cloneDeep() في Lodash. يمكن القول إنّ الحل الأكثر شيوعًا لهذه المشكلة هو اختراق مستند إلى JSON:

const myDeepCopy = JSON.parse(JSON.stringify(myOriginal));

في الواقع، كان هذا الحل البديل شائعًا جدًا، لدرجة أنّ V8 حسّن بشكل كبير JSON.parse()، وتحديدًا النمط أعلاه لجعله سريعًا قدر الإمكان. وعلى الرغم من سرعته، إلا أنّه يتضمّن بعض العيوب والعقبات:

  • بُنى البيانات المتكررة: سيتم عرض الخطأ JSON.stringify() عند إدخال بنية بيانات متكررة. يمكن أن يحدث هذا بسهولة تامة عند العمل مع القوائم أو الأشجار المرتبطة.
  • الأنواع المضمّنة: سيتم عرض خطأ من خلال JSON.stringify() إذا كانت القيمة تحتوي على عناصر JS مضمّنة أخرى، مثل Map أو Set أو Date أو RegExp أو ArrayBuffer.
  • الدوال: سيتجاهل JSON.stringify() الدوال بدون إشعار.

الاستنساخ المنظَّم

احتاجت المنصة إلى إمكانية إنشاء نُسخ عميقة من قيم JavaScript في مكانَين: يتطلّب تخزين قيمة JS في IndexedDB شكلاً من أشكال التسلسل ليتم تخزينها على القرص ثم إلغاء تسلسلها لاحقًا لاستعادة قيمة JS. وبالمثل، يتطلب إرسال الرسائل إلى WebWorker عبر postMessage() نقل قيمة JS من نطاق JS إلى آخر. تُعرف الخوارزمية المستخدَمة لهذا الغرض باسم "النسخة المطابقة المنظَّمة"، ولم تكن متاحة بسهولة للمطوّرين حتى وقت قريب.

لقد تغيّر ذلك الآن. تم تعديل مواصفات HTML لعرض دالة باسم structuredClone() تُشغّل هذه الخوارزمية تحديدًا كوسيلة للمطوّرين لإنشاء نُسخ عميقة من قيم JavaScript بسهولة.

const myDeepCopy = structuredClone(myOriginal);

هذا كل ما في الأمر. هذه هي واجهة برمجة التطبيقات بالكامل. إذا أردت التعمّق في التفاصيل، يمكنك الاطّلاع على مقالة MDN.

الميزات والقيود

يعالج الاستنساخ المنظَّم العديد من أوجه القصور (وليس كلها) في أسلوب JSON.stringify(). يمكن أن يتعامل الاستنساخ المنظَّم مع هياكل البيانات الدورية، ويتيح العديد من أنواع البيانات المضمّنة، وهو بشكل عام أكثر فعالية وغالبًا ما يكون أسرع.

ومع ذلك، لا تزال هناك بعض القيود التي قد تفاجئك:

  • النماذج الأوّلية: إذا كنت تستخدم structuredClone() مع مثيل فئة، ستحصل على كائن عادي كقيمة مرجعة، لأنّ عملية الاستنساخ المنظَّم تتجاهل سلسلة النماذج الأوّلية للكائن.
  • الدوال: إذا كان العنصر يحتوي على دوال، سيُظهر structuredClone() استثناء DataCloneError.
  • القيم غير القابلة للاستنساخ: بعض القيم غير قابلة للاستنساخ المنظَّم، وأبرزها Error وعُقد DOM. سيؤدي ذلك إلى ظهور خطأ في structuredClone().

إذا كان أي من هذه القيود يمثل عائقًا لحالة الاستخدام الخاصة بك، فإن المكتبات مثل Lodash لا تزال توفر عمليات تنفيذ مخصصة لخوارزميات الاستنساخ العميق الأخرى التي قد تناسب أو لا تناسب حالة الاستخدام الخاصة بك.

الأداء

على الرغم من أنّني لم أُجرِ مقارنة جديدة مستنِدة إلى مقياس أداء دقيق، أجريتُ مقارنة في أوائل عام 2018، قبل الكشف عن structuredClone(). في ذلك الوقت، كان JSON.parse() أسرع خيار للعناصر الصغيرة جدًا. وأتوقع أن يبقى الوضع على حاله. كانت الأساليب التي تعتمد على الاستنساخ المنظَّم أسرع (بشكل كبير) مع العناصر الأكبر حجمًا. بما أنّ واجهة برمجة التطبيقات structuredClone() الجديدة لا تتطلّب استخدام واجهات برمجة تطبيقات أخرى بشكل غير ملائم، وتُعدّ أكثر فعالية من JSON.parse()، أنصحك باستخدامها كطريقة تلقائية لإنشاء نُسخ كاملة.

الخاتمة

إذا كنت بحاجة إلى إنشاء نسخة عميقة من قيمة في JS، ربما لأنك تستخدم هياكل بيانات غير قابلة للتغيير أو تريد التأكّد من أنّ إحدى الدوال يمكنها معالجة عنصر بدون التأثير في العنصر الأصلي، لن تحتاج بعد الآن إلى استخدام حلول بديلة أو مكتبات. تتوفّر الآن structuredClone() في منظومة JavaScript المتكاملة. رائع.