Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

structuredClone(): hlboké kopírovanie a prenos údajov

structuredClone() kopíruje podporované dátové štruktúry vrátane vnorených objektov a cyklov. Voľba transfer presúva prostriedky namiesto ich kopírovania; klonovať sa nedá každý typ hodnoty.

Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

structuredClone(value)
structuredClone(value, { transfer: [transferable] })

structuredClone(value, options) synchrónne klonuje podporované údaje. V kópii zachová cykly aj opakované odkazy na ten istý objekt. Medzi podporované typy patria bežné objekty, polia, Date, Map, Set a ArrayBuffer.

Ak je klonovanie objektu SharedArrayBuffer povolené, klon je samostatný objekt, ale používa tú istú pamäť ako originál. Zmeny zapísané prostredníctvom jedného buffera možno pozorovať prostredníctvom druhého aj bez použitia voľby transfer.

Nie je to univerzálny spôsob kopírovania inštancií tried: vlastné prototypy, deskriptory vlastností ani súkromné polia sa nezachovajú. Pri bežných objektoch kopíruje vlastné enumerovateľné vlastnosti s reťazcovými kľúčmi; čítanie getterov môže spustiť kód. Funkcie a hodnoty Symbol, na ktoré narazí počas serializácie, spôsobia výnimku DOMException s názvom DataCloneError.

Voľba { transfer: [buffer] } prenesie prostriedok ArrayBuffer namiesto kopírovania jeho bajtov. Pôvodný buffer sa odpojí a jeho byteLength bude 0. Zoznam transfer nepridáva prostriedky do výsledku: musia byť dosiahnuteľné z value, aby k nim výsledok umožňoval prístup.

Ide o API štandardu HTML, nie o funkciu zavedenú v konkrétnom vydaní ECMAScriptu. Tabuľka kompatibility štandardu uvádza Chrome 98+, Firefox 94+ a Safari 15.4+. V cieľovom prostredí skontrolujte typeof structuredClone === "function"; Node 24 v repozitári nepotvrdzuje podporu v prehliadačoch.

Príklady

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);

Výsledok

1 2
true true
0 4

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje