CKTIS / JavaScript
structuredClone(): tiefes Kopieren und Datenübertragung
structuredClone() kopiert unterstützte Datenstrukturen einschließlich verschachtelter Objekte und Zyklen. Die Option transfer verschiebt Ressourcen, statt sie zu kopieren; nicht jeder Werttyp kann geklont werden.
Version: 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) klont unterstützte Daten synchron. Zyklen und wiederholte Verweise auf dasselbe Objekt bleiben innerhalb der Kopie erhalten. Zu den unterstützten Typen gehören einfache Objekte, Arrays, Date, Map, Set und ArrayBuffer.
Wenn das Klonen eines SharedArrayBuffer zulässig ist, ist der Klon ein eigenständiges Objekt, nutzt aber denselben Speicher wie das Original. Schreibzugriffe über einen der beiden Puffer sind auch ohne die Option transfer über den jeweils anderen Puffer sichtbar.
Die Funktion ist keine universelle Methode zum Kopieren von Klasseninstanzen: Benutzerdefinierte Prototypen, Eigenschaftsdeskriptoren und private Felder bleiben nicht erhalten. Bei gewöhnlichen Objekten werden eigene, aufzählbare Eigenschaften mit Zeichenfolgen als Schlüsseln kopiert; das Lesen von Gettern kann Code ausführen. Funktionen und Symbol-Werte, auf die während der Serialisierung gestoßen wird, lösen eine DOMException namens DataCloneError aus.
Die Option { transfer: [buffer] } überträgt eine ArrayBuffer-Ressource, statt ihre Bytes zu kopieren. Der ursprüngliche Puffer wird abgetrennt und sein byteLength wird zu 0. Die Liste transfer fügt dem Ergebnis keine Ressourcen hinzu: Sie müssen von value aus erreichbar sein, damit das Ergebnis Zugriff auf sie bietet.
Dies ist eine API des HTML-Standards und keine Funktion, die in einer bestimmten ECMAScript-Ausgabe eingeführt wurde. Die Kompatibilitätstabelle des Standards führt Chrome 98+, Firefox 94+ und Safari 15.4+ auf. Prüfe typeof structuredClone === "function" in der Zielumgebung; Node 24 in einem Repository belegt keine Browserunterstützung.
Beispiele
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);Ergebnis
1 2 true true 0 4
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.