WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

DataCloneError-DOMException — Fehler beim Klonen von Daten

DataCloneError ist der Name einer DOMException, die anzeigt, dass Daten nicht geklont werden können. Erfahre mehr über eine typische Ursache bei structuredClone(), wie du den Fehler erkennst und warum sich ein nicht unterstützter Wert von einer unterstützten zirkulären Referenz unterscheidet.

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, options)
error.name === "DataCloneError"

DataCloneError DOMException bezeichnet ein DOMException-Objekt mit dem Namen "DataCloneError", keinen eigenen DataCloneError-Konstruktor. Der historische Fehlercode lautet 25 (DATA_CLONE_ERR); erkenne den Fehler anhand von name, nicht anhand des veralteten numerischen Codes.

structuredClone() löst diese Ausnahme synchron aus, wenn irgendein Teil der zu klonenden Daten nicht strukturiert serialisierbar ist. Funktionen und DOM-Knoten werden nicht unterstützt, auch nicht innerhalb eines gewöhnlichen Objekts. Zirkuläre Referenzen allein verursachen keinen Fehler: Der Algorithmus kann sie erhalten. Dieser Algorithmus wird auch verwendet, um Daten mit postMessage() zwischen Workern zu senden und Werte in IndexedDB zu speichern.

Im Beispiel enthält task eine Funktion, daher löst der erste Klonversuch eine Ausnahme aus. Der catch-Block behandelt nur den erwarteten Fehler und löst alle anderen erneut aus. Beim zweiten Klonversuch werden nur Daten ausgewählt. Übergib unterstützte Werte statt Funktionen oder DOM-Knoten. Mache den Test nicht vom vollständigen Text in message abhängig.

Dies ist ein Web-API-Mechanismus und keine Funktion, die einer bestimmten ECMAScript-Ausgabe zugeordnet ist. Laut MDN ist structuredClone() seit März 2022 in den wichtigsten Browsern verfügbar; prüfe die Kompatibilität für deine Zielumgebung. Dass sich Node 24 in einem Repository befindet, beweist nicht, dass die API im Browser unterstützt wird.

Beispiele

const value = { count: 3, task: () => 42 };

try {
  structuredClone(value);
} catch (error) {
  if (!(error instanceof DOMException) || error.name !== "DataCloneError") {
    throw error;
  }
  console.log(error.name);
}

const copy = structuredClone({ count: value.count });
console.log(copy.count);

Ergebnis

DataCloneError
3

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.

Quellen