findFirst

Selects the first item from an array, collection or enumerable object that matches the truth function.

Signature

findFirst<T>(
    list: TList<T> | undefined,
    fn: (item: T) => boolean
): T | undefined

Parameters

Name	Type	Optional	Description
list	T[] | undefined	No	Specifies the array, collection or enumerable object to iterate through.
fn	(item: T) => boolean	No	Specifies the truth function. Each item is supplied to the function, passing the item as argument. The function should return a boolean value whether to include the item in the selection.

Return value

Returns the item or undefined if no item is found.

Example

import { findFirst } from "@tripetto/builder";

findFirst<number>([1, 2, 3], (nItem: number) => nItem > 1); // Returns `2`