> For AI agents: the complete documentation index is available at https://massaman.dev/llms.txt, the full documentation bundle is available at https://massaman.dev/llms-full.txt.

# take es-toolkit

Creates a new array by taking the specified number of elements from the beginning of the array.

```typescript
const taken = take(arr, count);
```

## Usage

### `take(arr, count?)`

Use `take` when you only need a few elements from the front of an array. If the requested count is greater than the array length, it returns the entire array.

```typescript
import { take } from 'es-toolkit/array';

// Take the first 3 elements.
take([1, 2, 3, 4, 5], 3);
// Returns: [1, 2, 3]

// Take the first 2 elements.
take(['a', 'b', 'c'], 2);
// Returns: ['a', 'b']
```

If you request more elements than the array has, it returns the entire array.

```typescript
import { take } from 'es-toolkit/array';

take([1, 2, 3], 5);
// Returns: [1, 2, 3]
```

If you omit `count`, it takes only the first element.

```typescript
import { take } from 'es-toolkit/array';

take([1, 2, 3]);
// Returns: [1]
```

#### Parameters


arrT[]required

The array to take elements from.


countnumberoptional

The number of elements to take. Default is `1`.

#### Returns

Returns a new array containing the first `count` elements from the array.

```typescript
T[]
```


Source: es-toolkit

Re-exported verbatim from [`es-toolkit`](https://es-toolkit.dev/reference/array/take.html). Implementation, edge cases, and performance behavior are owned upstream. This page mirrors the documentation at the pinned version; the linked source is authoritative.
