Class DeviceInformationChange`Abstract`

The object that changes the device information.

The device information change can be used to

modify the name of the device and/or
modify its Firebase registration token or
disable push notifications.

If neither name or fcmRegistrationToken are provided, the provided onSuccess callback will be executed when execute is invoked.

Usage example for changing device information:

  [...]
  async updateDeviceInformation(
      client: MobileAuthenticationClient,
      newName: string,
      fcmToken: string
  ): Promise<void> {
      await client.operations.deviceInformationChange
          .name(newName)
          .fcmRegistrationToken(fcmToken)
          .onSuccess(() => {
              // handle success
          })
          .onError((_error) => {
              // handle error
          })
          .execute();
  }
  [...]

Hierarchy

HttpOperation<DeviceInformationChange>
- DeviceInformationChange

Index

Methods

name fcmRegistrationToken disablePushNotifications retryPolicy onSuccess onError requestHeaders execute

Methods

`Abstract` name

name(name): DeviceInformationChange
Specifies the new name of the device information.

This is typically a user-friendly string describing the mobile device where the application is running.

IMPORTANT
Do not invoke this method if the name does not need to be updated.
Parameters
- name: string
  
  the new device information name.
Returns DeviceInformationChange
a DeviceInformationChange object.

`Abstract` fcmRegistrationToken

fcmRegistrationToken(fcmRegistrationToken): DeviceInformationChange
Specifies the new Firebase Cloud Messaging registration token.

IMPORTANT
Do not invoke this method if the Firebase Cloud Messaging registration token does not need to be updated.
Parameters
- fcmRegistrationToken: string
  
  the new Firebase Cloud Messaging registration token.
Returns DeviceInformationChange
a DeviceInformationChange object.

`Abstract` disablePushNotifications

disablePushNotifications(): DeviceInformationChange
Disables the push notifications on the server side (i.e. the server will not send authentication push notifications).

To re-enable the sending of push notifications, execute a DeviceInformationChange and provide the Firebase Cloud Messaging registration token through the method fcmRegistrationToken.

Returns DeviceInformationChange
a DeviceInformationChange object.

`Abstract` retryPolicy

retryPolicy(retryPolicy): DeviceInformationChange
Specifies the retry policy to be used.

For some errors (such as networking errors) retrying is meaningful, this parameter specifies the retry policy to be followed if one of these errors occurs.

If no retry policy is provided NoRetryPolicy will be used.
Parameters
- retryPolicy: RetryPolicy
  
  the retry policy.
Returns DeviceInformationChange
a DeviceInformationChange object.

`Abstract` onSuccess

onSuccess(onSuccess): DeviceInformationChange
Specifies the object that will be invoked if the device information for the user was updated successfully.

IMPORTANT
Providing the onSuccess is required.
Parameters
- onSuccess: (() => void)
  
  the function which is invoked on successful update.
  - - (): void
    - Returns void
Returns DeviceInformationChange
a DeviceInformationChange object.

`Abstract` onError

onError(onError): DeviceInformationChange
Specifies the object that will be invoked if the dispatch device information change failed.

IMPORTANT
Providing the onError is required.
Parameters
- onError: ((error) => void)
  
  the function which receives a DeviceInformationChangeError.
  - - (error): void
    - Parameters
      
      error: DeviceInformationChangeError
      
      Returns void
Returns DeviceInformationChange
a DeviceInformationChange object.

`Abstract` requestHeaders

requestHeaders(requestHeaders): DeviceInformationChange
Specifies the additional request headers that must be included in the HTTP requests sent by the operation.
Parameters
- requestHeaders: RequestHeaders
  
  the HTTP headers.
Returns DeviceInformationChange
an HttpOperation object.

Inherited from HttpOperation.requestHeaders

`Abstract` execute

execute(): Promise<void>
Executes the operation asynchronously.

Returns Promise<void>

Inherited from HttpOperation.execute

Class DeviceInformationChangeAbstract

Hierarchy

Index

Methods

Methods

Abstract name

Parameters

name: string

Returns DeviceInformationChange

Abstract fcmRegistrationToken

Parameters

fcmRegistrationToken: string

Returns DeviceInformationChange

Abstract disablePushNotifications

Returns DeviceInformationChange

Abstract retryPolicy

Parameters

retryPolicy: RetryPolicy

Returns DeviceInformationChange

Abstract onSuccess

Parameters

onSuccess: (() => void)

Returns void

Returns DeviceInformationChange

Abstract onError

Parameters

onError: ((error) => void)

Parameters

error: DeviceInformationChangeError

Returns void

Returns DeviceInformationChange

Abstract requestHeaders

Parameters

requestHeaders: RequestHeaders

Returns DeviceInformationChange

Abstract execute

Returns Promise<void>

Settings

Member Visibility

Theme

On This Page

Class DeviceInformationChange`Abstract`

`Abstract` name

`Abstract` fcmRegistrationToken

`Abstract` disablePushNotifications

`Abstract` retryPolicy

`Abstract` onSuccess

`Abstract` onError

`Abstract` requestHeaders

`Abstract` execute