where()

Get a subset of matching Set values.

Lazy loading:

Yes

Signature

where(predicate: () => Boolean | Null): Set

Description

The where() method returns the subset of Set values that match the predicate Function. The predicate Function must return a Boolean or Null.

If where() is the last value in a query, the first page of the created Set is returned.

Parameters

Parameter Type Required Description

predicate

Function

Yes

Anonymous Function that compares Set values and returns true for matches, false for mismatches, or Null.

Return value

Type Description

Set<Any>

Set representing the set values that match the predicate function.

Examples

Customer.all().where(.address.state == "DC")
{
  data: [
    {
      id: "401322234132561993",
      coll: Customer,
      ts: Time("2099-06-21T17:05:57.355Z"),
      firstName: "Alice",
      lastName: "Appleseed",
      email: "alice.appleseed@example.com",
      address: {
        street: "87856 Mendota Court",
        city: "Washington",
        state: "DC",
        zipCode: "20220"
      },
      telephone: "208-346-0715",
      creditCard: {
        network: "Visa",
        number: "4556781272473393"
      }
    },
    ...
  ]
}

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!