Example

const source = { foo: 1, nested: { x: 1 } };

const result = bunshinClone(source);

console.log(result);
// { foo: 1, nested: { x: 1 } }

console.log(result === source); // false
console.log(result.nested === source.nested); // false

Supported Types

bunshin-clone correctly handles:

• Object (plain + prototype preserved)
• Array
• Map
• Set
• Date
• RegExp
• ArrayBuffer
• DataView
• TypedArray (Uint8Array, etc.)
• Error / DOMException
• Blob
• ImageData
• URL
• URLSearchParams

Circular ref

const a: any = { x: 1 };
a.self = a;

const result = bunshinClone(a);

result.self === result; // true

Descriptor Behavior

Default (fast path)

const source = {
  get x() {
    return 42;
  }
};

const result = bunshinClone(source);

result.x; // 42
// getter is NOT preserved

preserveDescriptors: true

const source = {};
Object.defineProperty(source, 'x', {
  get: () => 42,
  enumerable: true,
});

const result = bunshinClone(source, {
  preserveDescriptors: true,
});

Object.getOwnPropertyDescriptor(result, 'x')?.get;
// => preserved

Unsupported / Pass-through Types

Some values are returned as-is:

• Function
• WeakMap / WeakSet
• Proxy (not cloned)
• Other non-cloneable host objects

const fn = () => {};

bunshinClone(fn) === fn; // true

Design Notes

Deep clone (no structural sharing)

Unlike merge utilities, bunshin-clone always produces a new structure:

const source = { a: { b: 1 } };

const result = bunshinClone(source);

result !== source; // true
result.a !== source.a; // true

Getter / Setter behavior

• Default: evaluated and converted to value
• preserveDescriptors: preserved as-is

Descriptor safety

When preserveDescriptors is enabled:

• descriptors are cloned safely
• original object is never mutated
• errors are controlled via strictDescriptors

Performance

• No proxy / no diffing
• Minimal branching
• Fast path for plain objects and arrays
• Competitive with structuredClone in many cases

Comparison