@libs-ui/pipes-get-value-of-object 0.2.357-8 → 0.2.357-9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +2 -9
  2. package/package.json +2 -2
package/README.md CHANGED
@@ -238,6 +238,7 @@ pipe.transform(object, 'path', 'defaultValue', false);
238
238
  | `{ a: { b: 1 } }` | `'a.b'` | — | `1` |
239
239
  | `{ a: { b: 1 } }` | `'a.c'` | `'fallback'` | `'fallback'` |
240
240
  | `{ a: { b: 1 } }` | `'a.c'` | — | `undefined` |
241
+ | `{ a: { b: null } }` | `'a.b'` | `'fallback'` | `'fallback'` (giá trị `null` cũng áp dụng `defaultValue`) |
241
242
  | `null` | `'any.path'` | `'default'` | `'default'` |
242
243
  | `undefined` | `'any.path'` | `0` | `0` |
243
244
  | `{ tags: ['a','b'] }` | `'tags.0'` | — | `'a'` |
@@ -251,16 +252,8 @@ pipe.transform(object, 'path', 'defaultValue', false);
251
252
 
252
253
  ⚠️ **Path dạng chuỗi**: Tham số `path` PHẢI là string literal hoặc biến string — không được truyền object/array trực tiếp làm path.
253
254
 
254
- ⚠️ **Phân biệt `undefined` `null`**: Pipe trả về `defaultValue` khi giá trị tại path là `undefined`. Nếu giá trị là `null`, pipe vẫn trả về `null` (không áp dụng defaultValue).
255
+ ⚠️ **`null` `undefined` đều áp dụng `defaultValue`**: Khác với nhiều thư viện lodash-style, pipe dùng toán tử `??` ở bước trả về cuối cùng — vì vậy khi giá trị tại path là `null` HOẶC `undefined`, pipe đều trả về `defaultValue` (nếu có truyền), không phân biệt hai loại giá trị này.
255
256
 
256
257
  ⚠️ **`keepLastValueIfSignal` chỉ dùng nội bộ**: Tham số thứ tư dành cho các workflow Signal nội bộ của `@libs-ui/utils`. Không dùng trong code ứng dụng thông thường.
257
258
 
258
259
  ⚠️ **Không gọi function trong template**: Không dùng `{{ getValueFromObj(user, 'name') }}` — hãy dùng pipe để tránh gọi function mỗi change detection cycle.
259
-
260
- ## Demo
261
-
262
- ```bash
263
- npx nx serve core-ui
264
- ```
265
-
266
- Truy cập: http://localhost:4500/pipes/get-value-of-object
package/package.json CHANGED
@@ -1,9 +1,9 @@
1
1
  {
2
2
  "name": "@libs-ui/pipes-get-value-of-object",
3
- "version": "0.2.357-8",
3
+ "version": "0.2.357-9",
4
4
  "peerDependencies": {
5
5
  "@angular/core": ">=18.0.0",
6
- "@libs-ui/utils": "0.2.357-8"
6
+ "@libs-ui/utils": "0.2.357-9"
7
7
  },
8
8
  "sideEffects": false,
9
9
  "module": "fesm2022/libs-ui-pipes-get-value-of-object.mjs",