es-toolkit/docs/reference/array/unzip.md
2024-07-10 09:59:43 +09:00

29 lines
622 B
Markdown

# unzip
Gathers elements in the same position in an internal array from a grouped array of elements and returns them as a new array.
## Signature
```typescript
type Unzip<K extends unknown[]> = { [I in keyof K]: Array<K[I]> };
function unzip<T extends unknown[]>(zipped: Array<[...T]>): Unzip<T>;
```
### Parameters
- `zipped` (`Array<[...T]>`): An array of grouped elements.
### Returns
(`Unzip<T>`): A new array created by collecting elements at the same position in an internal array.
## Example
```typescript
unzip([
['a', true, 1],
['b', false, 2],
]);
// return: [['a', 'b'], [true, false], [1, 2]]
```