descending( )


Adds a sort to a query, sorting by the specified properties in descending order.

The descending() function refines a LabelsQueryBuilder to sort in ascending order of the specified properties. If you specify more than one property, descending() sorts the results in descending order by each property in the order they are listed.

You can sort the following types:

  • Number: Sorts numerically.
  • Date: Sorts by date and time.
  • String: Sorts lexicographically, so "abc" comes after "XYZ".

If a property contains a number as a String, that value will be sorted alphabetically and not numerically. Items that do not have a value for the specified sort property are ranked lowest.

Method Declaration
Copy
function descending(propertyName: Array<string>): LabelsQueryBuilder;
Method Parameters
propertyNameArray<string>Required

The properties used in the sort.

Supported properties:

  • _createdDate
  • _updatedDate
  • displayName
Returns
Return Type:LabelsQueryBuilder
JavaScript
const query = contacts.queryLabels().descending("_createdDate");
Did this help?

find( )


Returns the items that match the query.

The find() function returns a Promise that resolves to the results found by the query and some information about the results. The Promise is rejected if find() is called with incorrect permissions or if any of the functions used to refine the query are invalid.

Note: Only visitors with Manage Contacts permissions can query labels. You can override the permissions by setting the suppressAuth option to true.

Method Declaration
Copy
function find(options: AuthOptions): Promise<LabelsQueryResult>;
Method Parameters
optionsAuthOptions

Authorization options.

Returns
Return Type:Promise<LabelsQueryResult>
JavaScript
const queryResults = contacts.queryLabels().find();
Did this help?

limit( )


Limits the number of items the query returns.

The limit() function defines the number of results a query returns in each page. Only one page of results is retrieved at a time. The next() and prev() functions are used to navigate the pages of a query result.

By default, limit is set to 50.

The maximum value that limit() can accept is 1000.

Method Declaration
Copy
function limit(limit: string): LabelsQueryBuilder;
Method Parameters
limitstringRequired

Limit the number of items to return, which is also the pageSize of the results object.

Returns
Return Type:LabelsQueryBuilder
JavaScript
const query = contacts.queryLabels().limit(10);
Did this help?