ConfigureClone kullanarak JavaScript'te derin kopyalama

Platform artık derin kopyalama için yerleşik bir işlev olan structuredClone() ile birlikte sunuluyor.

Uzun bir süre boyunca, bir JavaScript değerinin derin kopyasını oluşturmak için geçici çözümlere ve kitaplıklara başvurmanız gerekiyordu. Platform artık derin kopyalama için yerleşik bir işlev olan structuredClone() ile birlikte sunuluyor.

Browser Support

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

Source

Yüzeysel kopyalar

JavaScript'te bir değer kopyalama işlemi neredeyse her zaman derin değil, yüzeysel olur. Bu, derinlemesine iç içe yerleştirilmiş değerlerde yapılan değişikliklerin hem kopyada hem de orijinalde görüneceği anlamına gelir.

JavaScript'te nesne yayma operatörünü ... kullanarak sığ kopya oluşturmanın bir yolu:

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

const myShallowCopy = {...myOriginal};

Doğrudan sığ kopya üzerinde bir özellik eklemek veya değiştirmek yalnızca kopyayı etkiler, orijinali etkilemez:

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

Ancak, derinlemesine iç içe yerleştirilmiş bir özellik eklemek veya değiştirmek hem kopyayı hem de orijinali etkiler:

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

{...myOriginal} ifadesi, Spread operatörünü kullanarak myOriginal öğesinin (sayılabilir) özellikleri üzerinde iterasyon yapar. Özellik adını ve değerini kullanır ve bunları yeni oluşturulan boş bir nesneye tek tek atar. Bu nedenle, sonuçta elde edilen nesne şekil olarak aynıdır ancak kendi özellik ve değer listesi kopyasına sahiptir. Değerler de kopyalanır ancak ilkel değerler, JavaScript değeri tarafından ilkel olmayan değerlerden farklı şekilde işlenir. MDN'den alıntı yapacak olursak:

JavaScript'te ilkel (ilkel değer, ilkel veri türü), nesne olmayan ve yöntemi bulunmayan verilerdir. Yedi temel veri türü vardır: dize, sayı, bigint, boole, tanımsız, sembol ve boş.

MDN — İlkel

İlkel olmayan değerler referans olarak işlenir. Yani değeri kopyalama işlemi aslında yalnızca aynı temel nesneye bir referans kopyalamaktır. Bu da yüzeysel kopyalama davranışına neden olur.

Derin kopyalar

Yüzeysel kopyanın tersi derin kopyadır. Derin kopyalama algoritması da bir nesnenin özelliklerini tek tek kopyalar ancak başka bir nesneye referans bulduğunda kendisini yinelemeli olarak çağırarak o nesnenin de bir kopyasını oluşturur. Bu, iki kod parçasının yanlışlıkla bir nesneyi paylaşmamasını ve birbirlerinin durumunu bilmeden değiştirmemesini sağlamak için çok önemli olabilir.

JavaScript'te bir değerin derin kopyasını oluşturmanın kolay veya iyi bir yolu yoktu. Birçok kişi, Lodash'ın cloneDeep() işlevi gibi üçüncü taraf kitaplıklarını kullanıyordu. Bu sorunun en yaygın çözümü, JSON tabanlı bir hiledir:

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

Aslında bu o kadar popüler bir geçici çözümdü ki V8, JSON.parse() ve özellikle yukarıdaki kalıbı mümkün olduğunca hızlı hale getirmek için agresif bir şekilde optimize etti. Hızlı bir yöntem olsa da bazı eksiklikleri ve tuzakları vardır:

  • Özyinelemeli veri yapıları: JSON.stringify(), özyinelemeli bir veri yapısı verdiğinizde hata verir. Bağlı listeler veya ağaçlarla çalışırken bu durum kolayca gerçekleşebilir.
  • Yerleşik türler: Değer Map, Set, Date, RegExp veya ArrayBuffer gibi diğer JS yerleşik öğelerini içeriyorsa JSON.stringify() hata verir.
  • İşlevler: JSON.stringify(), işlevleri sessizce siler.

