firstElement() Function

Returns the first element in array whose value satisfies the predicate.

Signature

export declare function firstElement<T>(array: readonly T[], predicate: (value: T, index: number, array: readonly T[]) => boolean): T | undefined;

Parameter	Type	Description
array	readonly T[]	The array to search.
predicate	(value: T, index: number, array: readonly T[]) => boolean	A predicate. There should exist some index `I` such that `predicate(array[i])` returns true for all `i >= I` and returns false otherwise.
(Returns)	T \| undefined	The first element in `array` whose value satisfies the `predicate`, or `undefined` if no such element exists.