deep-clone

IDeepClone resolves to DefaultDeepClone. It receives IDeepCloneList via multi-inject and tries each clone implementation in injected order until one succeeds.

In the default module configuration, list order is: StructuredDeepClone then LodashDeepClone. If one strategy throws, the next strategy is attempted.

LodashDeepClone unwraps proxy-wrapped values to their original targets using IProxyRegistry. During clone traversal it also calls IDeepCloneExcept (default: DefaultDeepCloneExcept) to substitute special values, such as Promise/Observable with their last resolved/emitted value.

import {
  InjectionContainer,
  type IDeepClone,
  RsXCoreInjectionTokens,
  RsXCoreModule,
} from '@rs-x/core';

await InjectionContainer.load(RsXCoreModule);

const deepClone = InjectionContainer.get(
  RsXCoreInjectionTokens.IDeepClone,
) as IDeepClone;

const source = {
  user: { id: 1, name: 'Ada' },
  tags: ['core', 'docs'],
};

const cloned = deepClone.clone(source) as typeof source;

console.log(cloned.user.name); // Ada
console.log(cloned === source); // false

Register your own IDeepClone implementation and override IDeepCloneList order. Earlier entries run first, so put domain-specific strategies before generic fallbacks.

• DeepCloneValueExceptclassHandles special-case value substitutions during deep cloning (for example resolved async values).→
• DefaultDeepCloneclassCoordinates the deep-clone pipeline and returns the first successful clone result.→
• IDeepCloneinterfaceService for creating deep copies of values.→
• IDeepCloneExceptinterfaceService for special-case value substitutions during deep cloning.→
• LodashDeepCloneclassDeep-clone service implementation that uses lodash to clone values.→
• StructuredDeepCloneclassDeep-clone service implementation that uses native structuredClone.→