WorkerGlobalScope: Methode structuredClone()
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit März 2022 browserübergreifend verfügbar.
Hinweis: Diese Funktion ist nur in Web Workers verfügbar.
Die Methode structuredClone() der Schnittstelle WorkerGlobalScope erstellt mithilfe des Structured-Clone-Algorithmus eine tiefe Kopie eines übergebenen Werts.
Die Methode ermöglicht außerdem, transferierbare Objekte im ursprünglichen Wert auf das neue Objekt zu übertragen, statt sie zu klonen. Übertragene Objekte werden vom ursprünglichen Objekt getrennt und dem neuen Objekt zugeordnet. Im ursprünglichen Objekt sind sie anschließend nicht mehr zugänglich.
Syntax
structuredClone(value)
structuredClone(value, options)
Parameter
value-
Das zu klonende Objekt. Dies kann jeder strukturiert klonbare Typ sein.
optionsOptional-
Ein Objekt mit den folgenden Eigenschaften:
transfer-
Ein Array von transferierbaren Objekten, die in das zurückgegebene Objekt verschoben statt geklont werden.
Rückgabewert
Eine tiefe Kopie des ursprünglichen value.
Ausnahmen
DataCloneErrorDOMException-
Wird ausgelöst, wenn ein Teil des Eingabewerts nicht serialisierbar ist.
Beschreibung
Weitere Informationen zu dieser Funktion finden Sie unter Window.structuredClone().
Beispiele
Beispiele finden Sie unter Window.structuredClone().
Spezifikationen
| Spezifikation |
|---|
| HTML # dom-structuredclone |
Browser-Kompatibilität
Siehe auch
- Ein Polyfill für
structuredCloneist incore-jsverfügbar. - Structured-Clone-Algorithmus