Platform ini kini dilengkapi dengan structuredClone(), fungsi bawaan untuk deep-copying.
Selama ini, Anda harus menggunakan solusi dan library untuk membuat salinan mendalam dari nilai JavaScript. Platform ini kini dilengkapi dengan structuredClone(), fungsi bawaan untuk deep-copying.
Salinan dangkal
Menyalin nilai di JavaScript hampir selalu bersifat dangkal, bukan mendalam. Artinya, perubahan pada nilai bertingkat yang dalam akan terlihat di salinan dan juga di dokumen asli.
Salah satu cara untuk membuat salinan dangkal di JavaScript menggunakan operator spread objek ...:
const myOriginal = {
someProp: "with a string value",
anotherProp: {
withAnotherProp: 1,
andAnotherProp: true
}
};
const myShallowCopy = {...myOriginal};
Menambahkan atau mengubah properti secara langsung pada salinan dangkal hanya akan memengaruhi salinan, bukan aslinya:
myShallowCopy.aNewProp = "a new value";
console.log(myOriginal.aNewProp)
// ^ logs `undefined`
Namun, menambahkan atau mengubah properti bertingkat dalam akan memengaruhi salinan dan aslinya:
myShallowCopy.anotherProp.aNewProp = "a new value";
console.log(myOriginal.anotherProp.aNewProp)
// ^ logs `a new value`
Ekspresi {...myOriginal} melakukan iterasi pada properti (yang dapat dihitung) dari myOriginal menggunakan Spread Operator. Fungsi ini menggunakan nama dan nilai properti, lalu menetapkannya satu per satu ke objek kosong yang baru dibuat. Dengan demikian, objek yang dihasilkan memiliki bentuk yang sama, tetapi dengan salinan daftar properti dan nilainya sendiri. Nilainya juga disalin, tetapi nilai yang disebut primitif ditangani secara berbeda oleh nilai JavaScript dibandingkan dengan nilai non-primitif. Untuk mengutip MDN:
Dalam JavaScript, primitif (nilai primitif, jenis data primitif) adalah data yang bukan objek dan tidak memiliki metode. Ada tujuh jenis data primitif: string, number, bigint, boolean, undefined, symbol, dan null.
MDN — Primitif
Nilai non-primitif ditangani sebagai referensi, yang berarti tindakan menyalin nilai sebenarnya hanya menyalin referensi ke objek pokok yang sama, sehingga menghasilkan perilaku salinan dangkal.
Deep copy
Kebalikan dari salinan dangkal adalah salinan dalam. Algoritma salinan mendalam juga menyalin properti objek satu per satu, tetapi memanggil dirinya sendiri secara rekursif saat menemukan referensi ke objek lain, sehingga membuat salinan objek tersebut juga. Hal ini dapat sangat penting untuk memastikan bahwa dua bagian kode tidak secara tidak sengaja berbagi objek dan tanpa disadari memanipulasi status satu sama lain.
Dulu, tidak ada cara yang mudah atau bagus untuk membuat deep copy nilai di JavaScript. Banyak orang mengandalkan library pihak ketiga seperti fungsi cloneDeep() Lodash. Solusi paling umum untuk masalah ini adalah peretasan berbasis JSON:
const myDeepCopy = JSON.parse(JSON.stringify(myOriginal));
Faktanya, ini adalah solusi yang sangat populer, sehingga V8 secara agresif mengoptimalkan JSON.parse() dan khususnya pola di atas untuk membuatnya secepat mungkin. Meskipun cepat, cara ini memiliki beberapa kekurangan dan jebakan:
- Struktur data rekursif:
JSON.stringify()akan menampilkan error saat Anda memberinya struktur data rekursif. Hal ini dapat terjadi dengan mudah saat menggunakan daftar atau hierarki tertaut. - Jenis bawaan:
JSON.stringify()akan menampilkan error jika nilai berisi bawaan JS lainnya sepertiMap,Set,Date,RegExp, atauArrayBuffer. - Fungsi:
JSON.stringify()akan menghapus fungsi secara otomatis.
Cloning terstruktur
Platform ini sudah memerlukan kemampuan untuk membuat salinan mendalam nilai JavaScript di beberapa tempat: Menyimpan nilai JS di IndexedDB memerlukan beberapa bentuk serialisasi agar dapat disimpan di disk dan kemudian dideserialisasi untuk memulihkan nilai JS. Demikian pula, mengirim pesan ke WebWorker melalui postMessage() memerlukan transfer nilai JS dari satu realm JS ke realm JS lainnya. Algoritma yang digunakan untuk ini disebut “Structured Clone”, dan hingga saat ini, tidak mudah diakses oleh developer.
Sekarang, hal itu telah berubah. Spesifikasi HTML diubah untuk mengekspos fungsi yang disebut structuredClone() yang menjalankan algoritma tersebut sebagai cara bagi developer untuk membuat salinan mendalam nilai JavaScript dengan mudah.
const myDeepCopy = structuredClone(myOriginal);
Selesai! Itulah keseluruhan API. Jika Anda ingin mempelajari detailnya lebih lanjut, lihat artikel MDN.
Fitur dan batasan
Cloning terstruktur mengatasi banyak (meskipun tidak semua) kekurangan teknik JSON.stringify(). Cloning terstruktur dapat menangani struktur data siklus, mendukung banyak jenis data bawaan, dan umumnya lebih andal serta sering kali lebih cepat.
Namun, masih ada beberapa batasan yang mungkin membuat Anda lengah:
- Prototipe: Jika Anda menggunakan
structuredClone()dengan instance class, Anda akan mendapatkan objek biasa sebagai nilai yang ditampilkan, karena cloning terstruktur akan menghapus rantai prototipe objek. - Fungsi: Jika objek Anda berisi fungsi,
structuredClone()akan menampilkan pengecualianDataCloneError. - Non-cloneable: Beberapa nilai tidak dapat di-clone secara terstruktur, terutama
Errordan node DOM. Hal ini akan menyebabkanstructuredClone()menampilkan error.
Jika salah satu batasan ini menjadi penghalang untuk kasus penggunaan Anda, library seperti Lodash masih menyediakan implementasi kustom dari algoritma deep-cloning lainnya yang mungkin sesuai atau tidak sesuai dengan kasus penggunaan Anda.
Performa
Meskipun saya belum melakukan perbandingan micro-benchmark baru, saya melakukan perbandingan pada awal tahun 2018, sebelum structuredClone() terekspos. Saat itu, JSON.parse() adalah opsi tercepat untuk objek yang sangat kecil. Saya berharap hal itu akan tetap sama. Teknik yang mengandalkan cloning terstruktur (secara signifikan) lebih cepat untuk objek yang lebih besar. Mengingat structuredClone() baru hadir tanpa overhead penyalahgunaan API lain dan lebih andal daripada JSON.parse(), sebaiknya jadikan API ini sebagai pendekatan default Anda untuk membuat salinan mendalam.
Kesimpulan
Jika Anda perlu membuat salinan mendalam dari suatu nilai di JS—mungkin karena Anda menggunakan struktur data yang tidak dapat diubah atau Anda ingin memastikan fungsi dapat memanipulasi objek tanpa memengaruhi objek aslinya—Anda tidak perlu lagi menggunakan solusi atau library. Ekosistem JS kini memiliki structuredClone(). Hore.