TS 5.4：Object.groupBy 和 Map.groupBy 方法添加了類型聲明
2 月 22 日，TypeScript 團隊發布了 TypeScript 5.4 RC 版本。即將發布的 TypeScript 5.4 為 Object.groupBy 和 Map.groupBy 方法添加了類型聲明。
通過以下命令，你就可以體驗最新的 TypeScript 5.4 RC 版本：
npm install -D typescript@rc本文我將介紹 Object.groupBy 和 Map.groupBy 這兩個方法，需要注意的是，你需要把 tsconfig.json 文件中 target 屬性配置成 esnext 才訪問這些方法。
{
"compilerOptions": {
"target": "esnext",
}
}Object.groupBy()
Object.groupBy() 靜態方法會根據提供的回調函數返回的字符串值對給定可迭代的元素進行分組。該方法的類型定義如下：
// typescript/lib/lib.esnext.object.d.ts
interface ObjectConstructor {
/**
* Groups members of an iterable according to the return value of the passed callback.
* @param items An iterable.
* @param keySelector A callback which will be invoked for each item in items.
*/
groupBy<K extends PropertyKey, T>(
items: Iterable<T>,
keySelector: (item: T, index: number) => K,
): Partial<Record<K, T[]>>;
}在以上代碼中，K 和 T 是泛型變量，其中 K extends PropertyKey 是泛型約束，PropertyKey 是一個聯合類型：
type PropertyKey = string | number | symbol;而 Partial 和 Record 是 TypeScript 內置的工具類型。由 groupBy 的類型定義可知，參數 keySelector 是函數類型，包含 item 和 index 兩個參數。
下面，我們將使用 Object.groupBy() 方法，對數組中的對象進行分組：
const inventory = [
{ name: "asparagus", type: "vegetables", quantity: 5 },
{ name: "bananas", type: "fruit", quantity: 0 },
{ name: "goat", type: "meat", quantity: 23 },
{ name: "cherries", type: "fruit", quantity: 5 },
{ name: "fish", type: "meat", quantity: 22 },
];
const groupedByType = Object.groupBy(inventory, ({ type }) => type);
Map.groupBy()
Map.groupBy() 靜態方法使用提供的回調函數返回的值對給定可迭代的元素進行分組。最終返回的 Map 使用測試函數中的唯一值作為鍵，可用于獲取每個組中的元素數組。該方法的類型定義如下：
interface MapConstructor {
/**
* Groups members of an iterable according to the return value of the passed callback.
* @param items An iterable.
* @param keySelector A callback which will be invoked for each item in items.
*/
groupBy<K, T>(
items: Iterable<T>,
keySelector: (item: T, index: number) => K,
): Map<K, T[]>;
}在以上代碼中，K 和 T 是泛型變量。調用該方法后，會返回 Map 類型的對象。與 Object.groupBy 靜態方法一樣，參數 keySelector 也是函數類型，包含 item 和 index 兩個參數。
下面我們來看一下如何使用 Map.groupBy() 方法對數組中的對象進行分組：
const inventory = [
{ name: 'asparagus', type: 'vegetables', quantity: 6 },
{ name: 'bananas', type: 'fruit', quantity: 16 },
{ name: 'goat', type: 'meat', quantity: 20 },
{ name: 'cherries', type: 'fruit', quantity: 12 },
{ name: 'fish', type: 'meat', quantity: 8 },
];
const result = Map.groupBy(inventory, ({ quantity }) =>
quantity < 10 ? "restock" : "sufficient",
);
const restock = result.get("restock");
const sufficient = result.get("sufficient");
