Function find

  • Iterates over elements of collection, returning the first element where predicate returns truthy value. The predicate is invoked with three arguments: (value, index|key, collection).

    Example

    let users = [
    { 'user': 'barney', 'age': 36, 'active': true },
    { 'user': 'fred', 'age': 40, 'active': false },
    { 'user': 'pebbles', 'age': 1, 'active': true }
    ]

    find(users, (o) => o.age < 40)
    // object for 'barney'

    // The shape iteratee shorthand.
    find(users, { 'age': 1, 'active': true })
    // object for 'pebbles'

    // The `property` iteratee shorthand.
    find(users, 'active')
    // object for 'barney'

    Returns

    The matched element, else undefined.

    See

    findLast

    Type Parameters

    • T

    Parameters

    • arr: T[]

      The collection to iterate over.

    • fn: Iteratee<T, any, any>

      The function invoked per iteration.

    Returns T | undefined

  • Type Parameters

    • T

    Parameters

    • arr: T[]
    • fn: Object

    Returns T | undefined

  • Type Parameters

    • T

    Parameters

    • arr: T[]
    • fn: PropertyKey

    Returns T | undefined

  • Type Parameters

    • T

    Parameters

    • arr: Object
    • fn: Iteratee<T, any, any>

    Returns T | undefined

  • Type Parameters

    • T

    Parameters

    • arr: Object
    • fn: Object

    Returns T | undefined

  • Type Parameters

    • T

    Parameters

    • arr: Object
    • fn: PropertyKey

    Returns T | undefined

Generated using TypeDoc