Deep-copying in JavaScript using structuredClone

اکنون «پلاتفرم» با ()structuredClone، تابع داخلی برای کپی عمیق، عرضه می‌شود.

برای مدت طولانی، مجبور بودید برای ایجاد یک کپی عمیق از مقدار جاوا اسکریپت به راه‌حل‌های جایگزین و کتابخانه‌ها متوسل شوید. این پلاتفرم اکنون با structuredClone()، یک تابع داخلی برای کپی عمیق، عرضه می‌شود.

Browser Support

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

Source

کپی‌های سطحی

کپی کردن مقدار در جاوا اسکریپت تقریباً همیشه سطحی است، نه عمیق. این یعنی تغییرات در مقادیر عمیقاً تودرتو در نسخه کپی و همچنین نسخه اصلی قابل‌مشاهده خواهد بود.

یک روش برای ایجاد رونوشت سطحی در جاوا اسکریپت بااستفاده از عملگر گسترش شیء ...:

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 را تکرار می‌کند. این روش از نام و مقدار ویژگی استفاده می‌کند و آن‌ها را یکی‌یکی به شیء خالی تازه ایجادشده اختصاص می‌دهد. به این ترتیب، شیء حاصل ازنظر شکل یکسان است، اما کپی خودش را از فهرست ویژگی‌ها و مقادیر دارد. مقادیر نیز کپی می‌شوند، اما مقادیر به‌اصطلاح اولیه توسط مقدار جاوا اسکریپت متفاوت از مقادیر غیر اولیه مدیریت می‌شوند. به نقل از MDN:

در جاوا اسکریپت، یک مقدار اولیه (مقدار اولیه، نوع داده اولیه) داده‌ای است که شیء نیست و هیچ روشی ندارد. هفت نوع داده اولیه وجود دارد: رشته، عدد، bigint، مقدار منطقی، تعریف‌نشده، نماد، و تهی.

MDN — Primitive

مقادیر غیرپایه به‌عنوان مرجع درنظر گرفته می‌شوند، یعنی عمل کپی کردن مقدار درواقع فقط کپی کردن مرجعی به همان شیء زیربنایی است که منجر به رفتار کپی سطحی می‌شود.

رونوشت‌های عمیق

برعکس کپی سطحی، کپی عمیق است. الگوریتم کپی عمیق نیز ویژگی‌های شیء را یکی‌یکی کپی می‌کند، اما وقتی ارجاعی به شیء دیگری پیدا می‌کند، خودش را به‌صورت بازگشتی فراخوانی می‌کند و نسخه‌ای از آن شیء را نیز ایجاد می‌کند. این امر می‌تواند بسیار مهم باشد تا اطمینان حاصل شود که دو قطعه کد به‌طور تصادفی یک شیء را هم‌رسانی نمی‌کنند و ناآگاهانه وضعیت یکدیگر را دستکاری نمی‌کنند.

قبلاً روش آسان یا خوبی برای ایجاد کپی عمیق از مقدار در جاوا اسکریپت وجود نداشت. بسیاری از افراد به کتابخانه‌های طرف سوم مانند تابع LodashcloneDeep() متکی بودند. مسلماً متداول‌ترین راه‌حل برای این مشکل، هک مبتنی بر JSON بود:

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

درواقع، این راه‌حل آن‌قدر محبوب بود که V8 به‌طور تهاجمی JSON.parse() و به‌ویژه الگوی بالا را بهینه‌سازی کرد تا آن را تا حد امکان سریع کند. و بااینکه سریع است، چند کاستی و تله دارد:

  • ساختارهای داده بازگشتی: JSON.stringify() وقتی ساختار داده بازگشتی به آن بدهید، خطا می‌دهد. این اتفاق می‌تواند به‌راحتی هنگام کار با فهرست‌های پیوندی یا درخت‌ها رخ دهد.
  • انواع توکار: اگر مقدار حاوی دیگر توکارهای JS مثل Map،‏ Set،‏ Date،‏ RegExp، یا ArrayBuffer باشد، JSON.stringify() خطا می‌دهد.
  • توابع: JSON.stringify() توابع را بی‌صدا دور می‌اندازد.

همسانه‌سازی ساختاریافته

