@codady/utils 0.0.11 → 0.0.13

package/src/isEmpty.js

@@ -0,0 +1,45 @@
+/**
+ * @since Last modified: 2025/12/25 14:22:26
+ * @function isEmpty
+ * @description Determine whether it is empty data.The data itself is empty data: 0| ''|false|undefined|null; <br>empty function: function () {}|() => {}; <br>empty array and empty objects: []|{}| [null]| [ undefined]| ['']| [""];<br> empty symbol object: symbol()|symbol.For(), will be judged as empty.
+ * @param {*} data  - Can be any data
+ * @returns {boolean}  - Return true or false
+ * @example
+ * ax.isEmpty([null]);
+ * <!--return true-->
+ */
+//简介：判断是否为空数据。本身为空的数据：0|''|false|undefined|null；空函数：function(){}|()=>{}；空数组和空对象：[]|{}|[null]|[undefined]|['']|[""]；空Symbol对象：Symbol()|Symbol.for()，都将判断为空。
+//返回：true或false
+'use strict';
+import getDataType from './getDataType';
+const isEmpty = (data) => {
+    let type = getDataType(data), flag;
+    if (!data) {
+        //0,'',false,undefined,null
+        flag = true;
+    }
+    else {
+        //function(){}|()=>{}
+        //[null]|[undefined]|['']|[""]
+        //[]|{}
+        //Symbol()|Symbol.for()
+        //Set,Map
+        //Date/Regex
+        flag = (type === 'Object') ? (Object.keys(data).length === 0) :
+            (type === 'Array') ? data.join('') === '' :
+                (type === 'Function') ? (data.toString().replace(/\s+/g, '').match(/{.*}/g)[0] === '{}') :
+                    (type === 'Symbol') ? (data.toString().replace(/\s+/g, '').match(/\(.*\)/g)[0] === '()') :
+                        (type === 'Set' || type === 'Map') ? data.size === 0 :
+                            type === 'Date' ? isNaN(data.getTime()) :
+                                type === 'RegExp' ? data.source === '' :
+                                    type === 'ArrayBuffer' ? data.byteLength === 0 :
+                                        (type === 'NodeList' || type === 'HTMLCollection') ? data.length === 0 :
+                                            ('length' in data && typeof data.length === 'number') ? data.length === 0 :
+                                                ('size' in data && typeof data.size === 'number') ? data.size === 0 :
+                                                    (type === 'Error' || data instanceof Error) ? data.message === '' :
+                                                        (type.includes('Array') && (['Uint8Array', 'Int8Array', 'Uint16Array', 'Int16Array', 'Uint32Array', 'Int32Array', 'Float32Array', 'Float64Array'].includes(type))) ? data.length === 0 :
+                                                            false;
+    }
+    return flag;
+};
+export default isEmpty;

package/src/isEmpty.ts

@@ -0,0 +1,44 @@
+/**
+ * @since Last modified: 2025/12/25 14:22:26
+ * @function isEmpty
+ * @description Determine whether it is empty data.The data itself is empty data: 0| ''|false|undefined|null; <br>empty function: function () {}|() => {}; <br>empty array and empty objects: []|{}| [null]| [ undefined]| ['']| [""];<br> empty symbol object: symbol()|symbol.For(), will be judged as empty.
+ * @param {*} data  - Can be any data
+ * @returns {boolean}  - Return true or false
+ * @example
+ * ax.isEmpty([null]);
+ * <!--return true-->
+ */
+//简介：判断是否为空数据。本身为空的数据：0|''|false|undefined|null；空函数：function(){}|()=>{}；空数组和空对象：[]|{}|[null]|[undefined]|['']|[""]；空Symbol对象：Symbol()|Symbol.for()，都将判断为空。
+//返回：true或false
+'use strict';
+import getDataType from './getDataType';
+const isEmpty = (data: any): boolean => {
+    let type = getDataType(data), flag: boolean;
+    if (!data) {
+        //0,'',false,undefined,null
+        flag = true;
+    } else {
+        //function(){}|()=>{}
+        //[null]|[undefined]|['']|[""]
+        //[]|{}
+        //Symbol()|Symbol.for()
+        //Set,Map
+        //Date/Regex
+        flag = (type === 'Object') ? (Object.keys(data).length === 0) :
+            (type === 'Array') ? data.join('') === '' :
+                (type === 'Function') ? (data.toString().replace(/\s+/g, '').match(/{.*}/g)[0] === '{}') :
+                    (type === 'Symbol') ? (data.toString().replace(/\s+/g, '').match(/\(.*\)/g)[0] === '()') :
+                        (type === 'Set' || type === 'Map') ? data.size === 0 :
+                            type === 'Date' ? isNaN(data.getTime()) :
+                                type === 'RegExp' ? data.source === '' :
+                                    type === 'ArrayBuffer' ? data.byteLength === 0 :
+                                        (type === 'NodeList' || type === 'HTMLCollection') ? data.length === 0 :
+                                            ('length' in data && typeof data.length === 'number') ? data.length === 0 :
+                                                ('size' in data && typeof data.size === 'number') ? data.size === 0 :
+                                                    (type === 'Error' || data instanceof Error) ? data.message === '' :
+                                                        (type.includes('Array') && (['Uint8Array', 'Int8Array', 'Uint16Array', 'Int16Array', 'Uint32Array', 'Int32Array', 'Float32Array', 'Float64Array'].includes(type))) ? data.length === 0 :
+                                                            false;
+    }
+    return flag;
+}
+export default isEmpty;

package/src/mapMutableMethods - /345/211/257/346/234/254.js"

