toss/es-toolkit
1
1
Fork 0
mirror of https://github.com/toss/es-toolkit.git synced 2024-12-18 13:31:31 +03:00
Code Issues Actions 2 Packages Projects Releases Wiki Activity
860fb0c0e2
es-toolkit/docs/reference/array/takeWhile.md
Minsoo Kim cf65b2c601
style(*): Setup prettier and apply formatting (#24) 
* chore: add prettierrc

* chore: apply format with prettier config

* chore: eslint error fix
2024-06-04 17:19:26 +09:00

837 B
Raw Blame History

takeWhile

Returns a new array containing the leading elements of the provided array that satisfy the provided predicate function. It stops taking elements as soon as an element does not satisfy the predicate.

Signature

function takeWhile<T>(arr: T[], shouldContinueTaking: (element: T) => boolean): T[];

Parameters

  • arr (T[]): The array to take elements from.
  • shouldContinueTaking ((item: T) => boolean) The predicate function that is called with each element. Elements are included in the result as long as this function returns true.

Returns

(T[]) A new array containing the elements taken from the beginning while the predicate returns true.

Examples

// Returns [1, 2]
takeWhile([1, 2, 3, 4], x => x < 3);

// Returns []
takeWhile([1, 2, 3, 4], x => x > 3);