CKTIS / JavaScript
structuredClone(): duboko kopiranje i prijenos podataka
structuredClone() kopira podržane podatkovne strukture, uključujući ugniježđene objekte i cikluse. Opcija transfer premješta resurse umjesto da ih kopira; ne može se klonirati svaka vrsta vrijednosti.
Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
structuredClone(value)
structuredClone(value, { transfer: [transferable] })structuredClone(value, options) sinkrono klonira podržane podatke. U kopiji čuva cikluse i ponovljene reference na isti objekt. Podržane vrste uključuju obične objekte, polja, Date, Map, Set i ArrayBuffer.
Kad je kloniranje objekta SharedArrayBuffer dopušteno, klon je zaseban objekt, ali upotrebljava istu memoriju kao i izvornik. Promjene zapisane preko jednog međuspremnika vidljive su preko drugoga i bez upotrebe opcije transfer.
To nije univerzalan način kopiranja instanci klasa: prilagođeni prototipovi, deskriptori svojstava i privatna polja ne čuvaju se. Za obične objekte kopira vlastita nabrojiva svojstva čiji su ključevi nizovi znakova; čitanje gettera može izvršiti kod. Funkcije i vrijednosti Symbol na koje naiđe tijekom serijalizacije uzrokuju DOMException naziva DataCloneError.
Opcija { transfer: [buffer] } prenosi resurs ArrayBuffer umjesto kopiranja njegovih bajtova. Izvorni se međuspremnik odvaja, a njegov byteLength postaje 0. Popis transfer ne dodaje resurse u rezultat: moraju biti dostupni iz value kako bi im rezultat omogućio pristup.
Ovo je API standarda HTML, a ne značajka uvedena u određenom izdanju ECMAScripta. Tablica kompatibilnosti standarda navodi Chrome 98+, Firefox 94+ i Safari 15.4+. U ciljnom okruženju provjerite typeof structuredClone === "function"; Node 24 u repozitoriju ne potvrđuje podršku u preglednicima.
Primjeri
const original = { items: [{ count: 1 }] };
original.self = original;
const copy = structuredClone(original);
copy.items[0].count = 2;
console.log(original.items[0].count, copy.items[0].count);
console.log(copy !== original, copy.self === copy);
const buffer = new ArrayBuffer(4);
const moved = structuredClone({ buffer }, { transfer: [buffer] });
console.log(buffer.byteLength, moved.buffer.byteLength);Rezultat
1 2 true true 0 4
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.