⚡ Fix structuredClone Dropping a Class’s Methods
`structuredClone()` implements the HTML structured clone algorithm, which deep-copies DATA — plain objects, arrays, Maps, Sets, Dates — but does not preserve a custom class’s prototype chain. Cloning an instance of a class with methods produces a plain object with the same own properties but a prototype reset to `Object.prototype`, so every method defined on the class is simply gone from the clone — invisible until code calls `clone.someMethod()` and gets a `TypeError`, often far from wherever the clone itself was made.
🔎 The Problem
class Order {
constructor(id, total) { this.id = id; this.total = total; }
formattedTotal() { return `$${this.total.toFixed(2)}`; }
}
const order = new Order(42, 19.5);
const bad = structuredClone(order);
// bad.formattedTotal is undefined - the prototype was not preserved
// Fix: clone the plain data, then re-attach the class
const fixed = Object.assign(
new Order(0, 0),
structuredClone({ id: order.id, total: order.total })
);
fixed.formattedTotal(); // "$19.50"
✅ Fix: Clone the Data, Rebuild the Instance
- Treat `structuredClone()` as a data cloner, not an object cloner — call it only on the plain-data shape of a class instance, then reconstruct a real instance from that data rather than passing the instance itself and hoping its methods survive.
- If a class genuinely needs to be clone-aware, expose a plain `toData()` method and a matching static `fromData()` constructor, and always route cloning through that pair instead of calling `structuredClone` directly on instances.
- Add a runtime guard right after cloning a complex object — a quick check that a known method is still a function — so a lost prototype surfaces immediately as a clear error instead of a silent `undefined` that only breaks later.
🚨 Why This Is Dangerous
- Because the clone still looks correct in a `console.log()` — all the data is there, it just prints as a plain object — this failure mode is easy to miss in a quick manual check and tends to surface for the first time in production.
structuredClone promises to copy your data faithfully – it never promised to copy your class along with it.
