Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

Algoritam strukturiranog kloniranja i prijenos vlasništva

structuredClone() kopira podržane strukture podataka te u kopiji čuva cikluse i ponovljene reference. Opcija transfer prenosi resurse umjesto da ih kopira i odvaja izvorni ArrayBuffer.

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: [buffer] })

structuredClone(value) klonira podržane podatke. Algoritam pamti već posjećene objekte: u rezultatu čuva cikluse i zajedničke reference, ali klonirani objekti imaju drukčiji identitet od svojih izvornika. Ovaj algoritam upotrebljavaju i postMessage() i IndexedDB.

Zaseban objekt ne mora imati vlastitu memoriju. Kloniranjem običnog ArrayBuffer bez prijenosa nastaje neovisna kopija njegovih bajtova, kao što pokazuje primjer. Kada je kloniranje SharedArrayBuffer dopušteno, klon je zaseban objekt međuspremnika koji s izvornikom dijeli istu memoriju.

Podržani tipovi uključuju obične objekte, nizove, Map, Set, Date, ArrayBuffer i tipizirane nizove. Funkcije, DOM čvorovi i vrijednosti symbol ne mogu se klonirati; nepodržana vrijednost u podacima uzrokuje DataCloneError. Algoritam ne čuva prilagođene prototipne lance, deskriptore svojstava, gettere/settere ni privatne elemente klasa. Stoga nije univerzalan način kopiranja instanci klasa.

structuredClone(value, { transfer: [buffer] }) prenosi vlasništvo nad resursom umjesto kopiranja njegovih bajtova. Izvorni ArrayBuffer se odvaja: njegov byteLength iznosi 0, a postojeći prikazi više ne omogućuju pristup podacima. Uint8Array može se klonirati, ali prenosi se njegov buffer, a ne sam prikaz. ArrayBuffer naveden na popisu transfer može se odvojiti čak i ako nije dostupan iz value. U tom se slučaju neće pojaviti u vraćenoj kopiji. Za prijenos nije potreban worker.

Riječ je o API-ju okruženja domaćina definiranom HTML standardom, a ne o značajci određenog izdanja ECMAScripta. MDN navodi široku dostupnost u preglednicima od ožujka 2022.; ciljano okruženje provjerite pomoću typeof structuredClone === "function". Node 24 u repozitoriju ne dokazuje podršku u preglednicima. Primjer uspoređuje kopiranje i prijenos te provjerava očuvanje ciklusa i aliasa.

Referentni identifikatori obuhvaćeni ovim unosom: Structured clone algorithm and transferable ownership.

Primjeri

const bytes = new Uint8Array([7, 8]);
const original = { bytes, alias: bytes };
original.self = original;

const copy = structuredClone(original);
copy.bytes[0] = 9;
console.log(copy !== original, copy.self === copy, copy.bytes === copy.alias);
console.log(original.bytes[0], copy.bytes[0]);

const moved = structuredClone(original, { transfer: [bytes.buffer] });
console.log(bytes.buffer.byteLength, moved.bytes.byteLength);
console.log(moved.bytes[0], moved.self === moved, moved.bytes === moved.alias);

Rezultat

true true true
7 9
0 2
7 true true

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori