[Home](./index.md) > [@empathyco/x-components](./x-components.md) > [groupItemsBy](./x-components.groupitemsby.md) ## groupItemsBy() function Groups the array items based on the provided `groupBy` function. **Signature:** ```typescript export declare function groupItemsBy(array: ArrayType[], groupBy: (item: ArrayType, index: number) => ReturnType): Record; ``` ## Parameters | Parameter | Type | Description | | --- | --- | --- | | array | ArrayType\[\] | The array to iterate, grouping its items in different arrays based on the groupBy function. | | groupBy | (item: ArrayType, index: number) => ReturnType | A function to determine the group name of a single item. | **Returns:** Record<ReturnType, ArrayType\[\]> The items grouped in a dictionary.