Function find

find<I, O>(
    array: Nil | readonly I[],
    predicate: ArrayNarrowingIteratee<O>,
    fromIndex?: number,
): undefined | Extract<I, O> | Extract<O, I>
Iterates over elements of collection, returning the first element predicate returns truthy for.

Contribution to minified bundle size, when it is the only function imported:
- Lodash: 16,881 bytes
- Micro-dash: 241 bytes
Type Parameters
- I
- O
Parameters
- array: Nil | readonly I[]
- predicate: ArrayNarrowingIteratee<O>
- OptionalfromIndex: number
Returns undefined | Extract<I, O> | Extract<O, I>
- Defined in collection/find.ts:37
find<T>(
    array: Nil | readonly T[],
    predicate: ArrayIteratee<T, boolean>,
    fromIndex?: number,
): undefined | T
Iterates over elements of collection, returning the first element predicate returns truthy for.

Contribution to minified bundle size, when it is the only function imported:
- Lodash: 16,881 bytes
- Micro-dash: 241 bytes
Type Parameters
- T
Parameters
- array: Nil | readonly T[]
- predicate: ArrayIteratee<T, boolean>
- OptionalfromIndex: number
Returns undefined | T
- Defined in collection/find.ts:44
find<I, T extends {}, O, F extends undefined | number = undefined>(
    object: I,
    predicate: ValueNarrowingIteratee<T, O>,
    fromIndex?: F,
):
    | IfCouldBe<F, number, undefined>
    | IfCouldBe<I, Nil, undefined>
    | PossibleValueMatches<T, O>
    | (DefiniteValueMatches<T, O> extends never ? undefined : never)
Iterates over elements of collection, returning the first element predicate returns truthy for.

Contribution to minified bundle size, when it is the only function imported:
- Lodash: 16,881 bytes
- Micro-dash: 241 bytes
Type Parameters
- I
- T extends {}
- O
- F extends undefined | number = undefined
Parameters
- object: I
- predicate: ValueNarrowingIteratee<T, O>
- OptionalfromIndex: F
Returns
    | IfCouldBe<F, number, undefined>
    | IfCouldBe<I, Nil, undefined>
    | PossibleValueMatches<T, O>
    | (DefiniteValueMatches<T, O> extends never ? undefined : never)
- Defined in collection/find.ts:51
find<I, T extends {}, O, F extends undefined | number = undefined>(
    object: I,
    predicate: KeyNarrowingIteratee<T, O>,
    fromIndex?: F,
):
    | IfCouldBe<F, number, undefined>
    | IfCouldBe<I, Nil, undefined>
    | PossibleKeyMatches<T, O>
    | (DefiniteKeyMatches<T, O> extends never ? undefined : never)
Iterates over elements of collection, returning the first element predicate returns truthy for.

Contribution to minified bundle size, when it is the only function imported:
- Lodash: 16,881 bytes
- Micro-dash: 241 bytes
Type Parameters
- I
- T extends {}
- O
- F extends undefined | number = undefined
Parameters
- object: I
- predicate: KeyNarrowingIteratee<T, O>
- OptionalfromIndex: F
Returns
    | IfCouldBe<F, number, undefined>
    | IfCouldBe<I, Nil, undefined>
    | PossibleKeyMatches<T, O>
    | (DefiniteKeyMatches<T, O> extends never ? undefined : never)
- Defined in collection/find.ts:67
find<T>(
    object: Nil | T,
    predicate: ObjectIteratee<T, boolean>,
    fromIndex?: number,
): undefined | T[keyof T]
Iterates over elements of collection, returning the first element predicate returns truthy for.

Contribution to minified bundle size, when it is the only function imported:
- Lodash: 16,881 bytes
- Micro-dash: 241 bytes
Type Parameters
- T
Parameters
- object: Nil | T
- predicate: ObjectIteratee<T, boolean>
- OptionalfromIndex: number
Returns undefined | T[keyof T]
- Defined in collection/find.ts:83

Function find

Type Parameters

Parameters

Returns undefined | Extract<I, O> | Extract<O, I>

Type Parameters

Parameters

Returns undefined | T

Type Parameters

Parameters

Returns | IfCouldBe<F, number, undefined> | IfCouldBe<I, Nil, undefined> | PossibleValueMatches<T, O> | (DefiniteValueMatches<T, O> extends never ? undefined : never)

Type Parameters

Parameters

Returns | IfCouldBe<F, number, undefined> | IfCouldBe<I, Nil, undefined> | PossibleKeyMatches<T, O> | (DefiniteKeyMatches<T, O> extends never ? undefined : never)

Type Parameters

Parameters

Returns undefined | T[keyof T]

Settings

Returns
| IfCouldBe<F, number, undefined>
| IfCouldBe<I, Nil, undefined>
| PossibleValueMatches<T, O>
| (DefiniteValueMatches<T, O> extends never ? undefined : never)

Returns
| IfCouldBe<F, number, undefined>
| IfCouldBe<I, Nil, undefined>
| PossibleKeyMatches<T, O>
| (DefiniteKeyMatches<T, O> extends never ? undefined : never)