@creejs/commons-lang 2.1.18 → 2.1.19

package/dist/cjs/index-dev.cjs

@@ -14,7 +14,9 @@ var LangUtils = {
   extends: extend,
   equals: equals$2,
   isBrowser,
-  isNode
+  isNode,
+  cloneToPlainObject,
+  deepCloneToPlainObject
 };
 
 /**
@@ -72,6 +74,41 @@ function extend (target, ...sources) {
   return target
 }
 
+/**
+ * Creates a shallow clone of an object by copying its enumerable properties to a new plain object.
+ * 1. This returns a PlainObject
+ * 2. It lose the type information of the original object
+ * 3. Shallow clone, copy only the first level properties
+ * @param {{[key:string]: any}} obj - The object to clone.
+ * @returns {{[key:string]: any}} A new plain object with the same enumerable properties as the input object.
+ */
+function cloneToPlainObject (obj) {
+  if (obj == null) {
+    return obj
+  }
+  if (typeof obj !== 'object') {
+    throw new Error('Only Object allowed to clone')
+  }
+  return { ...obj }
+}
+
+/**
+ * Deep clones an object by converting it to JSON and back to a plain object.
+ * 1. This will lose any non-JSON-serializable properties (e.g. functions, Symbols).
+ * 2. Only Use this to clone PlainObject
+ * @param {{[key:string]: any}} obj - The object to clone
+ * @returns {{[key:string]: any}} A new plain object with the cloned properties
+ */
+function deepCloneToPlainObject (obj) {
+  if (obj == null) {
+    return obj
+  }
+  if (typeof obj !== 'object') {
+    throw new Error('Only Object allowed to clone')
+  }
+  return JSON.parse(JSON.stringify(obj))
+}
+
 /**
  * Compares two values for equality
  * 1. First checks strict equality (===),