firstWhere()

Get the first matching value from the Array.

Signature

firstWhere(predicate: () => Boolean | Null): T | Null

firstWhere(predicate: (val: T) => Boolean | Null): T | Null

Description

The firstWhere() method gets the first matching value from the array, or null when no values match.

Parameters

Parameter Type Required Description

predicate

Function

Yes

Anonymous Function that compares a Array value and returns true for matches or false for mismatches, or Null.

predicate parameters:

Parameter Type Required Description

val

Any

The Array value to compare. If omitted, use dot notation to access value properties.

Return value

Type Description

Any

First matching value in the Array, or null if the Array is empty or no values match.

Examples

let iter = [1, 2, 3, 4]
iter.firstWhere(v => v > 2)
3

Is this article helpful? 

Tell Fauna how the article can be improved:
 Visit Fauna's forums or email docs@fauna.com

Thank you for your feedback!