Realm~App.Sync.BaseSubscriptionSet

Class representing the common functionality for the Realm.App.Sync.SubscriptionSet and Realm.App.Sync.SubscriptionSet classes

The Realm.App.Sync.Subscriptions in a SubscriptionSet can be accessed as an array, e.g. realm.subscriptions[0]. This array is readonly – SubscriptionSets can only be modified inside a Realm.App.Sync.SubscriptionSet.update callback.

error
readonly

If state is Realm.App.Sync.SubscriptionsState.Error, this will return a string representing why the SubscriptionSet is in an error state. null is returned if there is no error.

Type:
string or null
isEmpty
readonly

Returns true if there are no subscriptions in the set, false otherwise.

Type:
boolean
state
readonly

The state of the SubscriptionSet.

Type:
Realm.App.Sync.SubscriptionSetState
version
readonly

The version of the SubscriptionSet. This is incremented every time a Realm.App.Sync.SubscriptionSet#update is applied.

Type:
number
every(callback, thisArg)boolean
Parameters:
  • callback
    • Type: function
    • Function to execute on each object in the SubscriptionSet. If this function returns true for every object, then this method will return true. This function takes three arguments:

      • object – The current object being processed in the SubscriptionSet.
      • index – The index of the object being processed in the SubscriptionSet.
      • subscriptionSet – The SubscriptionSet itself.
  • thisArg optional
    • Type: object
    • The value of this when callback is called.

Returns: boolean representing if callback returned true for every object in the SubscriptionSet.
findByName(name)Realm.App.Sync.Subscription or null

Find a subscription by name.

Parameters:
  • name
    • Type: string
    • The name to search for.

Returns: Realm.App.Sync.Subscription or null The named subscription, or null if the subscription is not found.
findByQuery(query)Realm.App.Sync.Subscription or null

Find a subscription by query. Will match both named and unnamed subscriptions.

Parameters:
  • query
    • Type: Realm.Results
    • The query to search for, represented as a Realm.Results instance, e.g. Realm.objects("Cat").filtered("age > 10").

Returns: Realm.App.Sync.Subscription or null The subscription with the specified query, or null if the subscription is not found.
forEach(callback, thisArg)
Parameters:
  • callback
    • Type: function
    • Function to execute on each object in the SubscriptionSet. This function takes three arguments:

      • object – The current object being processed in the SubscriptionSet.
      • index – The index of the object being processed in the SubscriptionSet.
      • subscriptionSet – The SubscriptionSet itself.
  • thisArg optional
    • Type: object
    • The value of this when callback is called.

map(callback, thisArg)[any, ...]
Parameters:
  • callback
    • Type: function
    • Function to execute on each object in the SubscriptionSet. This function takes three arguments:

      • object – The current object being processed in the SubscriptionSet.
      • index – The index of the object being processed in the SubscriptionSet.
      • subscriptionSet – The SubscriptionSet itself.
  • thisArg optional
    • Type: object
    • The value of this when callback is called.

Returns: [any, ...] – the return values of callback after being called on every object in the SubscriptionSet.
reduce(callback, initialValue)any
Parameters:
  • callback
    • Type: function
    • Function to execute on each object in the SubscriptionSet. This function takes four arguments:

      • previousValue – The value previously returned in the last invocation of the callback, or initialValue, if supplied.
      • object – The current object being processed in the SubscriptionSet.
      • index – The index of the object being processed in the SubscriptionSet.
      • subscriptionSet – The SubscriptionSet itself.
  • initialValue optional
    • Type: object
    • The value to use as the first argument to the first call of the callback.

Throws:
  • TypeError
    • If the SubscriptionSet is empty and no initialValue was supplied.

Returns: any – the value returned by the final invocation of callback, except for the following special cases:
  • If SubscriptionSet consists of a single object, and no initalValue was supplied, then that object will be returned.
  • If the SubscriptionSet is empty, then initialValue must be supplied and will be returned.
reduceRight(callback, initialValue)any
Parameters:
  • callback
    • Type: function
    • Function to execute on each object, from right to left, in the SubscriptionSet. This function takes four arguments:

      • previousValue – The value previously returned in the last invocation of the callback, or initialValue, if supplied.
      • object – The current object being processed in the SubscriptionSet.
      • index – The index of the object being processed in the SubscriptionSet.
      • subscriptionSet – The SubscriptionSet itself.
  • initialValue optional
    • Type: object
    • The value to use as the first argument to the first call of the callback.

Throws:
  • TypeError
    • If the SubscriptionSet is empty and no initialValue was supplied.

Returns: any – the value returned by the final invocation of callback, except for the following special cases:
  • If SubscriptionSet consists of a single object, and no initalValue was supplied, then that object will be returned.
  • If the SubscriptionSet is empty, then initialValue must be supplied and will be returned.
some(callback, thisArg)boolean
Parameters:
  • callback
    • Type: function
    • Function to execute on each object in the SubscriptionSet. If this function ever returns true, then this method will return true. This function takes three arguments:

      • object – The current object being processed in the SubscriptionSet.
      • index – The index of the object being processed in the SubscriptionSet.
      • subscriptionSet – The SubscriptionSet itself.
  • thisArg optional
    • Type: object
    • The value of this when callback is called.

Returns: booleantrue when callback returns true for an object in the SubscriptionSet, otherwise false.