eq( )

Developer Preview

This API is subject to change. Bug fixes and new features will be released based on developer feedback throughout the preview period.

Refines a query to match items where the specified property equals the specified value.

The eq() function refines a ServicesQueryBuilder to match only items where the value of the specified propertyName equals the specified value. eq() matches only values of the same type. For example, 0 stored as a number doesn't match '0' stored as a string. Matching strings with eq() is case-sensitive, so 'text' isn't equal to 'Text'.

Copy
function eq(propertyName: string, value: any): ServicesQueryBuilder
Method Parameters
propertyNamestring
Property whose value is compared with value.

valueany
Value to compare against.
Returns
Was this helpful?
Yes
No

exists( )

Developer Preview

This API is subject to change. Bug fixes and new features will be released based on developer feedback throughout the preview period.

Refines a query to match items where the specified property contains a value.

The exists() function refines a ServicesQueryBuilder to only match items where the value of the specified propertyName doesn't equal null or undefined. exists() checks for either existence or non-existence based on the boolen parameter. Note that exists() does match items where the value of the specified propertyName is an empty string or an invalid value. exists() is only useful for properties which don't contain default values and therefore their values may be unassigned.

Copy
function exists(propertyName: string, value: boolean): ServicesQueryBuilder
Method Parameters
propertyNamestring

valueboolean
Returns
Was this helpful?
Yes
No

find( )

Developer Preview

This API is subject to change. Bug fixes and new features will be released based on developer feedback throughout the preview period.

Returns the query results.

The find() function returns a Promise that resolves to the query results and metadata. The Promise is rejected if find() is called with insufficient permissions or if any of the previous functions used to refine the query are invalid.

Copy
function find(): Promise<ServicesQueryResult>
Request
This method does not take any parameters
Returns
Return Type:Promise<ServicesQueryResult>
Was this helpful?
Yes
No

hasAll( )

Developer Preview

This API is subject to change. Bug fixes and new features will be released based on developer feedback throughout the preview period.

Refines a query to match items whose specified property contains all of the specified values.

The hasAll() function refines a ServicesQueryBuilder to match only items where the value of the specified propertyName equals all of the specified values. Matching strings with hasAll() is case-sensitive, so 'text' isn't equal to 'Text'. If the specified property is an array, hasAll() matches if that array's elements match all of the specified values.

Copy
function hasAll(propertyName: string, value: Array<any>): ServicesQueryBuilder
Method Parameters
propertyNamestring
Property whose value is compared with values.

valueArray<any>
Returns
Was this helpful?
Yes
No

hasSome( )

Developer Preview

This API is subject to change. Bug fixes and new features will be released based on developer feedback throughout the preview period.

Refines a query to match items whose specified property contains any of the specified values.

The hasSome() function refines a ServicesQueryBuilder to match only items where the value of the specified propertyName equals any of the specified values. Matching strings with hasSome() is case-sensitive, so 'text' isn't equal to 'Text'. If the specified property is an array, hasSome() matches if any of that array's elements equal any of the specified values.

Copy
function hasSome(propertyName: string, value: Array<any>): ServicesQueryBuilder
Method Parameters
propertyNamestring
Property whose value is compared with values.

valueArray<any>
Returns
Was this helpful?
Yes
No

in( )

Developer Preview

This API is subject to change. Bug fixes and new features will be released based on developer feedback throughout the preview period.

Refines a query to only match items where the specified property conatins any of the values in the provided array of values.

The in() function refines a ServicesQueryBuilder to match only items where the specified propertyName is equal to any of the values in the provided array. Matching strings with in() is case-sensitive, so 'text' isn't equal to 'Text'.

Copy
function in(propertyName: string, value: any): ServicesQueryBuilder
Method Parameters
propertyNamestring

valueany
Returns
Was this helpful?
Yes
No

limit( )

Developer Preview

This API is subject to change. Bug fixes and new features will be released based on developer feedback throughout the preview period.

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. You can use the next() and prev() functions to navigate the pages of a query result.

Copy
function limit(limit: number): ServicesQueryBuilder
Method Parameters
limitnumber
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. You can use the next() and prev() functions to navigate the pages of a query result.
Returns
Was this helpful?
Yes
No

ne( )

Developer Preview

This API is subject to change. Bug fixes and new features will be released based on developer feedback throughout the preview period.

Refines a query to match items where the specified property doesn't equal the specified value.

The ne() function refines a ServicesQueryBuilder to match only items where the value of the specified propertyName doesn't equal the specified value. ne() matches only values of the same type. For example, 0 stored as a number doesn't match '0' stored as a string. Matching strings with ne() is case-sensitive, so 'text' isn't equal to 'Text'.

Copy
function ne(propertyName: string, value: any): ServicesQueryBuilder
Method Parameters
propertyNamestring
Property whose value is compared with value.

valueany
Value to compare against.
Returns
Was this helpful?
Yes
No

skip( )

Developer Preview

This API is subject to change. Bug fixes and new features will be released based on developer feedback throughout the preview period.

Sets the number of items to skip before returning query results.

The skip() function defines the number of results to skip before returning new query results. For example, if you query a collection and 50 items match your query, but you set skip() to 10, the first 10 items that match are ignored, and the 11th through 50th items are returned.

Copy
function skip(skip: number): ServicesQueryBuilder
Method Parameters
skipnumber
Sets the number of items to skip before returning query results. The skip() function defines the number of results to skip before returning new query results. For example, if you query a collection and 50 items match your query, but you set skip() to 10, the first 10 items that match are ignored, and the 11th through 50th items are returned.
Returns
Was this helpful?
Yes
No

startsWith( )

Developer Preview

This API is subject to change. Bug fixes and new features will be released based on developer feedback throughout the preview period.

Refines a query to match items where the specified property starts with the specified value.

The startsWith() function refines a ServicesQueryBuilder to match only items where the value of the specified propertyName starts with the specified string. Matching with startsWith() is case-sensitive, so 'TEXT' doesn't start with 'text'. You can only use startsWith() with a property whose value is a string.

Copy
function startsWith(propertyName: string, value: string): ServicesQueryBuilder
Method Parameters
propertyNamestring
Property whose value is compared with string.

valuestring
Returns
Was this helpful?
Yes
No