firstWhere()

Get the first array value that matches the given predicate.

Signature

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

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

Description

The firstWhere() method gets the first matching array value that matches predicate.

Parameters

Parameter Type Required Description

predicate

Function

Yes

Anonymous Function that compares a Array value and returns true for matches, 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!