Class Realtime

Hierarchy

Realtime

Index

Constructors

constructor

Methods

addConnectListener addHandshakeListener disconnect isDisconnected removeListener resubscribe subscribe unsubscribe

Constructors

constructor

new Realtime(client: IFetchClient, url?: string, handshakeCallback?: any): Realtime
Allows to set up a realtime (websocket or long-polling) connection to the platform.
Parameters
- client: IFetchClient
  
  The fetch client instance to use
- url: string = '/notification/realtime'
  
  The URL to connect to
- Optional handshakeCallback: any
  
  A function which is called on succeeded or failed handshake
Returns Realtime
- Defined in packages/client/src/realtime/Realtime.ts:31

Methods

addConnectListener

addConnectListener(callback: ((msg: Message) => void)): SubscriptionHandle
Allows to listen to Cometd connection to e.g. detect when connection was lost.
Parameters
- callback: ((msg: Message) => void)
  - - (msg: Message): void
    - Parameters
      
      msg: Message
      
      Returns void
Returns SubscriptionHandle
- Defined in packages/client/src/realtime/Realtime.ts:70

addHandshakeListener

addHandshakeListener(callback: ((msg: HandshakeMessage) => void)): SubscriptionHandle
Allows to listen to Cometd handshake to find out if e.g. the connection was reestablished.
Parameters
- callback: ((msg: HandshakeMessage) => void)
  - - (msg: HandshakeMessage): void
    - Parameters
      
      msg: HandshakeMessage
      
      Returns void
Returns SubscriptionHandle
- Defined in packages/client/src/realtime/Realtime.ts:63

disconnect

disconnect(disconnectCallback?: Listener): void
Disconnects the current connection.
Parameters
- disconnectCallback: Listener = undefined
Returns void
- Defined in packages/client/src/realtime/Realtime.ts:91

isDisconnected

isDisconnected(): boolean
Returns true if the CometD instance is disconnected or disconnecting.

Returns boolean
- Defined in packages/client/src/realtime/Realtime.ts:98

removeListener

removeListener(subscriptionHandle: SubscriptionHandle): void
Removes the subscription obtained with a call to addHandshakeListener or addConnectListener.
Parameters
- subscriptionHandle: SubscriptionHandle
Returns void
- Defined in packages/client/src/realtime/Realtime.ts:77

resubscribe

resubscribe(subscriptionHandle: SubscriptionHandle): SubscriptionHandle
Resubscribes as necessary in case of a re-handshake.
Parameters
- subscriptionHandle: SubscriptionHandle
Returns SubscriptionHandle
- Defined in packages/client/src/realtime/Realtime.ts:84

subscribe(channel: string, callback: Callback): SubscriptionHandle
Subscribes to a realtime channel to listen for data.
Parameters
- channel: string
  
  The channel to connect to
- callback: Callback
  
  A function to call when data is received
Returns SubscriptionHandle
- Defined in packages/client/src/realtime/Realtime.ts:47

unsubscribe

unsubscribe(subscription: SubscriptionHandle): void
Cancels the listening to a channel.
Parameters
- subscription: SubscriptionHandle
  
  The subscription object returned by subscribe()
Returns void
- Defined in packages/client/src/realtime/Realtime.ts:56

Class Realtime

Hierarchy

Index

Constructors

Methods

Constructors

constructor

Parameters

client: IFetchClient

url: string = '/notification/realtime'

Optional handshakeCallback: any

Returns Realtime

Methods

addConnectListener

Parameters

callback: ((msg: Message) => void)

Parameters

msg: Message

Returns void

Returns SubscriptionHandle

addHandshakeListener

Parameters

callback: ((msg: HandshakeMessage) => void)

Parameters

msg: HandshakeMessage

Returns void

Returns SubscriptionHandle

disconnect

Parameters

disconnectCallback: Listener = undefined

Returns void

isDisconnected

Returns boolean

removeListener

Parameters

subscriptionHandle: SubscriptionHandle

Returns void

resubscribe

Parameters

subscriptionHandle: SubscriptionHandle

Returns SubscriptionHandle

subscribe

Parameters

channel: string

callback: Callback

Returns SubscriptionHandle

unsubscribe

Parameters

subscription: SubscriptionHandle

Returns void

Settings

Member Visibility

Theme

`Optional` handshakeCallback: any