es-toolkit/docs/reference/array/tail.md

tail

Returns a new array with all elements except for the first.

This function takes an array and returns a new array containing all the elements except for the first one. If the input array is empty or has only one element, an empty array is returned.

Signature

function tail<T>(arr: [T]): [];
function tail(arr: []): [];
function tail<T, U>(arr: [T, ...U[]]): U[];
function tail<T>(arr: T[]): T[];

Parameters

• arr (T[]): The array to get the tail of.

Returns

(T[]): A new array containing all elements of the input array except for the first one.

Examples

const arr1 = [1, 2, 3];
const result = tail(arr1);
// result will be [2, 3]

const arr2 = [1];
const result2 = tail(arr2);
// result2 will be []

const arr3 = [];
const result3 = tail(arr3);
// result3 will be []