Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten.Erfahre mehr über dieses Experiment.
WorkerGlobalScope: structuredClone()-Methode
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since März 2022.
Hinweis: Diese Funktion ist nur inWeb Workers verfügbar.
DiestructuredClone()-Methode derWorkerGlobalScope-Schnittstelle erstellt einetiefe Kopie eines gegebenen Werts unter Verwendung desStructured Clone Algorithmus.
Die Methode ermöglicht es auch,transferierbare Objekte im ursprünglichen Wert zuübertragen statt sie in das neue Objekt zu klonen. Übertragene Objekte werden vom ursprünglichen Objekt abgelöst und dem neuen Objekt angehängt; sie sind im ursprünglichen Objekt nicht mehr zugänglich.
Syntax
structuredClone(value)structuredClone(value, options)Parameter
valueDas zu klonende Objekt.Dies kann jederstrukturklonbare Typ sein.
optionsOptionalEin Objekt mit den folgenden Eigenschaften:
transferEin Array vontransferierbaren Objekten, die statt zu klonen in das zurückgegebene Objekt verschoben werden.
Rückgabewert
Einetiefe Kopie des ursprünglichenvalue.
Ausnahmen
DataCloneErrorDOMExceptionWird ausgelöst, wenn ein Teil des Eingabewerts nicht serialisierbar ist.
Beschreibung
SieheWindow.structuredClone() für Details zu dieser Funktion.
Beispiele
SieheWindow.structuredClone() für Beispiele.
Spezifikationen
| Specification |
|---|
| HTML # dom-structuredclone |