CKTIS / JavaScript
structuredClone(): globoko kopiranje in prenos podatkov
structuredClone() kopira podprte podatkovne strukture, vključno z vgnezdenimi objekti in cikli. Možnost transfer premakne vire, namesto da bi jih kopirala; klonirati ni mogoče vsake vrste vrednosti.
Različica: 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) sinhrono klonira podprte podatke. V kopiji ohrani cikle in ponovljene sklice na isti objekt. Med podprte vrste spadajo navadni objekti, polja, Date, Map, Set in ArrayBuffer.
Če je kloniranje objekta SharedArrayBuffer dovoljeno, je klon ločen objekt, vendar uporablja isti pomnilnik kot izvirnik. Spremembe, zapisane prek enega medpomnilnika, so vidne prek drugega tudi brez uporabe možnosti transfer.
To ni univerzalen način kopiranja primerkov razredov: prilagojeni prototipi, deskriptorji lastnosti in zasebna polja se ne ohranijo. Pri običajnih objektih kopira lastne naštevne lastnosti z nizi kot ključi; branje getterjev lahko izvede kodo. Funkcije in vrednosti Symbol, na katere naleti med serializacijo, povzročijo DOMException z imenom DataCloneError.
Možnost { transfer: [buffer] } prenese vir ArrayBuffer, namesto da bi kopirala njegove bajte. Izvirni medpomnilnik se odklopi, njegov byteLength pa postane 0. Seznam transfer virov ne doda v rezultat: dosegljivi morajo biti iz value, da lahko rezultat omogoča dostop do njih.
To je API standarda HTML, ne funkcija, uvedena v določeni izdaji ECMAScripta. Tabela združljivosti standarda navaja Chrome 98+, Firefox 94+ in Safari 15.4+. V ciljnem okolju preverite typeof structuredClone === "function"; Node 24 v repozitoriju ne potrjuje podpore v brskalnikih.
Primeri
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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.