Yapılandırılmış klonlama

Platformun, JavaScript değerlerinin derin kopyalarını oluşturma özelliğine zaten birkaç yerde ihtiyacı vardı: Bir JS değerini IndexedDB'de depolamak için bir tür serileştirme gerekir. Böylece değer, diskte depolanabilir ve daha sonra JS değerini geri yüklemek için serileştirme kaldırılabilir. Benzer şekilde, postMessage() aracılığıyla bir WebWorker'a mesaj göndermek için bir JS değerinin bir JS alanından diğerine aktarılması gerekir. Bunun için kullanılan algoritmaya "Yapılandırılmış Klon" adı verilir ve yakın zamana kadar geliştiriciler bu algoritmaya kolayca erişemiyordu.

Bu durum artık değişti. HTML spesifikasyonu, geliştiricilerin JavaScript değerlerinin derin kopyalarını kolayca oluşturabilmesi için tam olarak bu algoritmayı çalıştıran structuredClone() adlı bir işlevi kullanıma sunacak şekilde değiştirildi.

const myDeepCopy = structuredClone(myOriginal);

Hepsi bu kadar! API'nin tamamı bu kadar. Ayrıntılı bilgi edinmek isterseniz MDN makalesine göz atın.

Özellikler ve sınırlamalar

Yapılandırılmış klonlama, JSON.stringify() tekniğinin tüm eksikliklerini olmasa da çoğunu giderir. Yapılandırılmış klonlama, döngüsel veri yapılarını işleyebilir, birçok yerleşik veri türünü destekler ve genellikle daha sağlam ve daha hızlıdır.

Ancak, sizi hazırlıksız yakalayabilecek bazı sınırlamaları vardır:

  • Prototipler: structuredClone() yöntemini bir sınıf örneğiyle kullanırsanız yapılandırılmış klonlama, nesnenin prototip zincirini attığı için dönüş değeri olarak düz bir nesne alırsınız.
  • İşlevler: Nesneniz işlevler içeriyorsa structuredClone(), DataCloneError istisnası oluşturur.
  • Klonlanamayanlar: Bazı değerler yapılandırılmış klonlanabilir değildir. Bunların başında Error ve DOM düğümleri gelir. structuredClone() öğesinin hata vermesine neden olur.

Bu sınırlamalardan herhangi biri kullanım alanınız için uygun değilse Lodash gibi kitaplıklar, kullanım alanınıza uygun olabilecek veya olmayabilecek diğer derin klonlama algoritmalarının özel uygulamalarını sunmaya devam eder.

Performans

Yeni bir mikro karşılaştırma yapmamış olsam da structuredClone() kullanıma sunulmadan önce, 2018'in başlarında bir karşılaştırma yapmıştım. O zamanlar JSON.parse(), çok küçük nesneler için en hızlı seçenekti. Bu durumun değişmeyeceğini düşünüyorum. Yapılandırılmış klonlamaya dayalı teknikler, daha büyük nesneler için (önemli ölçüde) daha hızlıydı. Yeni structuredClone(), diğer API'leri kötüye kullanma yükü olmadan sunulur ve JSON.parse() yönteminden daha sağlamdır. Bu nedenle, derin kopyalar oluşturmak için varsayılan yaklaşımınız olarak bu yöntemi kullanmanızı öneririz.

Sonuç

JS'de bir değerin derin kopyasını oluşturmanız gerekiyorsa (ör. sabit veri yapıları kullandığınız için veya bir işlevin orijinali etkilemeden bir nesneyi değiştirebileceğinden emin olmak istediğiniz için) artık geçici çözümlere veya kitaplıklara başvurmanız gerekmez. JS ekosisteminde artık structuredClone() var. Yaşasın!