CKTIS / JavaScript
DOMException DataCloneError — error al clonar datos
DataCloneError es el nombre de una DOMException que indica que los datos no se pueden clonar. Aprende una causa habitual con structuredClone(), cómo reconocer el error y por qué un valor no admitido es distinto de una referencia circular que sí se admite.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
structuredClone(value)
structuredClone(value, options)
error.name === "DataCloneError"DataCloneError DOMException se refiere a un objeto DOMException cuyo name es "DataCloneError", no a un constructor DataCloneError independiente. Su código histórico es 25 (DATA_CLONE_ERR); identifica el error mediante name, no con el código numérico obsoleto.
structuredClone() lanza esta excepción de forma síncrona cuando cualquier parte de los datos que se van a clonar no se puede serializar mediante el algoritmo de clonación estructurada. Las funciones y los nodos DOM no son compatibles, ni siquiera dentro de un objeto normal. Las referencias circulares, por sí solas, no provocan un error: el algoritmo puede conservarlas. Este algoritmo también se usa para enviar datos mediante postMessage() entre Workers y para almacenar valores en IndexedDB.
En el ejemplo, task contiene una función, por lo que el primer intento de clonación lanza una excepción. El bloque catch solo gestiona el error esperado y vuelve a lanzar cualquier otro. El segundo clon selecciona únicamente datos. Pasa valores compatibles en lugar de funciones o nodos DOM. No hagas que la prueba dependa del texto completo de message.
Este es un mecanismo de Web API, no una función asignada a una edición concreta de ECMAScript. MDN indica que structuredClone() está disponible en los principales navegadores desde marzo de 2022; comprueba la compatibilidad con el entorno de destino. La presencia de Node 24 en un repositorio no demuestra que la API sea compatible con el navegador.
Ejemplos
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);Resultado
DataCloneError 3
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.