1
import assert from 'node:assert/strict';
2

3
const first = { id: 'a', name: '舊名稱' };
4
const copied = { id: 'a', name: '舊名稱' };
5
assert.equal(new Set([first, first]).size, 1);
6
assert.equal(new Set([first, copied]).size, 2);
7
assert.equal(new Set(['a', 'a']).size, 1);
8
assert.equal(new Set([1, '1']).size, 2);
9
console.log('物件身分與 key 型別檢查通過');

從 API 解析出來的不同物件，即使欄位相同，也不會因此變成同一個物件。深複製再放進 Set 只會建立更多不同身分；這與 structuredClone 後的 Map key有相同的身分邊界，但這裡要解決的是清單的業務去重。

第一筆與最後一筆，要連順序一起定義#

下面限定輸入為密集陣列，每筆有自己的非空字串 id；getter、Proxy 與效能需另行驗證。'1' 和 '01' 是不同識別碼，不自動轉數字；缺少 ID 直接拒絕，避免多筆無效資料都被合成同一個 undefined key。

重複時提供兩種政策：first 保留第一筆；last 保留最後一筆的內容，位置仍依這個 ID 首次出現的順序。Map 對既有 key 設新值不會將它移到最後，規則可對照 MDN Map 文件。

1
import assert from 'node:assert/strict';
2

3
function uniqueById(rows, keep = 'first') {
4
  if (!Array.isArray(rows) || !['first', 'last'].includes(keep)) {
5
    throw new TypeError('需要陣列及明確的保留政策');
6
  }
7
  const byId = new Map();
8
  for (let i = 0; i < rows.length; i += 1) {
9
    const row = rows[i];
10
    if (!Object.hasOwn(rows, i) || row === null || typeof row !== 'object' ||
11
        !Object.hasOwn(row, 'id') || typeof row.id !== 'string' || row.id === '') {
12
      throw new TypeError('每筆資料需要自己的非空字串 id');
13
    }
14
    if (keep === 'last' || !byId.has(row.id)) byId.set(row.id, row);
15
  }
16
  return [...byId.values()];
17
}
18

19
const oldA = { id: 'a', name: '舊名稱' };
20
const b = { id: 'b', name: '第二筆' };
21
const newA = { id: 'a', name: '新名稱' };
22
const rows = [oldA, b, newA];
23
const before = [...rows];
24
assert.deepEqual(uniqueById(rows), [oldA, b]);
25
assert.deepEqual(uniqueById(rows, 'last'), [newA, b]);
26
assert.deepEqual(rows, before);
27
assert.notEqual(uniqueById(rows), rows);
28
assert.equal(uniqueById(rows)[0], oldA);
29
assert.deepEqual(uniqueById([]), []);
30
assert.equal(uniqueById([{ id: '1' }, { id: '01' }]).length, 2);
31
for (const bad of [[{}], [{ id: '' }], [{ id: 1 }], [null], new Array(1)]) {
32
  assert.throws(() => uniqueById(bad), TypeError);
33
}
34
assert.throws(() => uniqueById(rows, 'merge'), TypeError);
35
console.log('去重政策、順序與輸入邊界檢查通過');