@@ -0,0 +1,5 @@
+/**
+ * Available Map mutation methods
+ */
+export const mapMutableMethods = ['set', 'delete', 'clear'];
+export default mapMutableMethods;

package/src/shallowCopy.js

@@ -0,0 +1,78 @@
+/**
+ * @since Last modified: 2025/12/25 14:29:53
+ * shallowCopy
+ *
+ * This function performs a shallow copy of various data structures:
+ * - Set
+ * - Map
+ * - Array
+ * - Plain Object (including properties with Symbol keys)
+ * - Date
+ * - RegExp
+ * - Buffer (Node.js)
+ * - ArrayBuffer and Typed Arrays
+ * - WeakSet
+ * - WeakMap
+ * - Error
+ *
+ * It returns a new instance of the data structure, but the elements or properties of reference types (such as objects or arrays) will be copied by reference.
+ * Primitive types (e.g., number, string, boolean) will be returned directly.
+ */
+'use strict';
+import copyObjectWithSymbol from "./copyObjectWithSymbol";
+import getDataType from "./getDataType";
+const shallowCopy = (data, options = {}) => {
+    const dataType = getDataType(data);
+    // Check if data is a Set
+    if (dataType === 'Set') {
+        // Shallow copy Set
+        return new Set([...data]);
+    }
+    // Check if data is a Map
+    if (dataType === 'Map') {
+        // Shallow copy Map
+        return new Map([...data]);
+    }
+    // Check if data is an Array
+    if (Array.isArray(data)) {
+        // Shallow copy Array
+        return [...data];
+    }
+    // Check if data is a Plain Object (including Symbol keys)
+    if (dataType === 'object') {
+        // Ensure the object type includes string and symbol keys
+        // Shallow copy the object and include the Symbol properties
+        return copyObjectWithSymbol(data);
+    }
+    // Check if data is a Date
+    if (dataType === 'Date') {
+        return new Date(data.getTime());
+    }
+    // Check if data is a RegExp
+    if (dataType === 'RegExp') {
+        return new RegExp(data.source, data.flags);
+    }
+    // Check if data is a Buffer (for Node.js)
+    if (dataType === 'Buffer') {
+        return Buffer.from(data);
+    }
+    // Check if data is an ArrayBuffer or TypedArray
+    if (dataType === 'ArrayBuffer' || ArrayBuffer.isView(data)) {
+        return data.slice(0);
+    }
+    // Check if data is a WeakSet
+    if (dataType === 'WeakSet') {
+        return new WeakSet([...data]);
+    }
+    // Check if data is a WeakMap
+    if (dataType === 'WeakMap') {
+        return new WeakMap([...data]);
+    }
+    // Check if data is an Error
+    if (dataType === 'Error') {
+        return new Error(data.message);
+    }
+    // For other types (such as numbers, strings, booleans, etc.), return the original value
+    return data;
+};
+export default shallowCopy;

package/src/shallowCopy.ts

@@ -0,0 +1,93 @@
+/**
+ * @since Last modified: 2025/12/25 14:29:53
+ * shallowCopy
+ * 
+ * This function performs a shallow copy of various data structures:
+ * - Set
+ * - Map
+ * - Array
+ * - Plain Object (including properties with Symbol keys)
+ * - Date
+ * - RegExp
+ * - Buffer (Node.js)
+ * - ArrayBuffer and Typed Arrays
+ * - WeakSet
+ * - WeakMap
+ * - Error
+ * 
+ * It returns a new instance of the data structure, but the elements or properties of reference types (such as objects or arrays) will be copied by reference.
+ * Primitive types (e.g., number, string, boolean) will be returned directly.
+ */
+'use strict';
+
+import copyObjectWithSymbol from "./copyObjectWithSymbol";
+import getDataType from "./getDataType";
+
+const shallowCopy = (data: any,options={}): any => {
+    const dataType = getDataType(data);
+
+    // Check if data is a Set
+    if (dataType === 'Set') {
+        // Shallow copy Set
+        return new Set([...data]);
+    }
+
+    // Check if data is a Map
+    if (dataType === 'Map') {
+        // Shallow copy Map
+        return new Map([...data]);
+    }
+
+    // Check if data is an Array
+    if (Array.isArray(data)) {
+        // Shallow copy Array
+        return [...data];
+    }
+
+    // Check if data is a Plain Object (including Symbol keys)
+    if (dataType === 'object') {
+        // Ensure the object type includes string and symbol keys
+        // Shallow copy the object and include the Symbol properties
+        return copyObjectWithSymbol(data);
+    }
+
+   // Check if data is a Date
+    if (dataType === 'Date') {
+        return new Date(data.getTime());
+    }
+
+    // Check if data is a RegExp
+    if (dataType === 'RegExp') {
+        return new RegExp(data.source, data.flags);
+    }
+
+    // Check if data is a Buffer (for Node.js)
+    if (dataType === 'Buffer') {
+        return Buffer.from(data);
+    }
+
+    // Check if data is an ArrayBuffer or TypedArray
+    if (dataType === 'ArrayBuffer' || ArrayBuffer.isView(data)) {
+        return data.slice(0);
+    }
+
+    // Check if data is a WeakSet
+    if (dataType === 'WeakSet') {
+        return new WeakSet([...data]);
+    }
+
+    // Check if data is a WeakMap
+    if (dataType === 'WeakMap') {
+        return new WeakMap([...data]);
+    }
+
+    // Check if data is an Error
+    if (dataType === 'Error') {
+        return new Error(data.message);
+    }
+
+    // For other types (such as numbers, strings, booleans, etc.), return the original value
+    return data;
+};
+
+export default shallowCopy;