chunk

将数组拆分为指定大小的较小数组。

typescript

const chunked = chunk(arr, size);

用法

`chunk(arr, size)`

当您想将一个长数组拆分成多个大小相同的较小数组时,请使用 chunk。如果数组无法平均分割,最后一个块将包含剩余的元素。

typescript

import { chunk } from 'es-toolkit/array';

// 将数字数组拆分为大小为 2 的块。
chunk([1, 2, 3, 4, 5], 2);
// 返回: [[1, 2], [3, 4], [5]]

// 将字符串数组拆分为大小为 3 的块。
chunk(['a', 'b', 'c', 'd', 'e', 'f', 'g'], 3);
// 返回: [['a', 'b', 'c'], ['d', 'e', 'f'], ['g']]

拆分空数组会返回空数组。

typescript

import { chunk } from 'es-toolkit/array';

chunk([], 2); // []

参数

arr (T[]): 要拆分的数组。
size (number): 每个块的大小。必须是正整数。

返回值

(T[][]): 被拆分成大小为 size 的块的二维数组。

抛出错误

如果 size 不是正整数,则抛出错误。

试一试

::: sandpack

import { chunk } from 'es-toolkit/array';

console.log(chunk([1, 2, 3, 4, 5], 2));

:::