lyb-js 1.6.33 → 1.6.34

package/Misc/LibJsDiffObject.d.ts

@@ -0,0 +1,8 @@
+/** @description 筛出已修改的值 */
+/**
+ * @description 深度对比对象差异（只返回新对象中发生变更的字段）
+ * - 基础类型：值不同则返回新值
+ * - 对象：递归 diff
+ * - 数组：不做 diff，值不同直接返回新数组
+ */
+export declare const libDiffObject: <T extends Record<string, any>>(oldObj: T, newObj: T) => Partial<Record<keyof T, any>>;

package/Misc/LibJsDiffObject.js

@@ -0,0 +1,48 @@
+/** @description 筛出已修改的值 */
+/**
+ * @description 深度对比对象差异（只返回新对象中发生变更的字段）
+ * - 基础类型：值不同则返回新值
+ * - 对象：递归 diff
+ * - 数组：不做 diff，值不同直接返回新数组
+ */
+export const libDiffObject = (oldObj, newObj) => {
+    const result = {};
+    const isObject = (val) => val !== null && typeof val === "object" && !Array.isArray(val);
+    Object.keys(newObj).forEach((key) => {
+        const oldVal = oldObj?.[key];
+        const newVal = newObj[key];
+        // 数组：不递归，值不同直接返回
+        if (Array.isArray(newVal)) {
+            if (!Array.isArray(oldVal) || oldVal.length !== newVal.length) {
+                result[key] = newVal;
+                return;
+            }
+            const changed = newVal.some((item, index) => {
+                const oldItem = oldVal[index];
+                // 对象递归
+                if (item && typeof item === "object" && !Array.isArray(item)) {
+                    return Object.keys(libDiffObject(oldItem || {}, item)).length > 0;
+                }
+                // 基础类型
+                return oldItem !== item;
+            });
+            if (changed) {
+                result[key] = newVal;
+            }
+            return;
+        }
+        // 对象：递归 diff
+        if (isObject(newVal)) {
+            const childDiff = libDiffObject(oldVal || {}, newVal);
+            if (Object.keys(childDiff).length > 0) {
+                result[key] = childDiff;
+            }
+            return;
+        }
+        // 基础类型
+        if (oldVal !== newVal) {
+            result[key] = newVal;
+        }
+    });
+    return result;
+};

package/Misc/LibJsPruneEmpty.js

@@ -7,7 +7,10 @@ export const libJsPruneEmpty = (obj) => {
                 acc[key] = value;
             return acc;
         }
-        if (value && typeof value === "object" && !Array.isArray(value)) {
+        if (value &&
+            typeof value === "object" &&
+            !Array.isArray(value) &&
+            !(value instanceof Date)) {
             const next = libJsPruneEmpty(value);
             if (next)
                 acc[key] = next;

package/README.md

@@ -155,6 +155,7 @@ console.log(libJsGetRowValue({ user: { name: "Tom" } }, "user.name")); // "Tom"
 - [LibJsEmitterClose-一次性关闭监听](#libjsemitterclose-一次性关闭监听)
 - [LibJsHorizontal-游戏横版状态](#libjshorizontal-游戏横版状态)
 - [LibJsNumberStepper-数字步进器](#libjsnumberstepper-数字步进器)
+- [LibJsDiffObject-筛出已修改的值](#libjsdiffobject-筛出已修改的值)
 - [LibJsPruneEmpty-对象属性去空值](#libjspruneempty-对象属性去空值)
 - [LibJsPullUpLoad-上拉加载](#libjspullupload-上拉加载)
 - [LibJsRegFormValidate-表单验证](#libjsregformvalidate-表单验证)
@@ -764,15 +765,39 @@ addButton.addEventListener("pointerdown", () => stepper.down("add"));
 subButton.addEventListener("pointerdown", () => stepper.down("sub"));
 ```
 
+### LibJsDiffObject-筛出已修改的值
+
+深度对比对象差异，只返回新对象中发生变更的字段。
+
+```ts
+import { libDiffObject } from "lyb-js/Misc/LibJsDiffObject";
+
+const oldObj = {
+  name: "Tom",
+  profile: { city: "Shanghai", age: 18 },
+  tags: [{ id: 1 }, { id: 2 }],
+};
+
+const newObj = {
+  name: "Jerry",
+  profile: { city: "Shanghai", age: 20 },
+  tags: [{ id: 1 }, { id: 3 }],
+};
+
+console.log(libDiffObject(oldObj, newObj));
+// { name: "Jerry", profile: { age: 20 }, tags: [{ id: 1 }, { id: 3 }] }
+```
+
 ### LibJsPruneEmpty-对象属性去空值
 
-递归移除对象中的空字符串、`null`、`undefined` 和空对象；空数组也会被去掉。
+递归移除对象中的空字符串、`null`、`undefined` 和空对象；空数组也会被去掉。`Date` 会保留原值，不会被递归处理。
 
 ```ts
 import { libJsPruneEmpty } from "lyb-js/Misc/LibJsPruneEmpty";
 
 const result = libJsPruneEmpty({
   name: "Tom",
+  createdAt: new Date("2026-05-07T00:00:00.000Z"),
   empty: "",
   profile: {
     age: undefined,
@@ -782,7 +807,7 @@ const result = libJsPruneEmpty({
 });
 
 console.log(result);
-// { name: "Tom", profile: { city: "Shanghai" } }
+// { name: "Tom", createdAt: 2026-05-07T00:00:00.000Z, profile: { city: "Shanghai" } }
 ```
 
 ### LibJsPullUpLoad-上拉加载

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lyb-js",
-  "version": "1.6.33",
+  "version": "1.6.34",
   "description": "自用JS方法库",
   "license": "ISC",
   "type": "module",

package/Base/LibIsNull.d.ts

@@ -1,2 +0,0 @@
-/** @description 判断是否为空值 */
-export declare const libIsNull: (value: any) => boolean;

package/Base/LibIsNull.js

@@ -1,2 +0,0 @@
-/** @description 判断是否为空值 */
-export const libIsNull = (value) => value === null || value === undefined || value === "";