Gets the current state of the connection to the server. Multiple sessions might share the same underlying connection. In that case, any connection change is sent to all sessions.
Data will only be synchronized with the server if this method returns Connected
and state()
returns Active
or Dying
.
Gets the current state of the session.
Gets the URL of the Realm Object Server that this session is connected to.
Gets the User that this session was created with.
Registers a connection notification on the session object. This will be notified about changes to the underlying connection to the Realm Object Server.
Called with the following arguments:
newState
: The new state of the connectionoldState
: The state the connection transitioned from.2.15.0
Register a progress notification callback on a session object
The progress direction to register for.
The progress notification mode to use for the registration. Can be either:
reportIndefinitely
- the registration will stay active until the callback is unregisteredforCurrentlyOutstandingWork
- the registration will be active until only the currently transferable bytes are syncedCalled with the following arguments:
transferred
: The current number of bytes already transferredtransferable
: The total number of transferable bytes (the number of bytes already transferred plus the number of bytes pending transfer)1.12.0
This method returns a promise that does not resolve successfully until all known remote changes have been downloaded and applied to the Realm or the specified timeout is hit in which case it will be rejected. If the method times out, the download will still continue in the background.
This method cannot be called before the Realm has been opened.
Optional
timeoutMs: numbermaximum amount of time to wait in milliseconds before the promise will be rejected. If no timeout is specified the method will wait forever.
Pause a sync session.
This method is asynchronous so in order to know when the session has started you will need to add a connection notification with addConnectionNotification.
This method is idempotent so it will be a no-op if the session is already paused or if multiplexing is enabled.
2.16.0-rc.2
Reconnects to Altas Device Sync.
This method is asynchronous so in order to know when the session has started you will need to add a connection notification with addConnectionNotification.
This method is idempotent so it will be a no-op if the session is already started.
12.2.0
Unregister a state notification callback that was previously registered with addStateNotification. Calling the function multiple times with the same callback is ignored.
A previously registered state callback.
2.15.0
Unregister a progress notification callback that was previously registered with addProgressNotification. Calling the function multiple times with the same callback is ignored.
A previously registered progress callback.
1.12.0
Resumes a sync session that has been paused.
This method is asynchronous so in order to know when the session has started you will need to add a connection notification with addConnectionNotification.
This method is idempotent so it will be a no-op if the session is already started or if multiplexing is enabled.
2.16.0-rc.2
This method returns a promise that does not resolve successfully until all known local changes have been uploaded to the server or the specified timeout is hit in which case it will be rejected. If the method times out, the upload will still continue in the background.
This method cannot be called before the Realm has been opened.
Optional
timeoutMs: numberMaximum amount of time to wait in milliseconds before the promise is rejected. If no timeout is specified the method will wait forever.
Generated using TypeDoc
Gets the Sync-part of the configuration that the corresponding Realm was constructed with.