Interface AuthenticationHandler

Provides feedback to the developer about Ditto authentication status.

interface AuthenticationHandler {
    authenticationExpiringSoon: ((authenticator, secondsRemaining) => void);
    authenticationRequired: ((authenticator) => void);
    authenticationStatusDidChange?: ((authenticator) => void);
}

Index

Properties

authenticationExpiringSoon authenticationRequired authenticationStatusDidChange?

Properties

authenticationExpiringSoon

authenticationExpiringSoon: ((authenticator, secondsRemaining) => void)

Type declaration

- (authenticator, secondsRemaining): void
- Warns that the Ditto authentication token is getting old.
  
  Ditto will attempt to refresh tokens periodically, starting from halfway through the token's validity period. This reduces the risk of authentication expiring while the user is offline.
  
  The refresh will happen automatically if Ditto has a suitable refresh token. If new credentials are required, such as a third-party token or a username/password, then Ditto does not cache that information and you must submit it again using one of the login methods on Authenticator.
  Parameters
  - authenticator: Authenticator
  - secondsRemaining: number
  Returns void

authenticationRequired

authenticationRequired: ((authenticator) => void)

Type declaration

- (authenticator): void
- There is no Ditto authentication token or it has expired. Sync will not work until there is a successful login using one of the login methods on Authenticator.
  Parameters
  - authenticator: Authenticator
  Returns void

`Optional` authenticationStatusDidChange

authenticationStatusDidChange?: ((authenticator) => void)

Type declaration

- (authenticator): void
- Notifies the authentication handler that the authentication status did change. Use the authenticators property status to query for the current authentication status.
  
  This method is optional.
  Parameters
  - authenticator: Authenticator
  Returns void