این پلتفرم قبلاً به توانایی ایجاد کپی‌های عمیق از مقادیر جاوا اسکریپت در چند مکان نیاز داشت: ذخیره کردن مقدار جاوا اسکریپت در IndexedDB به نوعی سریال‌سازی نیاز دارد تا بتوان آن را روی دیسک ذخیره کرد و بعداً برای بازیابی مقدار جاوا اسکریپت، سریال‌زدایی کرد. به‌طور مشابه، ارسال پیام به WebWorker ازطریق postMessage() مستلزم انتقال مقدار JS از یک قلمرو JS به قلمرو دیگر است. الگوریتمی که برای این کار استفاده می‌شود «کلون ساختاریافته» نام دارد و تا همین اواخر، به‌راحتی برای توسعه‌دهندگان دردسترس نبود.

اکنون این موضوع تغییر کرده است! مشخصات HTML اصلاح شد تا تابعی به‌نام structuredClone() را نشان دهد که دقیقاً همان الگوریتم را اجرا می‌کند تا توسعه‌دهندگان بتوانند به‌راحتی کپی‌های عمیقی از مقادیر جاوا اسکریپت ایجاد کنند.

const myDeepCopy = structuredClone(myOriginal);

همین! این کل میانای برنامه‌سازی کاربردی است. اگر می‌خواهید جزئیات بیشتری بدانید، به مقاله MDN نگاهی بیندازید.

ویژگی‌ها و محدودیت‌ها

کلون‌سازی ساختاریافته بسیاری از کاستی‌های (نه همه) تکنیک JSON.stringify() را برطرف می‌کند. کلون‌سازی ساختاریافته می‌تواند ساختارهای داده چرخه‌ای را مدیریت کند، از بسیاری از انواع داده‌های داخلی پشتیبانی کند، و به‌طور کلی قوی‌تر و اغلب سریع‌تر است.

بااین‌حال، هنوز محدودیت‌هایی دارد که ممکن است شما را غافلگیر کند:

  • نمونه‌های اولیه: اگر از structuredClone() با نمونه کلاس استفاده کنید، یک شیء ساده به‌عنوان مقدار برگشتی دریافت خواهید کرد، زیرا شبیه‌سازی ساختاریافته زنجیره نمونه اولیه شیء را حذف می‌کند.
  • توابع: اگر شیء شما حاوی توابع باشد، structuredClone() استثنای DataCloneError را ایجاد خواهد کرد.
  • غیرقابل‌کلون‌سازی: برخی‌از مقادیر کلون‌سازی ساختاریافته نیستند، به‌ویژه Error و گره‌های DOM. این باعث می‌شود structuredClone() پرتاب کند.

اگر هرکدام از این محدودیت‌ها برای مورد استفاده شما مشکل‌ساز است، کتابخانه‌هایی مانند Lodash همچنان پیاده‌سازی‌های سفارشی از دیگر الگوریتم‌های کلون‌سازی عمیق ارائه می‌دهند که ممکن است برای مورد استفاده شما مناسب باشند یا نباشند.

عملکرد

اگرچه مقایسه ریز محک جدیدی انجام نداده‌ام، در اوایل سال ۲۰۱۸ مقایسه‌ای انجام دادم، قبل‌از اینکه structuredClone() افشا شود. در آن زمان، JSON.parse() سریع‌ترین گزینه برای اشیای بسیار کوچک بود. انتظار دارم که همین‌طور باقی بماند. تکنیک‌هایی که به شبیه‌سازی ساختاریافته متکی بودند برای اشیاء بزرگ‌تر (به‌طور قابل‌توجهی) سریع‌تر بودند. با توجه به اینکه structuredClone() جدید بدون سربار سوءاستفاده از دیگر میاناهای برنامه‌سازی کاربردی ارائه می‌شود و نسبت‌به JSON.parse() قوی‌تر است، توصیه می‌کنم آن را به‌عنوان رویکرد پیش‌فرض خود برای ایجاد کپی‌های عمیق انتخاب کنید.

نتیجه‌گیری

اگر لازم است کپی عمیقی از مقداری در JS ایجاد کنید (شاید به این دلیل که از ساختارهای داده تغییرناپذیر استفاده می‌کنید یا می‌خواهید مطمئن شوید که تابع می‌تواند شیء را بدون تأثیر بر نسخه اصلی دستکاری کند)، دیگر نیازی به استفاده از راه‌حل‌های موقت یا کتابخانه‌ها ندارید. بوم‌سازگان JS اکنون structuredClone() دارد. هورا.