array.distinct()

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 unique elements.

Signature

distinct() => Array<T>

Description

The distinct() method returns the unique elements in the Array.

The source Array isn’t changed.

Avoid using distinct() with large Sets

Avoid using distinct() to process Arrays converted from large or unbounded Sets that contain 16,000 or more documents.

If a Set contains 16,000 or more documents, the query requires pagination. array.distinct() would only be able to extract unique elements from each page of results.

Instead, retrieve all field values and process them on the client side. See Get unique field values.

Parameters

None

Return value

Type Description

Array

Unique elements in the Array.

Examples

[1, 1, 2, 3, 3].distinct()
[
  1,
  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!