structuredClone()

Syntax

const copy = structuredClone(original);

Examples

const original = {
  name: "Alice",
  address: { city: "London", zip: "SW1A" },
  tags: ["admin", "verified"]
};

const clone = structuredClone(original);
clone.address.city = "Manchester";

console.log(original.address.city); // "London" - unaffected
console.log(clone.address.city);    // "Manchester"

const data = {
  createdAt: new Date(),
  tags: new Set(["a", "b"]),
  scores: new Map([["math", 90]])
};

const clone = structuredClone(data);
console.log(clone.createdAt instanceof Date); // true - stays a real Date
console.log(clone.tags instanceof Set);        // true - stays a real Set

// JSON.parse(JSON.stringify(data)) would turn createdAt into a string,
// and silently lose the Set and Map entirely

Best practices

• Use structuredClone() instead of JSON.parse(JSON.stringify(obj)) for deep copies - it is faster, handles more types, and supports circular references
• Remember it cannot clone functions, DOM nodes, or objects with prototype chains beyond plain data (like class instances lose their class)
• Use it for genuinely deep copies - for shallow copies, spread syntax ({...obj}) is simpler and sufficient
• Check runtime support if targeting very old browsers, though it is now broadly available in all modern environments

At a glance

Purpose

Application logic and interaction

File extension

.js · .mjs

Runs in

Browsers and JavaScript runtimes

Usually used with

HTML, CSS and Web APIs

Specifications & further reading

• ECMAScript specification

Related JavaScript documentation