Der strukturierte Klon-Algorithmus

Der strukturierte Klon-Algorithmus kopiert komplexe JavaScript-Objekte. Er wird intern verwendet, wenn structuredClone() aufgerufen wird, um Daten zwischen Workers über postMessage() zu übertragen, Objekte mit IndexedDB zu speichern oder Objekte für andere APIs zu kopieren.

Es wird durch Rekursion durch das Eingabeobjekt geklont, während eine Karte der bereits besuchten Referenzen erstellt wird, um das endlose Durchlaufen von Zyklen zu vermeiden.

Dinge, die mit dem strukturierten Klon nicht funktionieren

  • Function-Objekte können vom strukturierten Klon-Algorithmus nicht dupliziert werden; bei einem Versuch wird eine DataCloneError-Ausnahme ausgelöst.
  • Das Klonen von DOM-Knoten führt ebenso zu einer DataCloneError-Ausnahme.
  • Bestimmte Objekteigenschaften werden nicht beibehalten:
    • Die lastIndex-Eigenschaft von RegExp-Objekten wird nicht beibehalten.
    • Eigenschafts-Deskriptoren, Setter, Getter und ähnliche meta-datenähnliche Merkmale werden nicht dupliziert. Zum Beispiel, wenn ein Objekt mit einem Eigenschafts-Deskriptor als schreibgeschützt markiert ist, wird es in der Kopie schreibbar sein, da dies der Standard ist.
    • Die Prototypenkette wird nicht durchlaufen oder dupliziert.
    • Private Klassenelemente werden nicht dupliziert. (Obwohl interne Felder von eingebauten Typen möglicherweise doch.)

Unterstützte Typen

JavaScript-Typen

Fehlertypen

Für Error-Typen muss der Fehlername einer der folgenden sein: Error, EvalError, RangeError, ReferenceError, SyntaxError, TypeError, URIError (oder er wird auf "Error" gesetzt).

Browser müssen die Eigenschaften name und message serialisieren und sind angehalten, andere "interessante" Eigenschaften der Fehler wie stack, cause, usw. zu serialisieren.

AggregateError-Unterstützung soll zur Spezifikation in whatwg/html#5749 hinzugefügt werden (und wird bereits in einigen Browsern unterstützt).

Web/API-Typen

Hinweis: Serialisierbare Objekte sind in Web IDL-Dateien mit dem Attribut [Serializable] markiert.

Siehe auch