KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

DataCloneError-DOMException — fout bij het klonen van gegevens

DataCloneError is de naam van een DOMException die aangeeft dat gegevens niet kunnen worden gekloond. Lees over een veelvoorkomende oorzaak bij structuredClone(), hoe je de fout herkent en waarom een niet-ondersteunde waarde verschilt van een ondersteunde circulaire verwijzing.

Versie: 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 verwijst naar een DOMException-object met de naam "DataCloneError", niet naar een afzonderlijke DataCloneError-constructor. De historische code is 25 (DATA_CLONE_ERR); herken de fout aan name, niet aan de verouderde numerieke code.

structuredClone() werpt deze uitzondering synchroon op als een deel van de te klonen gegevens niet met structured cloning kan worden geserialiseerd. Functies en DOM-knooppunten worden niet ondersteund, ook niet binnen een gewoon object. Circulaire verwijzingen veroorzaken op zichzelf geen fout: het algoritme kan ze behouden. Dit algoritme wordt ook gebruikt om gegevens via postMessage() tussen Workers te versturen en om waarden in IndexedDB op te slaan.

In het voorbeeld bevat task een functie, waardoor de eerste kloonpoging een uitzondering oplevert. Het catch-blok handelt alleen de verwachte fout af en werpt andere fouten opnieuw op. De tweede kloon selecteert alleen gegevens. Geef ondersteunde waarden door in plaats van functies of DOM-knooppunten. Laat de test niet afhangen van de volledige tekst van message.

Dit is een Web API-mechanisme, geen functie die bij een bepaalde ECMAScript-editie hoort. Volgens MDN is structuredClone() sinds maart 2022 beschikbaar in de belangrijkste browsers; controleer de compatibiliteit voor je doelomgeving. Dat Node 24 in een repository aanwezig is, bewijst niet dat de API in de browser wordt ondersteund.

Voorbeelden

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);

Resultaat

DataCloneError
3

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen