array.lastWhere()

This method operates on an array. You typically fetch documents from a collection as a set, not an Array. For the equivalent Set method, see set instance methods.

For differences between Sets and Arrays, see Sets vs. Arrays.

Get the last element of an Array that matches a provided predicate.

Signature

lastWhere(predicate: (A => Boolean | Null)) => A | Null

Description

Gets the last element of the calling Array that matches a provided predicate function.

Parameters

Parameter Type Required Description

predicate

Predicate function

Yes

Anonymous predicate function that:

  • Accepts an Array element as its only argument. You can pass in this argument using arrow function syntax. Supports shorthand-syntax for objects and documents.

  • Returns Boolean or Null.

The method returns the last Array element for which the predicate returns true.

Return value

One of:

Type Description

Generic

Last element of the Array that matches the predicate.

Null

Returned if no Array element matches the predicate or the Array is empty.

Examples

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

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!